Welcome to Trustless Work Documentation!

Trustless Work is an Escrow-as-a-Service platform designed to secure transactions with transparency, efficiency, and scalability. Whether you’re a developer looking to integrate blockchain-powered escrows, a platform aiming to build user trust, or an innovator seeking new financial solutions, you’re in the right place.

How to Navigate This Documentation

We’ve organized everything you need into clear sections tailored to your role:

Welcome to the story of Trustless Work—a journey fueled by innovation, collaboration, and a vision to redefine how escrows operate in the modern economy.

Our journey began with a problem: the inefficiencies and risks of traditional payment systems. From there, a passionate team came together to develop a groundbreaking solution that has already reached significant milestones and is poised to transform industries worldwide.

Discover Our Story

Our journey is divided into key chapters, each showcasing a crucial part of our evolution:

Start Exploring

Ready to dive deeper? Use the navigation below to follow our journey step by step or jump directly to the chapter that interests you the most!

Why Trustless Work?

• Escrows are a great way to solve for trust.

  Escrows are neutral way to hold funds while specific conditions are met. Most people tend to think about Real Estate when I mention escrows, and they are right! we DO use escrows for Real Estate and high value transactions!

But Escrows are useful for so many things, for example, marketplaces like Upwork and Ebay use them:

Ebay and Upwork can afford to build their own escrow infrastructure. Well, sort of... Ebay actually uses Escrow.com, a huge legacy escrow company that takes between (3% - 8%) , Upwork, built Upwork Escrow inc. But thats not the reality of most businesses...

Platforms that could greatly benefit from the use of escrows don't use them because of the technical complexity and cost of building an escrow infrastructure.

• Escrows with Fiat are next to impossible to build (Legacy escrows). Escrows are more commonly found on high value transactions, like Real Estate, Merge and Aquisitions, and cross border trade mainly because they are costly and sloe. Fiat requires bank accounts or a complex settlement system to achieve this functionality. I've met people who toook a year to build their escrow infrastrucute, A YEAR!

• Blockchain obviously solves this, but complexity to built it is still high. Blockchain and web3 are the perfect solution for this, but we can't expect for every marketplace out there to have a Smart Contract engineer. Getting to experiment, test and scale with this technology is resource intensive and has a steep learning curve.

Trustless Work is building the Escrow Infrastructure for the New Economy.

A simple, scalable solution for anyone to integrate blockchain-based escrows to their payment flow.

Next Steps

With a great problem identified and a motivated team in place, it was time to explore the solution. Alberto presented his research and findings, laying the foundation for what would become Trustless Work.

The Core Idea

Escrows have long been a trusted mechanism for securing payments, but traditional systems are inefficient, costly, and inaccessible for smaller contracts.

💡 The Insight Trustless Work introduces decentralized escrow contracts—an agile, blockchain-based solution that ensures transparency, security, and fairness for all parties involved.

Escrow Benefits

Using Escrows to Mitigate Risks

• Guarantees payment for service providers.

• Protects clients from incomplete or subpar work.

• Builds trust in transactions by holding funds securely until conditions are met.

Traditional Escrow Limitations

Conventional escrow systems come with significant drawbacks:

• 🏦 Reliance on Banks and Lawyers: Intermediaries introduce high costs and delays.

• 💸 High Fees: Escrow services are often prohibitively expensive for smaller transactions.

• ⏳ Slow Processing: Settlement times can stretch into days or weeks.

Examples of Escrows in Action

Escrow solutions are already solving critical problems in established platforms:

• 🛒 eBay: Escrow mitigates risks between buyers and sellers in e-commerce.

• 💼 Upwork: Escrow protects freelancers and clients in service-based transactions.

Trustless Work builds on this proven concept but leverages blockchain to eliminate the need for centralized intermediaries.

A Focused Approach

Our team recognized that milestone-based payments would be the best starting point, especially for clients and service providers. This targeted solution provided a clear path to:

• Demonstrate feasibility.

• Showcase the potential of blockchain-powered escrows.

• Develop a scalable product.

🎯 The Result This focus on milestone-based payments and a clear value proposition helped us secure a spot in the Astro Hacker House program, where our journey truly began.

Trustless Work is actively participating in programs and campaigns that fuel our growth, enhance our product, and build a strong developer community.

1. 🌟 Draper Embark Program

   • A 10-week accelerator helping us refine our product strategy and connect with investors.

   • Learn more

2. 💻 OD Hack Campaigns

   • Open-source developer engagement that has significantly contributed to our product maturity.

   • Learn more

Great ideas need great teams. For Trustless Work, everything began to align when a vibrant community and a shared vision brought the right people together.

⛩️ Dojo Coding

🌟 A Two-Way Partnership Dojo Coding continues to be a cornerstone for Trustless Work’s development efforts, while Trustless Work contributes back to the community by engaging developers, sharing insights, and strengthening the broader web3 ecosystem.

The Core Team Assembles

Within Dojo Coding, Joel reached out to Alberto, eager to team up for something meaningful: ✉️ Joel’s Message

• “Hey, we’re forming a team, and we’re looking for a product idea. Want to collaborate?”

• “Yeah, sure.” 😎

Meet our founding team! 🥳

The First Call

🎯 A Shared Goal From the beginning, their focus was clear: build a solution that could get into Astro Hacker House, refine the idea, and set the foundation for something transformative.

The Beginning of a Shared Vision

With a clear problem to solve and a team aligned on the mission, Trustless Work began to take shape. This was no longer just an idea—it was a collaboration fueled by a shared belief in the power of blockchain to simplify and secure payments. LFG! 🚀

Trustless Work was accepted into the Draper/Stellar Embark Program, marking a significant milestone in our journey. This 10-week program connected us with Draper University and Stellar Ventures, making them our first investors.

Program Highlights:

• 🌍 10 Startups from Around the World: Joined a global cohort of innovators.

• 📈 Focus on Growth: The program enabled us to refine our product strategy, improve our go-to-market plan, and scale further.

• 🎓 Access to Mentorship: Gained insights from experienced VCs and founders to prepare for an eventual fundraise.

• 📅 Demo Day to Investors: The program concludes with a public demo day, offering exposure to a network of investors.

Every great innovation starts with a problem. For Trustless Work, it began with firsthand experience in the inefficiencies of traditional contracting and payment systems.

A Firsthand Encounter with the Problem

👨‍💻Personal Experience in Product Agency

Alberto, the founder of Trustless Work, encountered these challenges while running a digital product agency. The pain points were clear: traditional payment models were unreliable, inefficient, and costly.

🔄Client & Service Provider Dual Role

Acting as both a client for Argentine development teams and a service provider for U.S.-based clients revealed a flawed system, including:

• ⏳Payment Delays: Long waiting periods created cash flow crunches.

• 💰Upfront Costs: High initial payments were risky for clients and service providers alike.

• ⚙️Inefficient Models: The typical payment structure—50% upfront and 50% upon delivery—left both sides vulnerable.

🌎Validation of the Problem

Alberto’s insights were validated while engaging with other agencies during a pop-up city in Buenos Aires. It became evident that these challenges weren’t unique—they were systemic.

The Need for a Solution

The inefficiencies of traditional systems inspired the idea of a better approach:

• 🤝A payment model that minimizes risk for all parties involved.

• ⚡Automation to eliminate delays and reduce manual intervention.

• 🔍Transparency to foster trust between clients and providers.

What’s Next?

Alberto now had a great problem to solve—he just needed a team crazy enough to believe in the vision and help make it real!

