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

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

¿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;
}

Last updated

Was this helpful?