🚀Developer Quickstart

This guide is your all-in-one resource to integrate, deploy, and extend Trustless Work. Whether you’re a developer, a product team, or seeding an AI agent — this page gives you everything.

Hello! This page is optimized to be exported and loaded to your AI Agent of choice! you can also use ours in the Search Bar!

🚀 What Is Trustless Work?

Trustless Work is an Escrow-as-a-Service (EaaS) platform designed for the stablecoin economy. It lets you securely hold funds in non-custodial smart contracts until milestones are completed and approved.

Use it to:

Lock funds with programmable milestone logic
Enable transparent fund releases for services, grants, rentals, etc.
Automate fund flows using signer-based roles

🧪 Quickstart — Deploy Your First Escrow

▶ Try the Demo — No code required

Pre-requisites

Freighter wallet
Testnet USDC + XLM (Get test tokens)

Step-by-Step

Open the demo app
Fill in escrow details (roles, milestones)
Click deploy → sign the transaction
Send testmet USDC to the escrow contract address
Mark, approve, and release milestones from the UI

✍️ 2. Design Your Escrow Lifecycle

Before deploying, define:

Who can mark milestones as done
Who must approve work
Who can release funds
Who can resolve disputes

→ Escrow Roles & Permissions

📬 API Overview

Get your API key in our dApp: Request API Key

The Trustless Work API is your gateway to deploy and manage decentralized smart escrows on the Stellar blockchain using Soroban smart contracts. All interactions return unsigned XDRs, which must be signed client-side using the wallet associated with the correct role.

📘 Base URL: https://api.trustlesswork.com

🔨 Deployment

Method

Endpoint

Description

POST

/deployer/single-release

Deploys a single-release escrow

POST

/deployer/multi-release

Deploys a multi-release escrow

💸 Funding

Method

Endpoint

Description

POST

/escrow/{type}/fund-escrow

Returns XDR to fund an escrow

✅ Milestone Handling

Method

Endpoint

Description

POST

/escrow/{type}/approve-milestone

Approve a milestone

POST

/escrow/{type}/change-milestone-status

Mark a milestone as complete/incomplete

🏁 Finalization

Method

Endpoint

Description

POST

/escrow/{type}/release-funds

Release all funds (single)

POST

/escrow/{type}/release-milestone-funds

Release one milestone (multi)

⚠️ Disputes

Method

Endpoint

Description

POST

/escrow/{type}/dispute-escrow

Raise a dispute on a single escrow

POST

/escrow/{type}/resolve-dispute

Resolve a single-release escrow dispute

POST

/escrow/{type}/dispute-milestone

Raise dispute on a milestone

POST

/escrow/{type}/resolve-milestone-dispute

Resolve milestone dispute (multi)

🔄 Escrow Updates

Method

Endpoint

Description

POST

/escrow/{type}/update-escrow

Update escrow metadata/config

📊 Query & Tracking

Method

Endpoint

Description

GET

/escrow/get-multiple-escrow-balance

Batch balances for many escrows

GET

/helper/get-escrows-by-signer

Query escrows associated with a signer

GET

/helper/get-escrows-by-role

Query escrows by role assignment

🧰 Helper Utilities

Method

Endpoint

Description

POST

/helper/set-trustline

Enable escrow wallet to accept a token

POST

/helper/send-transaction

Submit signed XDR to Stellar

📌 For full Swagger documentation, visit: https://dev.api.trustlesswork.com/docs
All write actions must be signed by the wallet that holds the corresponding escrow role (marker, approver, releaser, resolver).

🧠 React SDK Integration

NPM: @trustless-work/escrow

npm i @trustless-work/escrow

Provider Setup

import {
  TrustlessWorkConfig,
  development, // or mainNet
} from "@trustless-work/escrow";

export function TrustlessWorkProvider({ children }) {
  const apiKey = process.env.NEXT_PUBLIC_API_KEY || "";
  return (
    <TrustlessWorkConfig baseURL={development} apiKey={apiKey}>
      {children}
    </TrustlessWorkConfig>
  );
}