The next major milestone was the launch of our API V1, an essential step in validating our technology and gathering feedback from developers.

🎯 Our Plan We sponsored the ETH Pura Vida hackathon and allocated 10% of the DraperU grant to organize and support the event.

Hackathon Highlights:

• 📋 Participation:

  • 55 Developers Registered, with 35 actively participating across 8 teams.

• 💡 Diverse Projects: Developers built innovative solutions using our API, including:

  • House rentals with automated escrows

  • Agricultural financing

  • Privacy-focused payment systems

  • Revenue-sharing for ridesharing apps like Uber

• 🌱 Community Growth:

  • Created a Telegram group with over 30 members, fostering ongoing collaboration.

  • Received invaluable feedback on our codebase, documentation, and overall vision.

• 🤝 Customer Leads: Connected with potential reference customers interested in integrating Trustless Work into their platforms.

Every journey has pivotal moments that shape its future. Explore the key milestones in Trustless Work’s evolution:

1. 🌌 DraperU Stellar Astro Hacker House

   • A three-week accelerator program that validated our solution and shaped our focus on an API-first approach.
2. ⚙️ Launching the API V1 at ETH Pura Vida Hackathon

   • Our first API release, tested and validated by developers during an Ethereum hackathon.

What is OnlyDust? 🌐

OnlyDust is a platform that connects open-source contributors with projects in need of development. It fosters collaboration within the web3 ecosystem by providing funding, mentorship, and tools for decentralized teams.

Why It Matters:

• OnlyDust empowers developers to work on impactful blockchain projects like Trustless Work.

• Through hackathons and campaigns, it helps projects scale while nurturing a thriving developer community.

Key Achievements:

• 🤝 First Contributors: Onboarded developers who contributed to our Smart Contracts and Escrow UI, laying a solid foundation for future iterations.

• 🛠️ Integration by Other Teams: Four teams using Trustless Work’s API also benefited from contributors and funding, helping them grow alongside us.

• 📋 Issue Assignments: A total of 58 issues (across Trustless Work and related projects) were completed, showcasing strong developer engagement.

Escrow UI Development: During OD Hack #10, we built the first version of our Escrow UI—a form-based interface enabling developers to:

• Fill in escrow details.

• Visualize how contracts are created.

Looking Ahead to OD Hack #11:

• 🛠️ Developer Mode: Introducing a new feature allowing developers to see how API requests are constructed as they interact with the UI.

• 📈 Simplifying Integration: This enhancement will make it easier for developers to implement our solutions in real-world use cases.

Trustless Work is pioneering a whole new category of escrows, unlocking opportunities for innovative use cases across diverse industries. The potential is immense, and we’re supporting builders to turn their visions into scalable verticals—each targeting massive markets independently.

Evolving Hackathon Projects into Verticals

We believe in the power of builders to transform ideas into impact. While anyone can build on Trustless Work without needing permission, we offer support in product development, business models, and scaling for those who align with our vision.

From hackathon concepts to fully-fledged verticals, here’s how some of our initial projects are taking shape:

1. Security Deposit Vertical 🏨

• Origin: Initially focused on house rentals.

• Evolution: Pivoted to offer security deposit solutions for broader applications, including:

  • Hotels

  • Car rentals

  • Directories requiring secure payment interactions.

2. Crowdfunding Vertical 🌱

• Origin: Collaboration between Kindify and Revolutionary Farmers.

• Solution: An escrow-based crowdfunding mechanism allowing multiple funders to contribute.

  • Flexible Fund Release Options: By milestone or as a lump sum.

  • Applications: Social impact projects, agricultural financing, and community-driven initiatives.

3. Future Verticals 🌍

• Trade Finance: With Costa Rica’s recent invitation to join the CPTPP (Comprehensive and Progressive Agreement for Trans-Pacific Partnership), new opportunities are emerging to integrate escrows into international trade finance.

  • Why It Matters: Escrows can streamline payments across member countries with diverse currencies, reducing friction and boosting trust in global trade.

• Marketplaces: This vertical is in development, with promising potential to create secure payment solutions for e-commerce and platform-based economies.

A Strategic Approach to Vertical Development

Each vertical is positioned as an independent product capable of:

• Pursuing its own funding through grants or investments.

• Leveraging Trustless Work’s infrastructure as the backbone for secure, transparent transactions.

• Targeting massive markets with scalable solutions.

We’re fostering a future where builders can capitalize on the stablecoin wave and leverage Trustless Work to create entirely new markets for escrow technology.

Your Opportunity to Build 🚀

• Permissionless Development: Anyone can build on Trustless Work without needing approval.

• Support for Builders: For those looking to scale their ideas, we offer resources, guidance, and a collaborative network to help you succeed.

Join us in shaping the future of escrow technology—one vertical at a time.

Welcome to Trustless Work — your gateway to programmable, secure, and non-custodial escrows powered by blockchain.

This guide is your launchpad whether you're:

• A business aiming to scale global payments with programmable trust

🧠 1. Understand the Basics

What is Trustless Work? Trustless Work is a blockchain-powered, Escrow-as-a-Service platform. We help you integrate milestone-based payments with zero custodians and maximum flexibility.

Why use it?

• 🚀 Launch escrow flows in minutes, not months

• 🔐 Secure, neutral payment infrastructure

• 💸 Save on dev costs and transaction fees

• 🌍 Enable global, stablecoin-based payments

🧪 2. Design Your Escrow Lifecycle

Before deploying, define the roles and responsibilities within your escrow flow.

• Milestone markers

• Approvers

• Release signers

• Receivers

🧰 3. Deploy and Test on Our dApp

We’ve built a lightweight dApp to help you deploy escrows without writing code.

Before you start:

🛠️ 4. Start Building

• Reuse open-source templates (React, Soroban)

• Extend with your own integrations

🤝 5. Contribute to the Ecosystem

We grow in public — and you can join us:

• 🧱 Build your own product on top of Trustless Work

• 💥 Get featured in our Ecosystem Spotlight

📈 Next Steps

💬 “The world runs on trust. And trust runs on escrow. Let’s build a better future, together.”

At Trustless Work, we’re not just building a product—we’re creating the foundation for a global, trustless ecosystem. Our vision is to redefine how payments are managed, risks are mitigated, and trust is established in the modern economy.

Scaling the Escrow Ecosystem 🌍

We aim to make Trustless Work an integral part of how businesses handle payments by:

• 🔗 Open-Source Tools: Continuing to expand and refine our developer-friendly, open-source tools.

• ⚙️ Modular Solutions: Offering flexible APIs and templates for seamless integration across platforms.

• 📈 Accessibility: Scaling to support transactions of all sizes, from micro-payments to enterprise-level deals.

Expanding Use Cases with Partners 🤝

While marketplaces and freelancing platforms were our starting point, the future holds immense opportunities in diverse industries:

• 🏠 Real Estate: Escrows for property sales, rental agreements, and security deposits.

• 🌾 Agriculture: Transparent financing mechanisms for farmers and cooperatives.

• 💳 Fintech: Integrating blockchain escrows into payment gateways and banking solutions.

• 📦 E-commerce: Revolutionizing buyer-seller protections with transparent, automated escrows.

Through partnerships, we’re unlocking the potential for Trustless Work to support and transform industries that rely on secure transactions.

Building a Trustless Ecosystem 🛠️

Our ultimate goal is to empower platforms with:

• 💡 Transparency: Eliminating black-box systems and ensuring all transactions are visible and verifiable.

