Deploy

Deploy the escrow contract and define the escrow properties.

Headers

Name	Value
Content-Type	application/json
x-api-key	<token>

Milestone

Name	Type	Description
description	string	Text describing the function of the milestone
status	string (Default value: "peding")	Milestone status. Ex: Approved, In dispute, etc...
approved	boolean (Default value: false)	Flag indicating whether a milestone has been approved by the approver
amount	string	Amount of the milestone
receiver	string	Address where escrow proceeds will be sent to

Roles:

Name	Type	Description
approver	string	Address of the entity requiring the service.
serviceProvider	string	Address of the entity providing the service.
plataformAddress	string	Address of the entity that owns the escrow
releaseSigner	string	Address of the user in charge of releasing the escrow funds to the service provider.
disputeResolver	string	Address in charge of resolving disputes within the escrow.

Trustline:

Name	Type	Description
address	string	Public address establishing permission to accept and use a specific token.
symbol	string	Official abbreviation representing the token in wallets, exchanges, and documentation.

Initialize Escrow

post

Authorizations

x-api-key

Body

application/json

signerstringRequired

Entity that signs the transaction that deploys and initializes the escrow

Example: GABC...XYZ

engagementIdstringRequired

Unique identifier for the escrow

Example: ENG12345

titlestringRequired

Name of the escrow

Example: Escrow Test

descriptionstringRequired

Text describing the function of the escrow

Example: Escrow Test description

rolesobject[]Required

Roles that make up the escrow structure

platformFeenumberRequired

Commission that the platform will receive when the escrow is completed

Example: 5

milestonesobject[]Required

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[]Required

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

Responses

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

HTTPcURLJavaScriptPython

POST /deployer/multi-release HTTP/1.1
Host: 
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...."
}

What this Endpoint returns?

This endpoint returns the transaction unsigned so that the transaction can be signed by means of a customer wallet.

Use Example:

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 () => {
    // Get the signer address
    const { address } = await kit.getAddress();

    // Execute the endpoint
    const response = await http.post(
      "/deployer/multi-release",
      {
        // 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,
    });

    const { data } = tx;

    return data; 
}