Financiar Escrow

Permite a los usuarios depositar fondos en un contrato de escrow (custodia) existente, asegurándolos hasta que se cumplan las condiciones acordadas.

Permite transferir montos flexibles de USDC al contrato de escrow.

POST escrow/fund-escrow

Encabezados

Nombre	Valor
Content-Type	application/json
Authorization	Bearer <token>

Cuerpo

Nombre	Tipo	Descripción
contractId	string	ID (dirección) que identifica el contrato del escrow.
signer	string	Dirección del usuario que firma la transacción del contrato.
amount	string	Cantidad a transferir al contrato del escrow.

Dejemplo de un cuerpo de solicitud (Request Body):

{
	"contractId": "GC3DJY4LLQYJHEONXFDLQVVRCFZQCPFX7VD33KP4P7QSVZY3SJHQBZGV",
	"signer": "GBY3PAJY5R3ZIXTYBGFW4URB4RINEXQBC3T4RWDDKJ5TZXQYZUN6A4TP", 
	"amount": "500.00"
}

Respuestas posibles

201 Success

{
    "status": "SUCCESS",
    "unsignedTransaction": "AAAAAgAAAABfQAm/gS..."  // XDR Hash Transaction
}

500 Server Error

Escrow in dispute

{
  "status": "FAILED"
  "messgae": "Escrow has been opened for dispute resolution"
}

Fully Funded

{
  "status": "FAILED"
  "message": "This escrow is already fully funded"
}

Amount to deposit is greater than escrow amount

{
  "status": "FAILED"
  "message": "Amount to deposit is greater than the escrow amount"
}

Insufficient Founds

{
  "status": "FAILED"
  "message": "The signer does not have sufficient funds"
}

Not Found

{
  "status": "FAILED"
  "message": "Escrow not found"
}

400 Bad Request

{
    "message": "Message",
    "error": "Bad Request",
    "statusCode": 400
}

401 Unauthorized

{
  "statusCode": 401,
  "message": "Unauthorized",
  "error": "Unauthorized"
}

429 Rate Limit

{
    "statusCode": 429,
    "message": "ThrottlerException: Too Many Requests"
}

¿Qué retorna este endpoint?

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

Ejemplo de uso (usando axios):

import axios from "axios";

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

export const useExample = async () => {
    // Get the signer address
    const { address } = await kit.getAddress();

    const response = await http.post(
      "/escrow/fund-escrow",
      {
        // body requested for the endpoint
      },
    ); 
    
    // Get the unsigned transaction hash
    const { unsignedTransaction } = response.data;

    // Sign the transaction by wallet
    const { signedTxXdr } = await signTransaction(unsignedTransaction, {
      address,
      networkPassphrase: WalletNetwork.TESTNET,
    });

    // Send the transaction to Stellar Network
    const tx = await http.post("/helper/send-transaction", {
      signedXdr: signedTxXdr,
      returnValueIsRequired: true,
    });

    const { data } = tx;

    return data;
}