• 🛡️ Security: Leveraging blockchain to provide tamper-proof, decentralized solutions.

• ✨ Simplicity: Abstracting blockchain complexities, enabling anyone—developer or not—to build on Trustless Work with ease.

Looking Ahead 🚀

The future of Trustless Work lies in:

• Network Effects: Growing a community of developers, partners, and users who contribute to and benefit from the ecosystem.

• Decentralized Governance: Transitioning to a DAO structure to ensure scalability, inclusivity, and resilience.

• Continuous Innovation: Pioneering new technologies and use cases to stay at the forefront of escrow innovation.

Join us in shaping the future—one transparent, secure transaction at a time.

This three-week program was a game-changer for us. Held at Draper University in San Mateo, it brought together 30 startups and provided us with a $20,000 grant to further develop our vision.

What Made It Special?

• 🚀 Validation from Entrepreneurs: Many fellow founders expressed interest in integrating our escrow solution into their platforms, confirming its market potential.

• 🔍 Diverse Use Cases: We identified various applications for escrows across industries, including:

  • Freelancer services

  • Influencer platforms

  • Marketplace transactions

• 📈 A Strategic Focus Shift: Encouraged by feedback from luminaries like Tim Draper and Denelle Dixon (Stellar), we pivoted to an API-first solution—positioning Trustless Work as an Escrow-as-a-Service provider.

At Trustless Work, we believe trust is the foundation of all financial transactions. Our vision and mission drive everything we do, empowering platforms, developers, and businesses to innovate without boundaries.

Our Vision

To drive the new economy forward by building a foundation of trust, scalability, and transparency in global payments.

We envision a world where financial transactions:

• Are secure and transparent by default.

• Eliminate the need for costly intermediaries.

• Empower businesses of all sizes to scale globally.

Through our platform, trust is no longer a barrier—it’s embedded into the system itself.

Our Mission

To solve trust in global payments by providing configurable, scalable, and transparent escrow infrastructure and tools for the new economy.

How We Fulfill This Mission:

1. Configurable Solutions Allow businesses to tailor escrow workflows to their unique needs, from milestones to multi-party agreements.

2. Scalable Infrastructure Support high transaction volumes and diverse industries, enabling seamless growth.

3. Transparent Tools Leverage blockchain technology to ensure visibility and fairness in every transaction.

Why It Matters

Escrows address one of the most critical challenges in payments: trust.

• In traditional systems, trust is built through intermediaries—banks, lawyers, and brokers—resulting in high costs, delays, and limited accessibility.

• These barriers slow down innovation, increase costs, and limit opportunities for businesses and individuals.

Trustless Work eliminates these inefficiencies, fostering trust through:

• Blockchain-Powered Automation: Escrows managed by smart contracts.

• API-Driven Simplicity: Easy integration for developers and businesses.

• Global Accessibility: Bringing secure transactions to everyone, everywhere.

Our Commitment

We are dedicated to empowering platforms and developers to unlock the full potential of blockchain without requiring deep technical expertise. By enabling trustless transactions across industries, we:

• Simplify payment logic.

• Reduce costs and time delays.

• Open new avenues for innovation.

Together, we’re building a trustless future where businesses thrive and transactions are effortless.

What’s Next?

Explore how we bring this vision to life:

• Our Journey So Far: Discover the milestones that shaped us.

• How It Works: Dive into the mechanics of smart escrows.

At Trustless Work, we solve one of the most critical challenges in global payments: trust. By leveraging blockchain technology, we provide configurable, scalable, and transparent escrow infrastructure that eliminates costly intermediaries and complex processes, empowering platforms to build trustless payment flows with ease.

Our Vision

To drive the new economy forward by building a foundation of trust, scalability, and transparency in global payments.

Our Mission

To solve trust in global payments by providing configurable, scalable, and transparent escrow infrastructure and tools for the new economy.

Why Escrows Matter

At its core, an escrow is a neutral and secure way to hold funds while something else happens—whether it’s transferring a house, delivering a product, or completing a project.

In traditional payment systems, trust is built through:

• Costly Intermediaries: Banks, lawyers, or brokers.

• Complex Processes: Lengthy, manual procedures.

• Limited Transparency: Little visibility into where funds are and why delays occur.

These barriers slow innovation, increase costs, and limit accessibility for businesses and individuals alike.

How Trustless Work Changes the Game

We provide a new way to manage trust with blockchain-powered smart escrows. Our platform enables platforms and developers to:

• Configure escrow workflows for any use case.

• Scale payment processes with an API-first approach.

• Ensure transparency and fairness with blockchain technology.

By reducing the time, cost, and technical barriers traditionally associated with escrows, we enable businesses to focus on innovation while ensuring trust and security.

What We Offer

1. Escrow-as-a-Service Seamlessly integrate escrow workflows into any platform.

2. Developer-Friendly Tools API-first design, open-source templates, and testnet resources.

3. Diverse Applications Supporting industries from marketplaces to crowdfunding, real estate, and trade finance.

Next Steps

Learn more about how we’re building trust and innovation in payments:

• Our Vision and Mission: Dive deeper into our purpose.

• Our Journey So Far: Explore the milestones that shaped Trustless Work.

• Meet the Team: Get to know the people behind the platform.

Trustless Work enables programmable, non-custodial escrows tailored to any workflow. This section merges conceptual understanding with practical design tools, helping you move from theory to implementation.

🔎 What is a Smart Escrow?

A Smart Escrow is a blockchain-based smart contract that holds funds until specific conditions are met. It is trustless, programmable, and transparent by design.

• 📅 Set Up: Define roles, amounts, and milestone logic

• 💳 Fund: Lock stablecoins (USDC, XLM) on-chain

• ✅ Execute: Release funds only when verified conditions are met

Trustless Work escrows are:

• 🔒 Non-Custodial

• 🚀 Fast & Low-Cost (on Stellar/Soroban)

• ⚖️ Transparent & Programmable

Learn more in the Escrow Lifecycle Guide.

🔌 Why Not Use Traditional Escrow?

How It All Works Together 🏗️

🧠 Key Roles in an Escrow

Roles define who can take actions at each phase.

🛠️ Escrow Lifecycle Overview

Trustless Work escrows follow a clear, auditable sequence:

1. Initiation → 2. Funding → 3. Milestone Update → 4. Approval → 5. Release → 6. (Optional) Dispute Resolution

View the full Escrow Lifecycle Deep Dive.

🧱 Use Case Examples

• Freelance Marketplace

• DAO Grant Program

⬇️ Next Steps

💬 Smart Escrows let you codify trust into your workflows. Start by designing your ideal transaction flow—and let Trustless Work handle the rest.

Welcome to the Smart Escrow Design section.

To simplify the design process, we have subdivided the escrow lifecycle into distinct phases. Click on any phase to learn more:

Each phase plays a crucial role in the lifecycle, and each participating party has one or more defined roles.

Escrow Design

Start designing your escrow configurations visually using our Excalidraw or Figma (old) template. Feel free to copy it and accelerate your Go To market by correctly planning your Trustless Work integration!

At Trustless Work, our team is dedicated to building a secure, scalable, and transparent payment infrastructure for the new economy. With a shared vision and diverse expertise, we’re paving the way for trustless transactions across industries.

Core Team

Alberto Chaves

Role: CEO, Product Leader

Joel Vargas

Role: Frontend Developer

Armando Murillo

Role: Full Stack Developer

Caleb Loría

Role: Smart Contract Developer

Contact Us

Have questions or ideas? Connect with us:

What Drives Us