Wrap your app:

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        <TrustlessWorkProvider>
          {children}
        </TrustlessWorkProvider>
      </body>
    </html>
  );
}

Once wrapped, you can use the SDK's escrow hooks and mutation functions across your app.

🔑 Wallets & Passkeys

Every role (marker, approver, releaser, etc.) needs a Stellar-Soroban compatible wallet.

Supported wallets:

Freighter
Passkey Wallets (biometric, contract-based)

🔁 Escrow Lifecycle Explained

Initiation – Define roles, asset, and milestones
Funding – Deposit stablecoins (USDC) into the contract
Milestone Marked – Provider marks progress
Approval – Client or approver signs off
Release – Funds are released
Dispute – Optional: Resolver steps in

Each action requires a signature from the assigned wallet address.

🧩 Roles & Permissions

Role

Description

Marker

Marks milestones as completed

Approver

Approves milestone completion

Releaser

Signs off final release of funds

Resolver

Can override flow in case of dispute

Receiver

Gets the released funds

Platform Address

Receives a fee (optional, % of each release)

📐 Escrow Schema Reference (for agents & devs)

Shared Fields

Key

Type

Description

engagementId

string

Unique identifier for the escrow

title

string

Name of the escrow

description

string

Description of the escrow's function

roles

object

Role assignments: marker, approver, etc.

platformFee

number

% fee for the platform

trustline

object

Token type (e.g., USDC, XLM) and decimals

Milestone Object (for multi-release only)

Field

Type

Description

description

string

What the milestone represents

status

string

Status: approved, in_dispute, etc.

amount

number

Amount released upon approval

evidence

string

(Optional) Supporting proof

flags

object

Includes disputed, resolved, approved

Trustline Object

Field

Type

Description

address

string

Token issuer or address

🛠 Developer Tools & Links

🔗 API Docs
🧪 Demo dApp
Github https://github.com/Trustless-Work
📦 React SDK (NPM)
📖 Wallet Setup Guide

🤝 Join the Ecosystem

🧵 Twitter/X: @trustlesswork
🌐 Docs Hub: docs.trustlesswork.com

Built for the stablecoin economy. Open-source. Developer-first.

Let us know what you’re building!

PreviousTrustless Work API NextIntroduction

Last updated 2 months ago

Was this helpful?

hashtag🚀 What Is Trustless Work?

hashtag🧪 Quickstart — Deploy Your First Escrow

hashtagPre-requisites

hashtagStep-by-Step

hashtag✍️ 2. Design Your Escrow Lifecycle

hashtag📬 API Overview

hashtag🔨 Deployment

hashtag💸 Funding

hashtag✅ Milestone Handling

hashtag🏁 Finalization

hashtag⚠️ Disputes

hashtag🔄 Escrow Updates

hashtag📊 Query & Tracking

hashtag🧰 Helper Utilities

hashtag🧠 React SDK Integration

hashtagProvider Setup

hashtagWrap your app:

hashtag🔑 Wallets & Passkeys

hashtag🔁 Escrow Lifecycle Explained

hashtag🧩 Roles & Permissions

hashtag📐 Escrow Schema Reference (for agents & devs)

hashtagShared Fields

hashtagMilestone Object (for multi-release only)

hashtagTrustline Object

hashtag🛠 Developer Tools & Links

hashtag🤝 Join the Ecosystem

🚀 What Is Trustless Work?

🧪 Quickstart — Deploy Your First Escrow

Pre-requisites

Step-by-Step

✍️ 2. Design Your Escrow Lifecycle

📬 API Overview

🔨 Deployment

💸 Funding

✅ Milestone Handling

🏁 Finalization

⚠️ Disputes

🔄 Escrow Updates

📊 Query & Tracking

🧰 Helper Utilities

🧠 React SDK Integration

Provider Setup

Wrap your app:

🔑 Wallets & Passkeys

🔁 Escrow Lifecycle Explained

🧩 Roles & Permissions

📐 Escrow Schema Reference (for agents & devs)

Shared Fields

Milestone Object (for multi-release only)

Trustline Object

🛠 Developer Tools & Links

🤝 Join the Ecosystem