Implantar

Implante o contrato de escrow e defina as propriedades do escrow.

Cabeçalhos

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

Marco

Nome	Tipo	Descrição
descrição	string	Texto descrevendo a função do marco
status	string (Valor padrão: "peding")	Status do marco. Ex: Aprovado, Em disputa, etc...
aprovado	booleano (Valor padrão: false)	Flag indicando se um marco foi aprovado pelo aprovador
quantia	string	Valor do marco
destinatário	string	Endereço para onde os recursos do escrow serão enviados

Papéis:

Nome	Tipo	Descrição
aprovador	string	Endereço da entidade que requer o serviço.
prestadorDeServiço	string	Endereço da entidade que fornece o serviço.
endereçoDaPlataforma	string	Endereço da entidade que possui o escrow
assinanteDeLiberação	string	Endereço do usuário responsável por liberar os fundos do escrow ao prestador de serviço.
resolvedorDeDisputas	string	Endereço responsável por resolver disputas dentro do escrow.

Trustline:

Nome	Tipo	Descrição
endereço	string	Endereço público que estabelece permissão para aceitar e usar um token específico.
símbolo	string	Abreviação oficial que representa o token em carteiras, exchanges e documentação.

Inicializar Escrow

post

Autorizações

Corpo

signerstringObrigatório

Entity that signs the transaction that deploys and initializes the escrow

Example: GABC...XYZ

engagementIdstringObrigatório

Unique identifier for the escrow

Example: ENG12345

titlestringObrigatório

Name of the escrow

Example: Escrow Test

descriptionstringObrigatório

Text describing the function of the escrow

Example: Escrow Test description

rolesobject[]Obrigatório

Roles that make up the escrow structure

platformFeenumberObrigatório

Commission that the platform will receive when the escrow is completed

Example: 5

milestonesobject[]Obrigatório

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[]Obrigatório

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

Respostas

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

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...."
}

O que este endpoint retorna?

Este endpoint retorna a transação não assinada para que a transação possa ser assinada por meio da carteira do cliente.

Exemplo 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 () => {
    // Obter o endereço do assinante
    const { address } = await kit.getAddress();

    // Executar o endpoint
    const response = await http.post(
      "/deployer/multi-release",
      {
        // corpo requisitado para o endpoint
      },
    );
    
    // Obter o hash da transação não assinada
    const { unsignedTransaction } = response.data;

    // Assinar a transação pela carteira
    const { signedTxXdr } = await signTransaction(unsignedTransaction, {
      address,
      networkPassphrase: WalletNetwork.TESTNET,
    });

    // Enviar a transação para a Rede Stellar
    const tx = await http.post("/helper/send-transaction", {
      signedXdr: signedTxXdr,
    });

    const { data } = tx;

    return data; 
}