Our team combines technical expertise with a shared passion for solving trust challenges in global payments. We work tirelessly to deliver configurable, scalable, and transparent solutions for platforms worldwide.

Get In Touch

Escrow ID: This is the same as the contract address, users will send funds to this Address. (Trustline should be set).

Balance: The amount of funds currently in the escrow (deposited to escrow id).

Escrow properties:

• Trustline: Trustline of the token to be deposited

• Amount: The expected amount expected to be held in escrow (this is a numerical value configured on deployment, not the current balance on escrow).

• Platform Fee: Extra fee that is sent to platform Address.

• Engagement ID: Used to assign an extra identifier to escrows (invoice, project ID, order id, etc).

Flags:

• Disputed: Set to true when a party raises a dispute

• Released: Set to true when the release transaction has been signed and funds have been released.

• Resolved: Set to true when the dispute resovler has had to interfere.

Milestones:

• Title: Name of the milestone. Ex: Delivery of code

• Description: A description of the milestone, can also include acceptance criteria.

• Status: Pending (default) - Completed (when marked as complete)

We are also working on this type of escrow contract: multi-release

Main difference being that the amount and flags are moved to the milestone, therefore you can have independent fund releases per milestone. I will reference this type of contract in our docs too as it is currently being built.

Roles are assigned to addresses. Anyone can deposit funds into an escrow, but the status while only changed by predetermined steps, which are initiated and signed by the corresponding roles.

Roles, Parties, and Their Functions

• Roles: Each role has a distinct function within the escrow process, such as approving milestones or releasing payments.

• Parties: These are the entities or individuals assigned to one or more roles, such as buyers, sellers, or platforms. They interact through a Stellar wallet for signing any interactions with the escrow. Only addresses with assigned roles can interact with the escrow.

Roles:

1. Milestone Approver

• Function: Approves or disputes milestones marked as completed.

• Examples:

  • Buyer in a freelance marketplace approves the deliverable marked as done by the freelancer.

  • Host in a security deposit scenario approves the checkout marked as done by the turist.

  • Platform in a crowdfunding campaign approves milestone marked as done by the company.

2. Service Provider

• Function: Delivers the product, service, or objective set on milestine. Marks milestones as completed and ready for approval.

• Examples:

  • Freelancer delivering a service and marking it as complete.

  • Company updating crowdfunding milestones and marking as complete.

  • Compliance department marking a withdraw complaince check as complete.

  • Real Estate inspector marks the house inispections as complete.

3. Release Signer

• Function: Approves the release of funds for the amount set.

• Examples:

  • Airbnb (platform) releasing a deposit.

  • eBay (platform) releasing payment to a seller.

  • DAO releasing a payment to a contributor

4. Dispute Resolver

• Function: Resolves disputes by adjusting milestone amounts, updating status, or canceling the contract.

• Examples:

  • Platform (eBay, Airbnb) acting as arbiter for a deposit because turist broke something redirecting deposit to host.

  • Independent third-party arbitrator setting a new milestone price for an project milestone.

  • Cenceling an escrow amount and redirecting funds back to Client.

5. Platform Address

• Function: An address designated to receive the platform fee, a percentage or fixed amount of the total funds processed through escrow. Platform can also update a milestone while it's status is still pending.

• Examples:

  • Airbnb collecting platform fees.

  • Crowdfunding platform taking a fee from funds raised.

6. Receiver - Final Recipient

• Function: The final recipient of funds after conditions are met or disputes are resolved.

• Examples:

  • Freelancer receiving payment.

  • Turist receiving a security deposit.

  • Company receiving funds

The Initiation Phase is the foundation of the escrow process. It ensures that all necessary details are captured, roles are assigned, and conditions are clearly defined. This phase lays the groundwork for a secure, transparent, and efficient transaction.

Participants and Roles

In the initiation phase key roles are assigned to specific parties. These roles determine responsibilities and actions throughout the transaction.

The roles are:

1. Client/Milestone Approver: Approves or disputes milestones.

2. Service Provider / Milestone Marker: Marks milestones as completed and ready for approval.

3. Release Signer: Approves the release of funds for completed milestones.

4. Dispute Resolver: Resolves disputes and adjusts milestone statuses if necessary.

5. Receiver: The final recipient of funds once conditions are met.

6. Platform Address: An address designated to receive the platform fee.

Parties: Parties are entities (e.g., buyer, seller, platform) assigned to fulfill one or more roles based on the use case. You can learn more about how this can work for different use cases later on.

Other escrow properties configuredin this phase:

• Engagement ID

  • Definition: A customizable identifier that links the escrow to an external system or reference, such as a UUID, Order ID, or Invoice ID.

• Amount: The total funds to be held in escrow.

• Platform Fee: A fixed or percentage-based fee for the platform’s services, in bps.

• Milestones: Defined deliverables or outcomes that are tracked and verified throughout the process.

• Trustline: The Contract address of the Token used for the escrow.

Process Steps

Step 1: Configuring Terms

• Parties and Address are configured at a platform level. All parties agree on the transaction terms, including:

  • Deliverables or milestones.

  • Payment amounts and structure.

  • Roles and responsibilities.

Step 2: Recording Metadata

• The platform records escrow details, assigns an Engagement ID for their own tracking, platform fee, platform address, trustline, and prepares to deploy the escrow contract.

Step 3: Initializing the Escrow

• Using the Trustless Work API, the platform deploys the escrow contract with the configured terms.

• Upon deployment:

  • A unique Escrow ID (Contract ID) is generated and returned to all parties for reference. Funds of the approved trustline can be deposited to the escrow ID.

Example Scenario: Freelance Marketplace (e.g., Upwork)

• Engagement ID: Order_12345 links the escrow to the platform's order system.

• Escrow ID: Generated by the Soroban network as 0xABC123....

• Roles Assigned:

  • Milestone Approver: Client.

  • Milestone Marker: Freelancer.

  • Release Signer: Upwork.

  • Dispute Resolver: Upwork.

  • Receiver: Freelancer.

  • Platform Address: Upwork (receiving platform fees).

• Outcome: The escrow contract is initialized with:

  • Clear roles and responsibilities.

  • Transparent milestone and payment structures.

  • A shared understanding among all parties.

Outcome of the Initiation Phase

1. A smart escrow contract is successfully created and ready for the transaction.

2. Roles, parties, and conditions are clearly defined and documented.

3. Engagement and Escrow IDs provide traceability and clarity.

4. All participants have full visibility, fostering trust and reducing potential disputes.

Escrow ID (Contract ID)

The escrow ID is what we are going to use as address to deposit funds in the next phase. Anyone can send funds to an escrow, as long as it is the accepted token (Trustline is set).

• Definition: A unique identifier automatically generated by the Soroban network when the escrow smart contract is deployed.

• Purpose: Serves as the primary identifier for the escrow contract on the blockchain.

The escrow lifecycle represents the structured flow of actions and responsibilities involved in securely managing a transaction. At Trustless Work, we break this lifecycle into clear, logical phases, ensuring transparency and adaptability for diverse use cases.

Core Phases of the Escrow Lifecycle

2. Funding Phase: The phase where the funds are deposited into the escrow contract, securing the transaction and preparing for the next steps.

3. Milestone Updates Phase: As the transaction progresses, milestones are marked as completed by the designated party, providing visibility and enabling reviews.

4. Approval Phase: The phase where milestones are reviewed and approved (or disputed), moving the transaction closer to resolution.

5. Release Phase: Funds are released to the designated recipient based on milestone approvals or dispute resolutions, completing the financial component of the transaction.

