Desplegar

Despliega el contrato de escrow y define las propiedades del escrow.

Encabezados

Nombre	Valor
Content-Type	application/json
x-api-key	<token>

Hito

Nombre	Tipo	Descripción
descripción	cadena	Texto que describe la función del hito
estado	cadena (Valor predeterminado: "peding")	Estado del hito. Ej: Aprobado, En disputa, etc...
aprobado	booleano (Valor predeterminado: false)	Indicador que señala si un hito ha sido aprobado por el aprobador
monto	cadena	Cantidad del hito
receptor	cadena	Dirección donde se enviarán los fondos del escrow

Roles:

Nombre	Tipo	Descripción
aprobador	cadena	Dirección de la entidad que solicita el servicio.
proveedorDeServicios	cadena	Dirección de la entidad que brinda el servicio.
direccionPlataforma	cadena	Dirección de la entidad que posee el escrow
firmanteDeLiberacion	cadena	Dirección del usuario encargado de liberar los fondos del escrow al proveedor del servicio.
resolutorDeDisputas	cadena	Dirección encargada de resolver disputas dentro del escrow.

Línea de confianza:

Nombre	Tipo	Descripción
dirección	cadena	Dirección pública que establece permiso para aceptar y usar un token específico.
símbolo	cadena	Abreviatura oficial que representa el token en billeteras, exchanges y documentación.

Inicializar Escrow

post

Autorizaciones

x-api-key

Cuerpo

application/json

signerstringRequerido

Entity that signs the transaction that deploys and initializes the escrow

Example: GABC...XYZ

engagementIdstringRequerido

Unique identifier for the escrow

Example: ENG12345

titlestringRequerido

Name of the escrow

Example: Escrow Test

descriptionstringRequerido

Text describing the function of the escrow

Example: Escrow Test description

rolesobject[]Requerido

Roles that make up the escrow structure

platformFeenumberRequerido

Commission that the platform will receive when the escrow is completed

Example: 5

milestonesobject[]Requerido

Objectives to be completed to define the escrow as completed. (In this case it is not necessary to send the properties “approvedFlag” and “status” inside the objects of these milestones)

trustlineobject[]Requerido

Information on the trustline that will manage the movement of funds in escrow

Respuestas

201

This endpoint returns an unsigned transaction in XDR format. This XDR is then used to sign the transaction using the “/helper/send-transaction” endpoint.

application/json

400

Bad request

401

Unauthorized access

429

Too Many Requests

500

Possible errors:

• Escrow already initialized
• The platform fee cannot exceed 99%
• Escrow initialized without milestone
• Cannot define more than 50 milestones in an escrow
• Amount cannot be zero
• All flags (approved, disputed, released) must be false in order to execute this function
• An unexpected error occurred

application/json

post

/deployer/multi-release

HTTPcURLJavaScriptPython

POST /deployer/multi-release HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 648

{
  "signer": "GAPPROVER1234567890...",
  "engagementId": "ENG12345",
  "title": "Project Title",
  "description": "This is a detailed description of the project.",
  "roles": {
    "approver": "GAPPROVER1234567890...",
    "serviceProvider": "GAPPROVER1234567890...",
    "platformAddress": "GAPPROVER1234567890...",
    "releaseSigner": "GAPPROVER1234567890...",
    "disputeResolver": "GAPPROVER1234567890..."
  },
  "platformFee": 50,
  "milestones": [
    {
      "description": "Initial phase of the project",
      "amount": 5,
      "receiver": "GAPPROVER1234567890..."
    },
    {
      "description": "Completion of design work",
      "amount": 5,
      "receiver": "GAPPROVER1234567890..."
    }
  ],
  "trustline": {
    "symbol": "USDC",
    "address": "GBBD47IF6LWK7P7MDEVSC..."
  }
}

{
  "status": "SUCCESS",
  "unsignedTransaction": "AAAAAgAAAAAtWsgedQ...."
}

¿Qué devuelve este Endpoint?

Este endpoint devuelve la transacción sin firmar para que la transacción pueda ser firmada mediante la billetera del cliente.

Ejemplo de uso:

import axios from "axios";

const http = axios.create({
  baseURL: "https://dev.api.trustlesswork.com",
  timeout: 10000,
  headers: {
    "Content-Type": "application/json",
    "x-api-key": your_api_key,
  },
});

export const useExample = async () => {
    // Obtener la dirección del firmante
    const { address } = await kit.getAddress();

    // Ejecutar el endpoint
    const response = await http.post(
      "/deployer/multi-release",
      {
        // cuerpo requerido para el endpoint
      },
    );
    
    // Obtener el hash de la transacción sin firmar
    const { unsignedTransaction } = response.data;

    // Firmar la transacción con la billetera
    const { signedTxXdr } = await signTransaction(unsignedTransaction, {
      address,
      networkPassphrase: WalletNetwork.TESTNET,
    });

    // Enviar la transacción a la Red Stellar
    const tx = await http.post("/helper/send-transaction", {
      signedXdr: signedTxXdr,
    });

    const { data } = tx;

    return data; 
}