Send Transaction

Most Trustless Work endpoints return an unsigned transaction in XDR format. This endpoint is used to sign such unsigned transactions and send them to the Stellar network.

POST helper/send-transaction

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
signedXdr	string	The sign's hash. This come from the wallet.
returnEscrowDataIsRequired (Optional)	boolean	If a return escrow data is needed (Note that not all contract functions return data from an escrow.).

Example of Request Body:

{
  "signedXdr": "AAAAAgAAAAB...",
  "returnValueIsRequired": true,
}

Possible Responses

200 OK

{
    "status": "SUCCESS",
    "message": "The transaction has been successfully sent to the Stellar network"
}

500 Server Error

{
    "status": "FAILED",
    "message": "The transaction could not be sent to the Stellar network for some unknown reason. Please try again."
}

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

Example of how to use this endpoint:

import { FundEscrowPayload } from "@/@types/escrow.entity";
import { kit } from "@/components/modules/auth/wallet/constants/wallet-kit.constant";
import { WalletNetwork } from "@creit.tech/stellar-wallets-kit";
import { signTransaction } from "@stellar/freighter-api";
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 fundEscrow = async () => {
  try {
    const response = await http.post(
      "/escrow/fund-escrow", 
      {
       // body requested for the endpoint
      }    
    );

    const { unsignedTransaction } = response.data;
    const { address } = await kit.getAddress();
    const { signedTxXdr } = await signTransaction(unsignedTransaction, {
      address,
      networkPassphrase: WalletNetwork.TESTNET,
    });

    const tx = await http.post("/helper/send-transaction", {
      signedXdr: signedTxXdr,
    });

    const { data } = tx;
    return data;
  } catch (error: unknown) {
    if (axios.isAxiosError(error)) {
      console.error("Axios Error:", error.response?.data || error.message);
      throw new Error(
        error.response?.data?.message || "Error in Axios request",
      );
    } else {
      console.error("Unexpected Error:", error);
      throw new Error("Unexpected error occurred");
    }
  }
};