Skip to content

README.md

Latest commit

 

History

History
241 lines (187 loc) · 7.05 KB

README.md

File metadata and controls

241 lines (187 loc) · 7.05 KB

Trustless Work Skill

Agent Skills Compatible

Comprehensive Claude Code skill for integrating Trustless Work Escrow-as-a-Service (EaaS).

Overview

Trustless Work is an Escrow-as-a-Service platform built on Stellar (Soroban) for stablecoin escrow. This skill provides complete integration guidance for building non-custodial escrow flows with milestones, approvals, and disputes.

Platform Compatibility

This skill uses the open Agent Skills standard and works with:

  • ✅ Claude Code - Install via claude install <repo-url> or place in ~/.claude/skills/
  • ✅ OpenAI Codex CLI - Install via codex install <repo-url> or place in .agents/skills/
  • ✅ Google Gemini CLI - Install via gemini install skill <repo-url> or place in .agents/skills/
  • ✅ Cursor - Place in .cursor/skills/ directory
  • ✅ GitHub Copilot (VS Code) - Enable agent skills
  • ✅ Windsurf, Cline, Roo Code, and other compatible agents

Installation

Claude Code:

claude install https://github.com/wmendes/trustless-work-skill

OpenAI Codex CLI / Gemini CLI:

cd ~/.agents/skills
git clone https://github.com/wmendes/trustless-work-skill

Cursor:

cd .cursor/skills
git clone https://github.com/wmendes/trustless-work-skill

Skill Structure

.claude/skills/trustless-work/
├── SKILL.md                 # Main skill file with quick start
├── README.md                # This file
├── escrow-types.md          # Single vs Multi-Release comparison
├── roles-reference.md       # Complete role permissions guide
├── lifecycle-guide.md       # Detailed lifecycle phases
├── api-reference.md         # REST API documentation
├── examples.md              # Complete integration examples
└── stellar-guide.md         # Stellar network integration

What This Skill Covers

Core Concepts

  • Escrow Types: Single-Release vs Multi-Release
  • Roles System: 6 roles (Service Provider, Approver, Release Signer, Dispute Resolver, Receiver, Platform Address)
  • Escrow Lifecycle: Initiation → Funding → Milestone Updates → Approval → Release → (Dispute Resolution)
  • Stellar Integration: Trustlines, wallets, USDC on Stellar

Technical Integration

  • REST API: Complete endpoint reference
  • React SDK: Hooks and components
  • JavaScript/TypeScript Examples: Production-ready code
  • Wallet Integration: Freighter and others

Use Cases

  • Freelance/gig marketplaces
  • DAO grant programs
  • Security deposits (rentals, bookings)
  • Crowdfunding platforms
  • E-commerce escrow
  • B2B payment automation

Using This Skill

Invoke with Claude Code

# General help
/trustless-work

# Specific use case
/trustless-work create a freelance marketplace escrow

# With escrow type
/trustless-work single-release
/trustless-work multi-release

When Claude Uses This Skill

Claude will automatically use this skill when you:

  • Ask about implementing escrow flows
  • Mention marketplace payments, milestones, or disputes
  • Want to integrate stablecoin payments with approval logic
  • Need non-custodial payment infrastructure
  • Ask about Trustless Work specifically

Quick Reference

Key Resources

USDC on Stellar

Issuer: GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5

Fees

  • Protocol Fee: 0.3% (automatic)
  • Platform Fee: Configurable (you set it)

Networks

Supporting Files

1. escrow-types.md

Complete comparison of Single-Release vs Multi-Release escrows:

  • Structure differences
  • Use case recommendations
  • JSON examples
  • Decision guide

2. roles-reference.md

Full role permissions and interaction patterns:

  • What each role can do
  • Common role assignment patterns
  • Multi-role addresses
  • Security considerations

3. lifecycle-guide.md

Step-by-step guide through all lifecycle phases:

  • Initiation (define schema)
  • Funding (lock assets)
  • Milestone Updates (mark progress)
  • Approval (validate work)
  • Release (execute payout)
  • Dispute Resolution (handle conflicts)

4. api-reference.md

Complete REST API documentation:

  • All endpoints with examples
  • Authentication
  • Request/response formats
  • Error codes
  • Rate limits
  • SDK usage

5. examples.md

Production-ready code examples:

  • Freelance marketplace
  • DAO grant program
  • Security deposit (rental)
  • Crowdfunding platform
  • E-commerce escrow
  • React components

6. stellar-guide.md

Stellar network integration guide:

  • Why Stellar for escrow
  • Trustline management
  • Wallet integration (Freighter)
  • Sending USDC
  • Testing on Testnet
  • Security best practices

Example Queries

Creating escrows:

  • "How do I create a single-release escrow for a freelance job?"
  • "Help me build a multi-release escrow for a grant program"
  • "What's the difference between single and multi-release?"

Understanding roles:

  • "What can each role do in an escrow?"
  • "How should I assign roles for a marketplace?"
  • "Can one address have multiple roles?"

Lifecycle management:

  • "Walk me through the complete escrow lifecycle"
  • "How does milestone approval work?"
  • "What happens during dispute resolution?"

API integration:

  • "Show me how to fund an escrow with the API"
  • "How do I update milestone status?"
  • "Give me a complete freelance escrow example"

Stellar/USDC:

  • "How do trustlines work on Stellar?"
  • "How do I set up USDC for my users?"
  • "What wallets work with Trustless Work?"

Testing

Always test on Testnet first:

  1. Create testnet account via https://friendbot.stellar.org
  2. Add USDC trustline
  3. Get testnet USDC
  4. Create test escrow on dev.api.trustlesswork.com
  5. Walk through full lifecycle
  6. Verify on https://viewer.trustlesswork.com

Security Notes

  • All role addresses must have the trustline enabled
  • Never commit private keys to Git
  • Use hardware wallets for platform accounts
  • Test with small amounts on Mainnet first
  • Set up multi-signature for critical roles

License & Attribution

This skill is based on the official Trustless Work documentation.

For the most up-to-date information, always refer to:

Support

For Trustless Work support:

Updates

This skill was created on 2026-03-11 based on Trustless Work documentation version English.

Check the original PDF for the latest updates and features.