Alternative Phase in the Escrow Lifecycle

If, any of the parties raise a dispute, the lifecycle takes a " detour" into the dispute resolution phase.

1. Dispute Resolution Phase: Engaged when there are disagreements between parties, this phase ensures fairness by resolving disputes and determining the final outcome. Disputes can end in a full refund, partial refund, or null refund to the client.

The Milestone Status Update Phase is where the Milestone Marker signals progress by marking a milestone as completed. This step is critical for keeping all participants informed about the transaction's progress and prepares the milestone for review by the Milestone Approver in the subsequent Approval Phase.

Key Actions

1. Milestone Marker Updates Milestone Status

• The Milestone Marker logs into the platform or uses the Trustless Work API to update the milestone status to For Review, he signs the transaction, signaling the completion of the deliverable.

2. Escrow Contract Updates

• Upon the signed update, the escrow contract:

  • Changes the milestone status to For Review.

  • Retains the Approved Flag as False until explicitly approved or disputed by the Milestone Approver.

3. Notification to Milestone Approver

• The platform detects the status update and notifies the Milestone Approver that the milestone is ready for review.

4. Transparency for All Participants

• All participants, including the Milestone Marker, Release Signer, and Platform Address, can view the updated milestone status:

  • On-chain via the transaction ID or Stellar block explorer.

  • Through the Escrow Viewer or by querying the Trustless Work API.

Key Metadata

1. Milestone Status:

   • For Review: Indicates the milestone is ready for approval or dispute.

2. Approved Flag:

   • Default = False: Remains unchanged until explicitly approved or disputed by the client.

3. Progress Details (to be added):

   • Optional fields can include:

     • Delivery notes.

     • Evidence of completion (e.g., reference IDs or uploaded documentation).

Key Notes

• Blockchain Visibility: All participants can view the updated milestone status on-chain, ensuring transparency and traceability of progress.

• Platform Notifications: The platform plays a key role in notifying the client (Alice) about the milestone update, facilitating smooth communication.

• Optional Progress Details: The service provider can add supporting details or documentation (e.g., delivery receipts, tracking numbers) to enhance transparency.

Phase Outcomes

1. Milestone Progress Recorded:

   • The service provider’s update is recorded on-chain, ensuring transparency and traceability.

2. Client Notified for Review:

   • The client (Alice) is notified to review the milestone and take action in the next phase.

3. Escrow Contract Reflects Progress:

   • The escrow contract’s milestone status is updated, preparing the transaction for the Approval Phase.

The Approval Phase is where the Milestone Approver evaluates the milestone marked as For Review by the Milestone Marker. This critical step determines whether the milestone is approved or disputed, dictating the next steps in the escrow process and transitioning the transaction toward completion or resolution.

Key Actions

1. Milestone Approver Reviews the Milestone

• The Milestone Approver evaluates the deliverable or service associated with the milestone, referencing any supporting evidence or details provided by the Milestone Marker.

2. Decision: Approve or Dispute

• Approve:

  • If satisfied, the Milestone Approver approves the milestone.

  • The Approved Flag is updated to True, signaling that the transaction can proceed toward the Release Phase.

• Dispute:

  • If concerns arise, the Milestone Approver disputes the milestone.

  • The Approved Flag is updated to On Dispute, pausing the transaction and escalating it to the Dispute Resolver.

Next Steps: the approved / dispute flag determines what Next step on the excrow lifecycle is enabled.

If the milestone is approved, the Release is possible,

If a dispute is raised, the dispute resolver must set a resolution and either update the amount, or cancel the milestone.

Key Metadata

1. Milestone Status

• For Review: Indicates the milestone is under review by the Milestone Approver.

• On Dispute: Set when the milestone is disputed, triggering resolution by the Dispute Resolver.

2. Approved Flag

• True: Set when the Milestone Approver approves the milestone.

Key Notes

• Milestone Approver Authority: The Milestone Approver has sole authority to approve or dispute milestones, ensuring their satisfaction with the deliverable.

• Platform's Role: The platform facilitates the review process by providing tools and notifications to assist the Milestone Approver.

• On-Chain Transparency: All participants, including the Milestone Marker, Release Signer, and Platform Address, can track the milestone’s status and associated decisions on-chain.

• Dispute Escalation: Disputes trigger the transaction to enter the Dispute Resolution Phase, ensuring fair and transparent resolution before proceeding.

The Funding Phase is where funds are deposited into the escrow smart contract, signaling the formal commitment of all parties to the transaction. This phase ensures the financial security of the agreement, builds trust among participants, and sets the stage for the remaining phases.

Key Actions

1. Depositing Funds

• Anyone with a Stellar wallet and funds in the configured currency can deposit to the escrow smart contract.

• The escrow contract address is the Escrow ID (Contract ID) generated during the Initiation Phase.

2. Escrow Contract Updates

• Upon deposit, the escrow contract:

  • Updates the balance to reflect the deposited amount.

  • Emits a blockchain Deposit Event, notifying all participants of the successful funding.

3. Verification by Participants

• All participants, including the Milestone Marker, Release Signer, and Platform Address, can independently verify the transaction using:

  • The transaction ID (e.g., tx123abc) on the Stellar network and Stellar block explorer.

  • The Escrow Viewer provided by Trustless Work.

  • A direct request to the Trustless Work API using the Escrow ID.

Key Notes

• Blockchain Transparency: All participants can independently verify the funding status using the transaction ID on-chain.

• Stellar Integration Flexibility: Any Stellar Anchor (on/off-ramp) can be seamlessly integrated to fund the escrow, allowing for global accessibility and currency flexibility.

• Escrow Balance Updates: Participants calculate funding status off-chain by comparing the balance with the agreed amount.

Outcomes of the Funding Phase

1. Funds Held On-Chain:

   • The deposited amount is securely held in the escrow smart contract, ensuring safety and transparency.

2. Participant Verification:

   • All participants can verify the funding details using the on-chain transaction ID, building trust and confidence.

3. Trust Reinforced:

   • The client’s deposit demonstrates their commitment to the transaction, fostering trust with the service provider.

At Trustless Work, we use USDC to provide a secure and stable medium of exchange for all escrow transactions. USDC is a USD-backed stablecoin that ensures your funds are safe, predictable, and easy to transact with, providing a reliable bridge between traditional finance and blockchain technology.

Why USDC?

Stability and Reliability 📊

• Pegged to the U.S. Dollar: USDC is a stablecoin backed by reserves of U.S. dollars. This means that for every USDC in circulation, there is a corresponding dollar held in reserve, ensuring that the value of USDC remains stable and predictable.

• Ideal for Escrows: Stability is crucial when dealing with escrow transactions, as it ensures that the value of the funds held in escrow does not fluctuate unexpectedly, providing peace of mind for both parties.

Instant, Low-Cost Transactions ⚡

• Built on Stellar: Our escrows use USDC on the Stellar blockchain, which means low transaction fees and fast settlement times. Traditional financial rails can be slow and expensive—USDC on Stellar provides a scalable solution to process payments in seconds with minimal cost.

• No Banking Delays: Unlike traditional bank transfers, USDC transactions are completed in seconds, without the delays associated with banking hours, cross-border restrictions, or manual intervention.

Global Accessibility 🌍

• Borderless Payments: With USDC, you can participate in transactions globally, without the need to convert currencies or deal with high international fees. This makes Trustless Work a perfect solution for freelancers, businesses, and marketplaces operating across borders.

