Skip to content
This repository was archived by the owner on May 23, 2026. It is now read-only.

Trustless-Work/Trustless-Work-Skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

skills.sh License: MIT

The Trustless Work escrow skill for AI coding agents.

Trustless Work is an Escrow-as-a-Service (EaaS) platform built on Stellar (Soroban) for non-custodial stablecoin escrow with milestones, approvals, and dispute resolution.

Installation

npx skills add trustless-work/trustless-work-dev-skill

The skills CLI automatically detects your agent and installs the skill in the right location.

Usage with Claude Code

After installation, restart Claude Code and invoke the skill:

/trustless-work
/trustless-work create a freelance marketplace escrow
/trustless-work single-release with React SDK
/trustless-work multi-release DAO grant
/trustless-work set up Blocks SDK

Claude will also use this skill automatically when you ask about escrow flows, milestone payments, Trustless Work, or stablecoin integrations on Stellar.

What the skill covers

  • Three integration paths — REST API, React SDK (@trustless-work/escrow), Blocks SDK (@trustless-work/blocks)
  • XDR signing flow — the critical build → sign → submit pattern that every write operation follows
  • Escrow types — Single-Release vs Multi-Release: schemas, use cases, and decision guide
  • Roles system — Service Provider, Approver, Release Signer, Dispute Resolver, Receiver, Platform Address with full permissions matrix
  • Complete lifecycle — Deploy → Fund → Milestone Updates → Approval → Release → Dispute Resolution
  • REST API reference — all endpoints with correct paths, request bodies, and error codes
  • React SDK hooksuseInitializeEscrow, useFundEscrow, useChangeMilestoneStatus, useApproveMilestone, useReleaseFunds, useStartDispute, useResolveDispute, useSendTransaction, and more
  • Blocks SDK — CLI-based pre-built UI components, provider setup, and available blocks
  • Stellar integration — trustlines, USDC addresses, Freighter wallet, network passphrases

How the API works

Every write operation follows a 3-step pattern:

1. POST to any write endpoint  →  { unsignedTransaction: "XDR..." }
2. Sign the XDR with the role wallet (Freighter, etc.)
3. POST /helper/send-transaction { signedXdr }  →  final result

Authentication uses x-api-key header (not Authorization: Bearer).

Quick reference

Testnet API https://dev.api.trustlesswork.com
Mainnet API https://api.trustlesswork.com
Auth header x-api-key: YOUR_API_KEY
Rate limit 50 requests / 60 seconds
USDC issuer (testnet) GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5
USDC issuer (mainnet) GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN
Protocol fee 0.3% (automatic, deducted at release)
Platform fee Configurable via platformFee field
Trustline field symbol (not code)
React SDK package @trustless-work/escrow
Blocks SDK package @trustless-work/blocks

Key endpoint groups

Group Endpoints
Deploy POST /deployer/single-release, POST /deployer/multi-release
Single-release ops POST /escrow/single-release/{action}
Multi-release ops POST /escrow/multi-release/{action}
Submit transaction POST /helper/send-transaction
Query (read-only) GET /helper/get-escrows-by-signer, get-escrows-by-role, get-escrow-by-contract-ids

Links

License

MIT

About

NPM code that installs the skill for AI agents that assist in the implementation of Trustless Work or verify whether any Trustless Work products are being implemented correctly.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors