Liberar Fundos do Marco

Você libera os fundos do escrow do marco para o prestador de serviços através do aprovador.

Cabeçalhos

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

Open API

post

Autorizações

x-api-key

Corpo

application/json

contractIdstringObrigatório

ID (address) that identifies the escrow contract

Example: CAZ6UQX7...

releaseSignerstringObrigatório

Address of the user in charge of releasing the escrow funds to the receiver

Example: GAPPROVER1234567890...

milestoneIndexstringObrigatório

Position that identifies the milestone within the group of milestones in the escrow

Example: 1

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:

• This milestone is already released
• This escrow is already resolved
• Only the release signer can release the escrow funds
• Escrow initialized without milestone
• The milestone must be completed to release funds
• Milestone has been opened for dispute resolution
• Invalid milestone index
• The escrow balance must be equal to the amount of earnings defined for the escrow
• Escrow not found
• An unexpected error occurred

application/json

post

/escrow/multi-release/release-milestone-funds

HTTPcURLJavaScriptPython

POST /escrow/multi-release/release-milestone-funds HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 91

{
  "contractId": "CAZ6UQX7...",
  "releaseSigner": "GAPPPROVER1234567890...",
  "milestoneIndex": "1"
}

{
  "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": sua_chave_api,
  },
});

export const useExample = async () => {
    // Obter o endereço do assinante
    const { address } = await kit.getAddress();

    const response = await http.post(
      "/escrow/multi-release/liberar-fundos-do-marco"
      {
        // corpo solicitado 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;
}