• Supports Emerging Markets: By using USDC, we enable participation from countries where access to stable banking may be limited. This inclusion provides new opportunities for businesses and individuals worldwide.

How USDC Fits into Trustless Work's Ecosystem 🔄

• Escrow Creation: When escrows are created through Trustless Work, funds are securely held in USDC. This ensures that the value remains stable throughout the escrow lifecycle, eliminating the risks of currency fluctuations.

• Fund Management and Release: When milestones are met or contract terms are fulfilled, USDC is used to release the funds, offering a transparent and traceable settlement process on the blockchain.

• Partner Integrations: Our Stellar Partner Network makes it easy to convert USDC to fiat or use it directly for payments. The flexibility of USDC allows you to either use it for future blockchain transactions or convert it to your local currency when needed.

Key Benefits of Using USDC in Escrows

• Security: Funds are fully backed and auditable, ensuring complete security.

• Fast Settlement: No delays, no waiting—instant payments.

• No Volatility: Unlike cryptocurrencies like Bitcoin, USDC is designed to maintain a stable value, making it ideal for contractual payments.

Trustless Work and USDC together provide a stable, efficient, and secure escrow solution for the digital economy. Start building today!

The Trustless Work API is a developer-friendly interface that enables you to integrate escrow functionalities seamlessly into your platform. Whether you're building a marketplace, a SaaS product, or any platform that requires trust in transactions, the API offers everything you need to easily manage the lifecycle of an escrow.

Core Functions of the API

Initialize Escrows 🏁

• Kickstart a new escrow by specifying key parameters such as amount, recipient, and conditions.

• The API handles the creation of a unique escrow smart contract, eliminating the need for manual blockchain interactions.

Fund and Manage Escrows 💰

• Fund Escrows: Deposit funds into the escrow securely—whether it's USDC or another asset supported by the Stellar Network.

• Manage Conditions: Define conditions and milestones to align with your project requirements. The API lets you monitor and update these as needed.

Approve and Release Funds ✔️

• Once the conditions are met, use the API to approve fund release. The open-source smart contracts ensure funds are released only when both parties fulfill their obligations.

• By making approvals programmatic, the Trustless Work API helps automate workflows, reducing the need for manual checks and verifications.

Track Escrow Status 📊

• Stay up to date with the escrow's status at every step. From initiation to completion, the API lets you retrieve information about the escrow state, milestones, and remaining conditions in real-time.

How It Simplifies Escrow Integration

• Abstracts Blockchain Complexity: No need to be a blockchain expert. The Trustless Work API makes interacting with smart contracts as easy as a standard API call—no need for specialized blockchain engineers or understanding complicated crypto processes.

• Secure and Transparent: The API integrates directly with open-source escrow smart contracts, deployed on the Stellar blockchain, ensuring that funds are managed securely and that every transaction is transparent and traceable.

• Seamless User Experience: You can configure the conditions, roles, and actions for an escrow without needing to touch any of the underlying blockchain logic. The Trustless Work API manages everything for you, allowing you to focus on building your platform’s unique features.

When to Use the Trustless Work API

• Marketplaces and Platforms: Ensure buyer and seller trust with secure milestone payments.

• Freelance Platforms: Protect clients and freelancers by releasing funds only upon verified completion.

• Rental and Security Deposits: Hold deposits safely until conditions are met, such as returning a rental item or completing an inspection.

• Crowdfunding Campaigns: Ensure contributors' funds are only used once milestones are achieved, providing trust and transparency for backers.

Technical Reference 📑

Ready to explore more? Visit our API Reference for technical details, and begin integrating trustless escrow solutions today!

Summary

• How can I run the dApp locally in order to have a code guide.

• Important blocks in the dApp to make TW works.

Trustless Work is powered by the Stellar blockchain and its innovative Soroban smart contract platform. Together, these technologies form the foundation for secure, scalable, and trustless escrow transactions.

Why Stellar? 🚀

Stellar is a powerful blockchain specifically designed for financial transactions. It enables fast, low-cost transfers of digital assets, which is crucial for ensuring our escrows are efficient and accessible to everyone.

1. Low Fees and Fast Transactions ⚡

• Speed: Transactions on Stellar are confirmed within seconds, meaning no more waiting for days like with traditional banking or slower blockchains.

• Low Costs: The transaction fees on Stellar are a tiny fraction of a cent, allowing escrows to operate economically, even for smaller-value transactions. This is a game-changer compared to the often high fees of traditional escrow solutions.

2. Stable and Scalable 🏗️

• Designed for Financial Use: Stellar was built with the financial sector in mind, providing stability for payments and transactions. This is a perfect fit for escrow services, where stability is key.

• Global Network: With Stellar, we can provide cross-border escrows with minimal fees, allowing businesses, freelancers, and marketplaces to interact globally without incurring high costs.

Introducing Soroban: Stellar’s Smart Contract Platform 💡

Soroban is Stellar’s smart contract platform, designed to bring programmable logic to the blockchain, allowing developers to create advanced, trustless applications.

1. Modern, Secure Smart Contracts 🔗

• Built with Rust: Soroban smart contracts are written in Rust, a language known for its security and performance. This ensures that Trustless Work is secure, efficient, and scalable—crucial for handling financial transactions.

• Decentralized Trust: By using Soroban, Trustless Work offers a decentralized, tamper-proof solution for managing funds. Funds are released only when conditions coded in the smart contract are met—removing the need for a trusted third party.

2. Flexibility & Programmability 🛠️

• Customizable Contracts: Soroban allows us to create custom smart contracts that fit a wide variety of use cases—from milestone-based payments for freelancers to complex multi-party transactions.

• Scalable Logic: The smart contracts on Soroban enable complex operations without compromising on speed or reliability, making it possible for Trustless Work to handle high volumes of transactions smoothly.

How Stellar and Soroban Power Trustless Work 🌐

• Escrow Transactions: All escrows on Trustless Work are secured by Soroban smart contracts, deployed on the Stellar blockchain. This combination ensures that funds are securely held and released transparently.

• Seamless Integration: The Trustless Work API abstracts the interaction with Soroban smart contracts, allowing developers to use escrow functionalities without dealing with blockchain complexities.

• Global Accessibility: By leveraging Stellar’s network, Trustless Work can provide global escrow services with low fees and instant settlement, making it an ideal choice for international transactions.

Introduction

The Deploy endpoints allow users to deploy escrows efficiently. These endpoints provide the way to initialize escrows in the Stellar's Blockchain.

Deploy Endpoint Overview

When using the deploy endpoints, users can seamlessly create and manage escrows. Here's a breakdown of the functionalities and how to utilize them effectively:

• Initialize Escrow: Start by setting up a new escrow agreement. This includes specifying the terms, amounts, and parties involved.

These endpoints ensure secure transactions by leveraging Stellar's infrastructure, guaranteeing transparency and reliability.

The Release Phase is initiated when the Release Signer approves the release of funds. This triggers the escrow smart contract to perform verification checks, deduct fees, and securely disburse funds to the Receiver. The escrow is then marked as completed, concluding the transaction.

Key Actions

1. Triggering the Release

• The Release Signer signs the release transaction, signaling the intent to disburse funds.

• The escrow smart contract initiates the release process.

2. Verification of Milestones

• The escrow smart contract verifies:

  • All milestones have their Approved Flag set to True.

  • No milestones are in a disputed state (Approved Flag ≠ On Dispute).

3. Fee Deductions

• Upon successful verification, the escrow contract calculates and deducts:

  • The Platform Fee (e.g., Marketplace fee%) as configured during the Initiation Phase.

  • The Trustless Work Fee (e.g., 0.3%).

