🎉 Welcome to Trustless Work — the escrow infrastructure for the new economy.
In this guide, you’ll learn how to deploy your first smart escrow on Stellar testnet using our live demo app. No SDKs or APIs required.
🧰 What You’ll Need
- A Stellar testnet wallet with testnet XLM(we recommend Freighter)
- About 5 minutes and a project idea
🚀 Step 1: Open the Demo App
Visit: demo.trustlesswork.com
This is our official reference integration — always up-to-date with our latest NPM library.
Click Connect Wallet and approve the connection using your Stellar wallet.
📝 Step 2: Fill in the Escrow Details
Once connected, you’ll be guided through a few simple sections:
✏️ 1. Engagement Metadata
- Title — What’s this escrow for?
- Engagement ID — A unique reference (optional)
- Description — What work or value is being exchanged?
💰 2. Financial Setup
- Amount — How much XLM will be held in escrow?
- Platform fee — configurable fee that the integrating platform will receive
- Trustline — identifies the token to be used (USDC, EURC)
- Receiver Memo — optional for when the receiver is a custodial address
🎭 3. Roles Configuration
Assign addresses to the roles in the escrow:
- Service Provider — Provides the service, Marks work as done
- Approver — Approves the milestone
- Release signer — Asigns the release of funds
- Platform Address — Receives platform fee, can update escrow details.
- Receiver — Gets paid after approval
- Dispute Resolver — If a dispute is raised, this party resolves it.
👉 Learn more about roles in our Docs
📋 4. Milestones
Break the work into one or more milestones. Each one has:
- A label/title
- Description
✅ Step 3: Deploy and Interact
Click Deploy Escrow and confirm the transaction in your wallet.
You’ll now see your escrow live on testnet! From here, you can:
- 🛠️ Mark milestones as done
- 🧾 Approve milestones
- 💸 Release funds
You can also inspect helper endpoints and responses to understand how the contract works behind the scenes — great for devs!
🔧 Bonus Tools
Want a more complex UI for managing escrows?
Check out our Backoffice dApp: dapp.trustlesswork.com
It’s designed for platforms and operations teams managing multiple escrows.
Interested in integrating us?
- Use the NPM package
- Check the API docs
- Explore our open-source repos
🚀 What’s Next?
- Explore how roles and configurations affect fund release
- Try milestone flows with friends or teammates
- Head to our Docs to dive deeper
- Reach out to join our builder ecosystem or apply for mainnet access
Need help?
Join our Discord, or reach us on X
Let’s build with trust.
Pura Vida.