Update escrow properties

This endpoint allows you to change the properties of an escrow as long as a series of requirements are met, which will be mentioned in this section.

Requirements to use:

1. Only the entity with the platform role has permissions to execute this endpoint

2. You cannot change the properties of an escrow which already has an approved milestone

3. You cannot change the properties of an escrow which already has funds

4. You cannot change the properties of an escrow which is in dispute.

Headers

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

Open API

put

Body

signerstringRequired

Entity that signs the transaction that deploys and initializes the escrow

Example: GSIGN...XYZ

contractIdstringRequired

ID (address) that identifies the escrow contract

Example: CAZ6UQX7...

escrowall ofRequired

Escrow data to update

Responses

200

This endpoint returns an unsigned transaction in XDR format. This XDR is then used to sign the transaction using the “/helper/send-transaction” endpoint.

400

Bad request

401

Unauthorized access

429

Too Many Requests

500

Possible errors:

• { status: "FAILED", message: "Escrow not found" }
• { status: "FAILED", message: "Only the platform address should be able to execute this function" }
• { status: "FAILED", message: "You can't change the escrow properties after the milestone is approved" }
• { status: "FAILED", message: "Escrow has funds" }
• { status: "FAILED", message: "Escrow has been opened for dispute resolution" }
• { status: "500", message: "An unexpected error occurred" }

put

HTTPcURLJavaScriptPython

PUT /escrow/update-escrow-by-contract-id HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 748

{
  "signer": "GAPPROVER1234567890...",
  "contractId": "CAZ6UQX7...",
  "escrow": {
    "signer": "GAPPROVER1234567890...",
    "engagementId": "ENG12345",
    "title": "Project Title",
    "description": "This is a detailed description of the project.",
    "approver": "GAPPROVER1234567890...",
    "serviceProvider": "GAPPROVER1234567890...",
    "platformAddress": "GAPPROVER1234567890...",
    "amount": "1000",
    "platformFee": "50",
    "milestones": [
      {
        "description": "test1",
        "status": "pending"
      },
      {
        "description": "test2",
        "status": "pending"
      }
    ],
    "disputeFlag": false,
    "releaseFlag": true,
    "resolvedFlag": false,
    "releaseSigner": "GAPPROVER1234567890...",
    "disputeResolver": "GAPPROVER1234567890...",
    "receiver": "GAPPROVER1234567890...",
    "receiverMemo": 456789,
    "trustline": "GAPPROVER1234567890...",
    "trustlineDecimals": 6233233223
  }
}

No content

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",
    Authorization: `Bearer your_api_key`,
  },
});

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

    const response = await http.put(
      "/escrow/update-escrow-by-contract-id",
      {
        // 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;
}