4. Funds Disbursement

• The remaining funds are transferred to the Receiver Address designated during the Initiation Phase

5. Completion

• The escrow contract is marked as Completed, signaling the successful conclusion of the transaction.

Key Metadata

1. Release Signer

• The entity responsible for triggering the release by signing the transaction.

2. Milestone Approval Check

• Confirms that:

  • All milestones are approved (Approved Flag = True).

  • No unresolved disputes exist.

3. Fee Deductions

• Platform Fee Deduction: Calculated and deducted from the total escrowed amount.

• Trustless Work Fee Deduction: A fixed percentage (e.g., 0.3%) is deducted for using the Trustless Work infrastructure.

4. Receiver Address

• The blockchain address of the Receiver, who will receive the funds (e.g., Freelancer, Host, Company).

5. Release Transaction ID

• A blockchain reference (e.g., tx456def) for the release action, ensuring traceability and transparency.

Phase Outcomes

1. Funds Transferred Securely

• The Receiver (e.g., Freelancer, Host) receives the funds, minus the Platform Fee and Trustless Work Fee.

2. Escrow Marked as Completed

• The escrow status is updated to Completed, reflecting the transaction's successful conclusion.

3. Transparency Maintained

• All participants can trace the release process on-chain using the Release Transaction ID, ensuring full visibility and trust.

The Dispute Resolution Phase is triggered when either the client or the service provider raises a dispute. This phase involves a review by the designated dispute resolver (e.g., the platform, Marketplace) to determine how the funds should be allocated. The escrow contract remains in a locked state, with no funds released, until the dispute is resolved.

Key Actions

1. Raising a Dispute:

   • The client (or Service Provider) identifies issues with the milestone deliverable and raises a dispute.

   • Evidence or supporting documentation (e.g., screenshots, contracts, delivery notes) is submitted to the dispute resolver (As a URL)

   • The escrow contract updates:

     • Milestone Status: Set to In Dispute.

     • Dispute Flag: Updated to reflect the dispute status.

2. Dispute Resolver Review:

   • The dispute resolver (Marketplace) reviews the case, including:

     • Evidence provided by the client.

     • Responses or counter-evidence from the service provider (Bob).

   • The resolver makes a decision on fund allocation (e.g., full refund to client, partial payment to service provider).

3. Escrow Contract Updates:

   • Based on the resolver’s decision, the escrow contract is called for the release with:

     • Funds for Service Provider: Amount to be sent to service provider

     • Funds for Client: Amount to be sent back to the client

4. Sign and Release:

   • The resolver signs the resolution, releasing payment as set and setting the released flag to TRUE

Key Metadata

1. Milestone Status:

   • In Dispute: Indicates the milestone is under review by the dispute resolver.

2. Resolver Decision:

   • Contains the final decision, including updated allocations of funds.

3. Updated Amounts:

   • Reflects any changes to the original escrowed amount based on the resolution.

4. Final Approval Flag:

   • Set to True once the dispute is resolved, enabling the transition to the Release Phase.

Phase Outcomes

1. Resolution Achieved:

   • Funds are allocated according to the dispute resolver’s decision, ensuring a fair outcome for both parties.

2. Escrow Prepared for Release:

   • The resolution is set, enabling the transaction to transition to the Release Phase.

3. Dispute Transparency Ensured:

   • All resolution details, including fund adjustments and final decisions, are recorded and visible to participants.

Dapp:

Version

We currently are in version 2 of Trustless Work API.

Authentication

Our API requires authentication via an API key. Include your key in the Authorization header Bearer. To request an API key please see this section.

Our APi R

How can I run the dApp locally in order to have a code guide

Follow the Readme below to get started with this project

The first step is to register in our dApp, in order to be able to have an user and get our API Key. Here's the link to our DApp:

In order to get registered, you have to connect with a Stellar wallet. If you do not yet have one, or have never used one, there is more information in the following section:

Once you have a wallet, the login process is straightforward. Just go to dapp.trustlesswork.com, and click login, this should ask for a signature and then you are in!

Once logged in, you should complete your profile, and then request the API Key.

And that's it. If you have any issue, please fill the form of "Report and Issue".

To authenticate you will need to login to our Dapp with a Stellar Wallet and Request an API key. Here are the steps to chieve that:

Base URL

Production API

https://api.trustlesswork.com

Dev API

https://dev.api.trustlesswork.com

Warning!

You'll have 50 as a request rate limit per client in the API every 60 seconds.

GitHub Repository

API Swagger

Introduction to the Trustless Work REST API

The Trustless Work REST API is designed to offer decentralized escrow solutions by leveraging the power of smart contracts on the Stellar blockchain through Soroban. This API enables platforms and businesses to integrate secure, fast, and transparent escrow services, eliminating the need to rely on centralized intermediaries.

What is the API for?

The Trustless Work API is a key component for any platform that requires secure conditional payments. It allows the creation, management, and automation of escrow contracts, providing security for both payers and payees. This API can be used across various industries including e-commerce, SaaS, real estate, freelance marketplaces, and more.

Key API Functions:

• Create and manage escrow contracts: Users can set up payment agreements with specific conditions that must be met before funds are released.

• Real-time status updates: The API provides real-time access to escrow statuses, allowing users to verify the state of funds at any time. (Working)

Why is the API important?

This API is critical for offering businesses an efficient and secure way to manage payments without relying on third-party services. Trustless Work’s decentralized nature eliminates the risks associated with centralized intermediaries, such as delays or failures. Additionally, being blockchain-based guarantees full transparency and a significant reduction in operational costs.

REST API Advantages:

• Transparency: Every transaction is recorded on the blockchain, making it auditable and ensuring that all parties can track the flow of funds.

• Low Costs: Built on Stellar, the API benefits from minimal transaction fees compared to traditional solutions or even other blockchain platforms.

• Speed: Stellar's fast transaction finality ensures that payments are processed almost in real-time.

• Cross-chain compatibility: With USDC and Circle’s cross-chain transfer protocol, the API can operate across multiple blockchains, offering flexibility to businesses.

API Use Cases

1. Freelance marketplaces: Freelance platforms can use the API to manage milestone-based payments, enhancing trust and reducing disputes between clients and freelancers.

2. High-value e-commerce: In peer-to-peer transactions, escrow ensures that payment is only released once the product has been received and verified.

3. SaaS providers: Platforms managing recurring payments can leverage the API to release payments upon successful service delivery.

4. International real estate: Trustless Work helps secure funds in cross-border real estate transactions by releasing them only when all legal and contractual obligations are met.

5. Legal services: Law firms can manage complex multi-party agreements or settlements without needing manual escrow services.

In summary, the Trustless Work REST API provides a robust, transparent, and cost-effective solution for managing escrowed funds, catering to a wide range of industries and promoting security and trust in digital transactions.

Core Configuration

Fetching

In order to set the .env, please go to:

src\lib\axios.ts

import axios from "axios";

const http = axios.create({
  baseURL: process.env.NEXT_PUBLIC_API_URL || "",
  timeout: 60000, // 1 minute
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${process.env.NEXT_PUBLIC_API_KEY}`,
  },
});

export default http;

Wallet Integration

src\lib\stellar-wallet-kit.ts

import {
  StellarWalletsKit,
  WalletNetwork,
} from "@creit.tech/stellar-wallets-kit";
import { WalletNetwork } from "@creit.tech/stellar-wallets-kit";

// KIT Configuration
export const kit: StellarWalletsKit = new StellarWalletsKit({
  network: WalletNetwork.TESTNET,
  selectedWalletId: // wallets that you'd like to add,
  modules: // modules that you'd like to add,
});

// Sign Transaction
interface signTransactionProps {
  unsignedTransaction: string;
  address: string;
}

export const signTransaction = async ({
  unsignedTransaction,
  address,
}: signTransactionProps): Promise<string> => {
  const { signedTxXdr } = await kit.signTransaction(unsignedTransaction, {
    address,
    networkPassphrase: WalletNetwork.TESTNET, // or Mainnet
  });

  return signedTxXdr;
};

Global State Management

src\components\modules\auth\wallet\hooks\wallet.hook.ts

import { ISupportedWallet } from "@creit.tech/stellar-wallets-kit";
import { kit } from ".lib/stellar-wallet-kit.ts";
import { useGlobalAuthenticationStore } from "@/core/store/data";

export const useWallet = () => {
  const { connectWalletStore, disconnectWalletStore } =
    useGlobalAuthenticationStore(); /* If you're using some global state 
    management, in our case is Zustand */

  const connectWallet = async () => {
    await kit.openModal({
      modalTitle: "Connect to your favorite wallet",
      onWalletSelected: async (option: ISupportedWallet) => {
        kit.setWallet(option.id);

        const { address } = await kit.getAddress();
        const { name } = option;

        connectWalletStore(address, name); /* save the adddress and name's wallet 
        into your state management */
      },
    });
  };

  const disconnectWallet = async () => {
    await kit.disconnect();
    disconnectWalletStore(); /* remove the adddress and name's wallet 
    of your state management */
  };

  const handleConnect = async () => {
    try {
      await connectWallet();
    } catch (error) {
      console.error("Error connecting wallet:", error);
    }
  };

  const handleDisconnect = async () => {
    try {
      if (disconnectWallet) {
        await disconnectWallet();
      }
    } catch (error) {
      console.error("Error disconnecting wallet:", error);
    }
  };

  return {
    connectWallet,
    disconnectWallet,
    handleConnect,
    handleDisconnect,
  };
};

Integration TW API

Basic Flow

Entities Typescript

export type MilestoneStatus = "" | ""; // You can set the necessary statuses

export type Milestone = {
  description: string;
  status?: MilestoneStatus;
  approved_flag?: boolean;
};

export interface Trustline {
  name: string;
  trustline: string;
  trustlineDecimals: number;
}

export type RolesInEscrow =
  | "issuer"
  | "approver"
  | "disputeResolver"
  | "serviceProvider"
  | "releaseSigner"
  | "platformAddress"
  | "reciever";

export interface BalanceItem {
  address: string;
  balance: number;
}

export interface Escrow {
  id: string;
  title: string;
  description: string;
  createdAt: CreatedAt;
  updatedAt: UpdatedAt;
  contractId?: string;
  balance?: string;
  trustline?: Trustline;
  milestones: Milestone[];
  serviceProvider: string;
  engagementId: string;
  disputeResolver: string;
  amount: string;
  platformAddress: string;
  platformFee: string;
  approver: string;
  releaseSigner: string;
  user: string;
  issuer: string;
  disputeFlag?: boolean;
  releaseFlag?: boolean;
  resolvedFlag?: boolean;
  approverFunds?: string;
  serviceProviderFunds?: string;
  receiver?: string;
  receiverMemo?: number;
  disputeStartedBy?: string;
}

// Payloads to each Endpoint
export type FundEscrowPayload = Pick<Escrow, "amount" | "contractId"> & {
  signer: string;
};

export type DistributeEscrowEarningsEscrowPayload = Pick<Escrow, "contractId"> &
  Partial<Pick<Escrow, "serviceProvider" | "releaseSigner">> & {
    signer: string;
  };

export type EscrowPayload = Omit<
  Escrow,
  "user" | "createdAt" | "updatedAt" | "id" | "trustline"
>;

export type ChangeMilestoneStatusPayload = {
  contractId?: string;
  milestoneIndex: string;
  newStatus: MilestoneStatus;
  serviceProvider?: string;
};

export type ChangeMilestoneFlagPayload = Omit<
  ChangeMilestoneStatusPayload,
  "serviceProvider" | "newStatus"
> & {
  approver?: string;
  newFlag: boolean;
};

export type StartDisputePayload = Pick<Escrow, "contractId"> & {
  signer: string;
};

export type ResolveDisputePayload = Pick<Escrow, "contractId"> &
  Partial<Pick<Escrow, "disputeResolver">> & {
    approverFunds: string;
    serviceProviderFunds: string;
  };

export type EditMilestonesPayload = {
  contractId: string;
  escrow: EscrowPayload;
  signer: string;
};

Services - Endpoints

Flow that must always be executed at each Endpoint except Get Balances

1. Initialize Escrow

1. Fund Escrow

1. Get Multiple Escrow Balance

1. Update Escrow

1. Change Milestone Status

1. Change Milestone Flag

1. Distribute Escrow Earnings

1. Change Dispute Flag

1. Resolve Dispute

Best Use Cases

Trustless Work provides a flexible Escrow-as-a-Service platform that can be applied across many different use cases.

Introduction

The purpose of this documentation is to guide users through the process of utilizing the Escrow system effectively. By understanding its functionalities and endpoints, users can ensure that their transactions are handled with precision and security. This guide will cover the essentials, from initialization to finalizing transactions, enabling a seamless experience for all parties involved.

Escrow's Endpoints Overview

When using the escrow's endpoints, users can seamlessly manage escrows. Here's a breakdown of the functionalities and how to utilize them effectively:

• Fund Escrow: The Fund Escrow endpoint allows users to deposit funds into an escrow account. This process initiates the secure holding of funds until the transaction conditions are fulfilled. Users must specify the source account from which the funds will be withdrawn and the escrow account that will receive the funds.

• Get Escrow by Engagement ID: This endpoint retrieves detailed information about a specific escrow transaction based on its engagement ID.

• Resolve Dispute: This endpoint facilitates the resolution of conflicts that may arise during the escrow process. Users engaged in an escrow transaction can use this feature to communicate issues and seek mediation for a fair resolution.

• Change Milestone Flag (Approve): The Change Milestone Flag endpoint allows users to set specific milestones within an escrow transaction as approved.

• Change Milestone Status (Complete): The Change Milestone Status endpoint enables users to mark specific milestones within an escrow transaction as complete.

• Change Dispute Flag: Start a dispute in the escrow.

• Distribute Escrow Funds: Allows users to finalize their escrow transactions once all milestones and conditions have been met.

These endpoints ensure secure transactions by leveraging Stellar's infrastructure, guaranteeing transparency and reliability.

Escrow:

Milestone:

Escrow flow:

Headers

Milestone

Open API

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:

Headers

Open API

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:

Headers

Open API

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 () => {

    const data = await http.get(
      "/escrow/get-escrow-by-contract-id",
      {
        // body requested for the endpoint
      },
    ); 
  
    return data;
}

Headers

Open API

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:

Headers

Open API

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.post(
      "/escrow/resolving-disputes",
      {
        // 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;
}

Headers

Open API

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.post(
      "/escrow/distribute-escrow-earnings",
      {
        // 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;
}

Headers

Open API

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.post(
      "/escrow/change-milestone-approved-flag",
      {
        // 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;
}

Headers

Open API

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();

    // Execute the endpoint
    const response = await http.post(
      "/escrow/change-dispute-flag",
      {
        // 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;
}