This section provides a list of the key tools you’ll need to effectively interact with Trustless Work, from setting up wallets to testing transactions. Whether you’re building on the testnet or deploying to production, these resources will get you started.

1. Wallets

To interact with Trustless Work and the Stellar blockchain, you’ll need a wallet for sending, receiving, and managing assets like USDC.

• Albedo Wallet A browser extension for secure key management and transactions. Get Albedo

• Freighter Wallet A Stellar wallet browser extension built for developers. Get Freighter

• Lobstr Wallet A user-friendly wallet for managing Stellar assets. Ideal for non-technical users. Get Lobstr

2. Testnet Faucets: Funding Development Accounts

Testing on the Trustless Work platform requires test XLM and USDC for transaction fees and escrow functionality.

• Stellar Testnet Faucet Get test XLM to cover transaction fees on the Stellar testnet.

• Circle USDC Testnet Faucet Receive testnet USDC to simulate real-world escrow scenarios.

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:

1. 🤔 The Problem: Learn about the challenges that inspired Trustless Work, rooted in firsthand experience with outdated payment models.

2. 👾 The Team Comes Together: Meet the passionate team of innovators who made this vision possible.

3. 💡 The Solution: Explore the foundation of Trustless Work—a smarter, faster, and trustless escrow solution.

4. 🏆 Key Milestones: Relive the pivotal moments, from hackathons to accelerator programs, that shaped our growth.

5. 🚀 Current Programs: Dive into the exciting initiatives and collaborations driving our current success.

6. 🛠️ Vertical Development: See how our technology is powering specialized solutions for industries like real estate, agriculture, and more.

7. 🌎 Spotlight: Kindify: Discover Kindify, a standout use case transforming social impact crowdfunding.

8. 🔮 Future Vision: Get a glimpse into where Trustless Work is headed and our aspirations for the future.

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!

Before you get started with Trustless Work’s you need the following:

To sign transactions, you will need 1 (or more) Stellar wallets. Learn more here

To fund testnet escrows you will also need testnet XLM and testnet USDC. Learn more here.

Step 1: Sign Up

• Log in with your Stellar wallet on TW dApp: dapp.trustlesswork.com

• Create your account at Trustless Work to access your API key.

• Choose between testnet for experimentation or mainnet for production use.

Step 2: Set Up Your Environment (for devs)

• Familiarize yourself with API Documentation.

• Use the SDKs or sample code provided in your preferred language.

Step 3: Create Your First Escrow

• You will need the escrow details (parties addresses, roles, info) before creating your first escrow. Learn more here

• Initiate a smart escrow contract with minimal setup.

Step 4: Test and Iterate

• Use our testnet environment to experiment safely.

• Debug using the detailed responses and error codes in our API Reference.

Understanding the core principles of Trustless Work is key to unlocking its full potential. This section explains what makes Trustless Work unique, how it works, and why it’s essential for modern digital economies.

What is Escrow?

Escrow is a neutral way to hold funds while specific conditions are met. Think of it as a secure envelope:

1. Funds are deposited: Money is placed in a trusted location.

2. Conditions are met: The agreed-upon tasks or milestones are achieved.

3. Funds are released: The money is sent to the intended recipient.

In traditional setups, escrow is managed by centralized entities like banks or lawyers. Trustless Work replaces these intermediaries with blockchain-powered smart contracts.

Why Use Blockchain for Escrows?

Traditional escrows come with inefficiencies, such as high fees, slow processing times, and limited transparency. Blockchain technology eliminates these challenges by offering:

• Decentralization: No single point of control or failure.

• Transparency: Every transaction is verifiable on the blockchain.

• Immutability: Smart contracts ensure funds are handled exactly as programmed.

Trustless Work builds on Stellar’s Soroban smart contract platform, combining the low costs and high speed of Stellar with the power of decentralized automation.

How Trustless Work Escrows Operate

1. Setup

• A smart escrow is configured using Trustless Work’s API.

• Key parameters include:

  • Amount: The value being held.

  • Roles: Learn more about roles here

  • Milestones: Rules for releasing funds.

2. Funding

• The payer deposits funds into the escrow.

• Funds are securely held on the blockchain, ensuring they cannot be tampered with.

3. Milestone Updates

• The service provider updates the escrow status.

4. Approval or Dispute

• The client approves the release of funds.

• In case of disputes, the escrow holds the funds until the issue is resolved by Dispute Resolver.

5. Release

• Once conditions are met, funds are released to the recipient.

• A small fee (0.3%) is deducted as a commission for Trustless Work.

• Extra Fee can be configured for the platform.

Key Features of Trustless Work Escrows

• Customizable: Configure escrows for a variety of use cases, from marketplaces to crowdfunding.

• Cost-Efficient: Leverage Stellar’s low transaction fees.

• API-First: Seamless integration into your platform using simple API calls.

• Open-Source Templates: Accelerate implementation with ready-to-use configurations.

Traditional vs. Trustless Escrows

Benefits of Trustless Work

• For Developers: Simplify payment workflows with an API-driven approach.

• For Businesses: Build trust and reduce fraud in transactions.

• For Innovators: Unlock new business models using blockchain escrows.

Next Steps

• Dive deeper in our Technolgy Overview.

• Explore API Reference to see how to implement these concepts in your platform.

• Learn about Use Cases.

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 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.

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.

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.

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.

How to Navigate This Documentation

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

1. Getting Started A quick-start guide to help you onboard with Trustless Work. Perfect for developers and businesses looking to explore the platform.

2. API Reference Complete technical documentation for developers, including endpoints, code examples, and troubleshooting tips.

3. Use Cases Discover how Trustless Work transforms industries, from marketplaces to crowdfunding.

4. Technology Overview Dive into the technical architecture, featuring Stellar, Soroban, and smart escrows.

5. Community and Roadmap Join our growing ecosystem, explore our open-source projects, and see where we’re headed next.

Next Steps

• Get Started: Quick Start Guide Begin integrating Trustless Work today.

• Learn More: About Trustless Work Explore our mission, vision, and journey so far.

• Contact Us: Support Need help? Reach out to our team for assistance.

Getting Started with Trustless Work

Welcome to the future of secure, trustless transactions! This guide will help you start using Trustless Work, whether you’re a developer integrating our API or a business seeking to scale with blockchain-powered escrows.

1. Understand the Basics

Before diving into the technical details, take a moment to understand how Trustless Work can revolutionize your payment workflows:

• What is Trustless Work? A blockchain-based Escrow-as-a-Service platform that secures payments and ensures transparency for all parties involved.

• Why Use Trustless Work? Save time, reduce costs, and eliminate reliance on intermediaries.

Learn more about

2. Design your escrow lifecycle

Before you Deploy your first escrow, you need to know which parties (addresses) will play which roles. You can learn more about escrow design .

Explore for inspiration.

3. Deploy and test in our dApp

We made a dApp to assist you on deploying escrows. You can find it .

To sign transactions, you will need 1 (or more) Stellar wallets. Learn more here

3. Start building!

Integrating Trustless Work into your platform is simple:

• Work with your development team to integrate Trustless Work’s API.

• Use our open-source templates for faster implementation.

4. Contribute!

Next Steps

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.

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.

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

Alberto joined Dojo Coding, a dynamic and vibrant community of web3 developers from Latin America. Focused on open-source innovation, collaboration, and solving meaningful problems with blockchain technology, Dojo Coding plays a pivotal role in fostering talent and building impactful projects. Join here

🌟 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! 🥳

Alberto Chaves Armando Zuñiga Joel Vargas Caleb Loría

The First Call

On our first call, Alberto pitched the initial idea for Trustless Work and shared an exciting opportunity: the application for the Astro Hacker House program by Draper University. The team immediately recognized the potential and decided to target this program as their first milestone.

🎯 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! 🚀

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

Trustless Work is dedicated to making Smart Escrows accessible for all platforms and developers. To achieve this, we provide open-source templates and developer tools that streamline the integration of escrows—helping you go from concept to implementation without unnecessary complexity.

What Are Open-Source Templates & Developer Tools?

Our open-source templates are ready-made solutions that allow developers to quickly implement escrow workflows. These templates cover a variety of common use cases, enabling teams to integrate Smart Escrows with minimal effort, while still retaining the flexibility to customize as needed.

The developer tools further enhance this process by providing a suite of resources that make it easy to integrate, test, and deploy Smart Escrows effectively.

Key Features

1. Ready-Made Escrow Workflows 🏗️

   • Templates are provided for milestone payments, rental security deposits, crowdfunding, and more.

   • Each template comes with pre-configured settings, allowing you to understand how Smart Escrows can work in your scenario and quickly adapt the code to fit your platform.

2. Speed and Efficiency 🚀

   • Fast Implementation: The templates are designed to be as plug-and-play as possible, allowing you to get started with Smart Escrows without writing complex smart contract logic yourself.

   • Pre-Built Workflows: Each template includes the necessary business logic for the escrow flow, meaning less time spent on development and more time focusing on your unique value proposition.

3. Customizable and Adaptable ⚙️

   • While our templates provide out-of-the-box workflows, they are also highly customizable. You can easily adjust conditions, roles, and milestones to better fit your platform’s needs.

   • By being open-source, developers can modify these templates however they wish—adapting the workflows to match specific business logic or unique requirements.

How Templates & Tools Fit Into Trustless Work's Ecosystem

• Integrate with the Trustless Work API: All templates are designed to work seamlessly with the Trustless Work API, enabling you to set up, fund, and manage escrows with ease.

• Utilize Smart Contracts: Templates leverage our open-source smart contracts on Soroban, ensuring that all escrow activities are transparent, secure, and executed in a trustless manner.

• For Developers of All Levels: Whether you're new to blockchain or an experienced developer, these tools abstract away the blockchain complexities, allowing you to focus on integrating features that create value for your users.

Examples of Open-Source Templates

1. Milestone-Based Payments: A template designed for freelancer and project-based platforms, allowing you to hold funds and release them upon milestone completions.

2. Security Deposit Escrows: Ideal for rental platforms, this template allows for secure holding of deposits, ensuring that funds are only released when both parties agree.

3. Crowdfunding Campaigns: A template for managing funds raised in crowdfunding, holding contributions securely until funding goals are met or milestones are reached.

These templates reduce integration friction, enabling developers to take advantage of Smart Escrows without having to build the entire logic from scratch.

Trustless Work is built on a foundation of open-source escrow smart contracts, providing a trustless, transparent, and programmable backbone for handling funds. These contracts are deployed on Soroban, Stellar's smart contract platform, and are designed to ensure that escrows are executed securely, fairly, and without intermediaries.

What Are Open-Source Escrow Smart Contracts?

Escrow Smart Contracts are programmable agreements that securely manage and release funds based on predefined actions. They replace the traditional need for a custodian, like a bank, and allow participants to play an active role in the Escrow Lifecycle.

Key Features

1. Trustless Transactions 🌐

   • The smart contracts manage funds transparently. Once deployed there are only specific flows the escrow can take. Escrow status can be updated only by explicit participants, addresess that are assigned roles, during the deployment stage.

2. Transparency and Security 🔒

   • As open-source contracts, they are fully auditable by anyone. Participants can review every line of code to understand exactly how their funds will be handled.

   • Deployed on Soroban (Stellar's blockchain for smart contracts), they benefit from blockchain's inherent security—making them tamper-proof and resistant to unauthorized changes.

3. Flexible and Programmable Conditions ⚙️

   • The contracts can be configured to suit a wide variety of use cases. Conditions such as milestone completions, multi-party sign-offs, or specific timelines can all be encoded in the smart contracts.

   • Whether it’s milestone payments for freelancers, security deposits for rentals, or crowdfunding releases, our smart contracts provide flexible configuration to fit your needs.

Benefits of Using Our Smart Contracts

• No Intermediaries Required: Traditional escrows depend on trusted third parties, which come with delays and fees. Our smart contracts act as the neutral party, eliminating the costs and delays associated with human involvement.

• Global and Accessible: Leveraging the Stellar Network, our escrow contracts support fast and low-cost transactions in assets like USDC, making them accessible across borders with minimal fees compared to traditional systems.

• Fully Open Source: By being open-source, developers and users can review and contribute to the code. This fosters community trust and allows for continuous improvements by developers worldwide.

How They Fit Into Trustless Work's Ecosystem

• Trustless Work API Integration: The Trustless Work API interacts directly with these smart contracts, abstracting away blockchain complexities and allowing developers to integrate escrows without needing deep blockchain knowledge.

• Open-Source Templates: To make it even easier, we provide open-source templates that work with these contracts to speed up the implementation process for common use cases—helping you get started quickly with minimal coding.

Why Soroban?

• Built on Stellar: Our smart contracts are deployed using Soroban, Stellar’s innovative smart contract platform that offers scalability, low fees, and high security.

• Modern and Efficient: Soroban uses Rust, a modern language known for its security and efficiency, ensuring that our contracts are robust, fast, and secure—crucial attributes for handling financial transactions.

See It in Action 🚀

Interested in seeing how our Open-Source Escrow Smart Contracts can fit into your platform?

• Check Out Our Templates to find ready-made examples that integrate seamlessly with our contracts.

• For more in-depth technical details, explore the contracts directly on GitHub and understand how you can customize them to suit your use cases.

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

• GitHub:

• LinkedIn:

Joel Vargas

Role: Frontend Developer

• GitHub:

• Telegram:

Armando Murillo

Role: Full Stack Developer

• GitHub:

• Telegram:

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

Trustless Work provides an Escrow-as-a-Service (EaaS) platform that makes building Smart Escrows as simple and accessible as possible. By leveraging open-source tools and a developer-friendly API, we remove the barriers traditionally associated with escrows—making them secure, transparent, and easy to integrate.

How It All Works Together 🏗️

The diagram above illustrates the architecture of Trustless Work, showing how each component interacts to make Smart Escrows possible.

• Trustless Work API provides an interface for developers and platforms to easily initialize, configure, fund, and manage escrows. With simple API calls, integration becomes intuitive and hassle-free.

• Stellar Network: Trustless Work is built on the Stellar Network. Escrows work by assigning roles to addresses, these addresses are on the Stellar Network. Stellar wallets are required to sign transaccions and send/receive funds.

• Open-Source Escrow Smart Contracts form the trustless foundation of our system. Deployed on Soroban, Stellar’s smart contract platform, these contracts ensure that funds are securely managed and only released once conditions are met—offering transparency and tamper-proof execution.

• Open-Source Templates & Developer Tools are designed to assist developers in integrating Smart Escrows quickly. These templates are customizable, helping you transform your vision into functionality without the friction of building everything from scratch.

Together, these components allow developers to focus on building great products without the worry of complex payment flows or third-party dependencies.

Trustless Work API 🔌

Our Trustless Work API is designed to make integrating Smart Escrows into your platform as seamless as possible. You can use the API to:

• Initialize, Fund, and Manage Escrows: Easily set up an escrow contract, define conditions, manage its state, and approve fund releases—all in a developer-friendly way.

• View Escrow Data: The API has functions optimized for Escrow exploration and audit.

Open-Source Escrow Smart Contracts 🔗

At the core of Trustless Work are open-source escrow smart contracts that are secure, trustless, and deployed on Soroban. These smart contracts:

• Hold and Release Funds: Ensure that funds are securely held until all predefined conditions are met.

• Offer Transparency: Being open-source means anyone can audit the contracts, providing complete transparency to all participants.

Open-Source Templates & Developer Tools 📂

To make integration even easier, we provide open-source templates and developer tools. These templates help developers quickly implement:

• Common Escrow Workflows: From milestone payments to security deposits and crowdfunding, these templates offer easy-to-adapt solutions.

• Customizable Features: Modify templates to fit your unique needs and seamlessly integrate Smart Escrows into your applications.

With Trustless Work, integrating trustless escrow solutions has never been easier. Dive in and start building today!

The OD Hack #10 campaign was a significant success, bringing new contributors and advancing our product.

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.

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.

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.

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!

1. Go to the Trustless Work Dapp

Open your web browser and navigate to: ➡️ dapp.trustlesswork.com

You should see the Welcome Screen with the Trustless Work logo and an introduction to the platform.

2. Connect Your Stellar Wallet

To interact with the Dapp, you need to connect a Stellar-compatible wallet. Click on the "Connect" button in the top right corner.

A pop-up will appear, showing the available wallet options.

➡️ Select your preferred wallet and follow the prompts to authorize the connection.

3. Login Confirmation

Once connected, you will be redirected to the Dashboard, where you can manage your escrows. ✔ Your wallet address will be displayed in the sidebar. ✔ You are now ready to interact with the Trustless Work escrow system! 🚀

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.

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!

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:

Initiation phase

Funding phase

Milestone Status Updates

Approval phase

Release phase

Dispute Resolution phase

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

To understand how roles interact accross the lifecycle, visit the Roles in Trustless Work

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!

https://link.excalidraw.com/readonly/uT289bCBJUCpKK0sTxYr

https://www.figma.com/community/file/1456840320155816764/trustless-design-framework

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

Now that the milestone has been completed by the service provider, the approver needs to verify and approve it.

1. Switch to the "Approver" tab

• In the escrows section, navigate to the Approver tab.

• You will only see escrows where your logged-in wallet is assigned the Approver role.

2. Click on the escrow to open the modal

• Select the escrow where the milestone has been completed.

• The escrow should now show 100% Completed in the milestone progress bar.

3. Approve the milestone

• You should now see a blue "Approve" button.

• Click "Approve" to proceed with milestone approval.

4. Sign the transaction

• Just like previous actions, a transaction request will appear in your wallet (Freighter).

• Review the details and sign the transaction.

5. Escrow status update

• After signing, the milestone should now show as "Approved".

• The funds are still in escrow but are now ready for release.

Once you approve the milestone, we move on to the final step: releasing the escrow funds!

In the case of the single release escrows: all milestones must be approved for the release to be enabled. In the case of multi-release escrows: Approval at the milestone level is required to release a Milestone.

1. Access the Profile Settings

• Click on your wallet address at the bottom left of the screen.

• A menu will appear where you can:

  • Copy your Stellar address.

  • Disconnect your wallet.

  • Access settings → Click on this to proceed.

2. Completing Your Profile

• In the Profile section, you can: ✅ Add an image for easier identification. ✅ Fill in your name, email, country, and phone number. ✅ Specify your Use Case (Required for API key requests).

🔹 The "Use Case" field is mandatory for API key requests but not for general Dapp usage.

➡️ Click "Update Profile" to save changes.

3. Customizing Appearance and Preferences

• Appearance: Choose between Light Mode or Dark Mode.

• Preferences:

  • Save Escrows → Enabled by default.

  • If disabled, your escrows won’t be indexed, and you must manually track their IDs.

4. Requesting an API Key (For Developers Using the API)

• Navigate to the API Keys tab.

• Click "Request an API Key" to generate one.

• Once created, you can view your keys under "Show API Keys".

📌 You don’t need an API key to use the Dapp, only if you plan to interact programmatically via the API.

Remember that the profile property Use Case must be filled to be able to ask for an API Key. This is our way of understanding what are you using this for, so please help us out!

That that you have everything set up, let's create some Escrows!

1. Navigate to the Escrows Section

• Click on "Escrows" in the sidebar.

• This will take you to the "Initiated Escrows" tab.

• Escrow tabs are organized by role (Approver, Service Provider, Dispute Resolver, etc.).

  • If you don’t see any escrows, it means your wallet hasn't been assigned a role yet.

2. Click "Create Escrow"

• This starts the Escrow Initialization Flow.

3. Fill in Escrow Details

To configure an escrow, you need to define roles and key parameters:

✅ Title → Name your escrow. ✅ Description → A summary of the contract. ✅ Approver → Who approves milestone completion. ✅ Service Provider → The person/entity delivering the service/product. ✅ Engagement → A unique ID (e.g., invoice, contract, project ID). ✅ Platform Address → The platform receiving fees and modifying milestones. ✅ Amount → The total amount locked in escrow. ✅ Release Signer → The entity that releases funds. ✅ Dispute Resolver → Handles disputes if needed. ✅ Milestones → Conditions that must be completed & approved.

🔹 Make sure you know the wallet addresses that will play each role before proceeding!

➡️ Click "Initialize Escrow" once all details are set.

4. Sign the Transaction

• Your wallet (Freighter, Albedo, etc.) will prompt you to confirm and sign the transaction.

• This deploys the escrow contract on Stellar Testnet.

• Once signed, the escrow is now active.

5. Escrow Successfully Initialized!

• You will receive a confirmation pop-up with:

  • The Escrow ID.

  • A link to view the escrow on Stellar Explorer.

✅ Your escrow will now be visible in the "Initiated Escrows" tab! If you used the same wallet for all roles, it will appear across all tabs.

🚀 Next Steps:

🔹 Try creating another escrow with multiple addresses by opening a Testnet wallet in incognito mode! 🔹 Proceed to the Funding Phase – Learn how to deposit funds into your escrow.

This step is done by the Service Provider once they have successfully delivered the product or service.

📌 Why is this step important?

• This confirms that the work has been completed.

• The Approver will later check and approve this milestone before funds are released.

1. Go to the "Service Provider" tab

• In the escrows section, navigate to the Service Provider tab.

• This tab will only show escrows where your logged-in wallet is assigned as the Service Provider.

2. Open the escrow modal

• Click on the escrow you want to update.

• This will open a modal displaying the escrow details, including:

  • Escrow title & description

  • Roles assigned to different addresses

  • Current milestone status

3. Click "Complete" on the milestone

• You will see a blue button labeled "Complete" next to the milestone.

• Click "Complete" to proceed.

4. Sign the transaction

• A Freighter wallet transaction request will pop up.

• This request confirms that you are marking the milestone as completed.

• Click "Sign" to approve the transaction.

5. Milestone status updates

• Once the transaction is signed, the milestone will be marked as "Completed".

• The progress bar in the escrow modal will update, showing that this step is done.

🎉 Success! The milestone is now marked as completed. The next step will be approving the milestone, which is done by the Approver.

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.

Once an escrow is initialized, the next step is to fund it. Funding locks the transaction amount in the escrow contract until conditions are met.

1. Open the Escrow Modal

• Navigate to the Escrows section.

• Click on the escrow you want to fund.

• A modal window will appear with detailed information:

  • Escrow Title & Description

  • Assigned Roles (Approver, Service Provider, etc.)

  • Milestones & Status

  • Escrow ID (Top right)

📌 The Escrow ID is crucial for funding.

2. Three Ways to Fund an Escrow

Option 1: Send Funds Directly to the Escrow ID

• Copy the Escrow ID from the modal.

• Open your Stellar wallet.

• Send USDC or XLM to the Escrow ID just like you would send funds to any Stellar address.

🔹 Anyone with a Stellar wallet can fund the escrow using this method.

Option 2: Use the QR Code

• Click on "Show QR Address".

• Scan the QR Code with a mobile wallet app.

• The wallet will automatically recognize the Escrow ID and prompt a transaction.

Option 3: Use the "Fund Escrow" Button (Recommended)

• Click "Fund Escrow" in the modal.

• A new dialog will appear asking how much to deposit.

• Enter the desired amount and click "Fund Escrow".

• Your wallet (Freighter, Albedo, etc.) will pop up for transaction review & signing.

• Confirm and sign the transaction.

3. Confirm Funding

After funding:

✅ The escrow balance updates. ✅ The status progresses (e.g., “Funded” or “Working”). ✅ Milestones can now be marked as completed and approved.

🚀 Next Step: Marking Milestones as Complete

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.

This step is performed by the Release Signer, who authorizes the funds to be released to the Service Provider.

Instructions to Release Payment

1. Go to the Release Signer Tab

   • Navigate to the Escrows section in the sidebar.

   • Click on the Release Signer tab to filter the escrows where your wallet is assigned as the Release Signer.

2. Select the Escrow for Payment Release

   • Find the escrow where the milestone has been approved.

   • Click on it to open the Escrow Details Modal.

• Verify Milestone Status

  • Ensure that the milestone has been completed and approved (indicated by 100% completion and approval).

  • The Release Payment button should now be active.

• Click on "Release Payment"

  • This action will initiate a blockchain transaction to release the funds.

  • A wallet transaction confirmation will appear.

• Sign the Transaction

  • A request will pop up in your Stellar wallet (e.g., Freighter).

  • Review the transaction details (fees, escrow ID, recipient, amount).

  • Click Sign to confirm and execute the payment.

• Payment Released Successfully

  • Once the transaction is confirmed, the escrow balance will update to reflect the release.

✅ Success! The funds have now been transferred to the Service Provider!

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 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.

Testnet tokens are a great way to experiment with Stellar wallets and blockchain operations without risking real assets. This guide explains how to obtain testnet tokens, their purpose, and how to use them effectively.

What Are Testnet Tokens?

Testnet tokens are virtual assets used on Stellar's test network (testnet) to:

• Test wallet setups.

• Experiment with sending and receiving payments.

• Learn Stellar operations like creating trustlines or setting up smart contracts.

Why Use Testnet Tokens?

• Risk-Free Learning: No monetary value; perfect for practice.

• Development Testing: Test your applications or smart contracts before deploying on the mainnet.

• Community Access: Many developers and testers rely on the testnet for Stellar experiments.

How to Obtain XLM Testnet Tokens

Option 1: Use the Stellar Lab Faucet

1. Go to the Stellar Laboratory:

2. Paste your Public Key into the faucet's input field.

3. Click "Request Lumens":

   • You’ll receive a transaction confirmation.

   • Check your wallet to confirm receipt of 10,000 XLM test tokens.

Option 2: Use Stellar Command-Line Interface (CLI)

1. Install the Stellar CLI:

   • Install the stellar-core or stellar-horizon command-line tool (refer to Stellar documentation).

2. Request Tokens:

   • Run the following command:
   • Replace <Your Public Key> with your Stellar wallet address.

3. Verify Balance:

   • Use the CLI or a Stellar wallet to check your testnet account balance.

How to Get Testnet USDC

1. Set the Trustline: Ensure you've established a trustline for USDC on your Stellar testnet account. Issuer: GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5

2. Visit the Circle USDC Faucet:
3. Select Stellar and Request USDC:

   • Use the dropdown menu to select "Stellar".

   • Paste your Stellar testnet address.

   • Click on "Get Tokens" to receive testnet USDC.

How to Use Testnet Tokens

1. Explore Wallet Operations

• Send tokens between test accounts.

• Experiment with memo fields, transaction fees, and multi-signature setups.

2. Learn Key Stellar Concepts

• Trustlines: Use testnet tokens to create trustlines for custom assets.

• Asset Issuance: Test issuing and trading custom assets.

• Smart Contracts: Experiment with Stellar's pre-signed transactions to simulate smart contracts.

3. Connect to Applications

• Use your testnet wallet with Stellar-based dApps like Trustless Work to test integrations.

Switching Your Wallet to Testnet

Most Stellar wallets allow you to switch between the mainnet and testnet. Here's how:

General Steps:

1. Open your wallet settings.

2. Look for the "Network" option.

3. Switch from Mainnet to Testnet.

4. Save your settings and restart the wallet if required.

Examples for Popular Wallets:

• Freighter Wallet:

  • Click on Settings > Network > Testnet.

• Rabet Wallet:

  • Select "Network" in the main menu and toggle to Testnet.

• Albedo Wallet:

  • Adjust the network via the settings or during the transaction prompt.

Important Notes

1. Testnet Tokens Have No Value:

   • These tokens are strictly for testing and cannot be transferred to the mainnet.

2. Testnet Environment Resets:

   • The Stellar testnet resets periodically, clearing all test accounts and balances.

   • Always re-create your accounts and re-fund them when the testnet resets.

3. Avoid Sharing Secret Keys:

   • Even in a test environment, keep your Secret Key secure to mimic best practices for the mainnet.

Troubleshooting & FAQs

I didn’t receive test tokens. What should I do?

• Ensure you’ve used the correct Public Key.

• Try another method (e.g., Stellar Faucet vs. Laboratory).

• Wait for a few minutes as the testnet might experience delays.

Why can’t I switch my wallet to Testnet?

• Make sure your wallet supports Stellar’s testnet.

• Check for updates or consider using a wallet that supports testnet, like Freighter or Rabet.

What happens if I lose my Secret Key?

• Without the Secret Key, you cannot access your testnet account. Treat it as you would a real wallet key.

Additional Resources

By following this guide, you can confidently explore Stellar’s testnet and test a variety of operations risk-free.

Introduction

The Trustless Work Dapp is the visual interface for interacting with the Trustless Work Escrow API. It serves as a back-office for the escrow lifecycle, allowing users, developers, and platforms to: ✅ Deploy an escrow ✅ Sign transactions ✅ Approve milestones ✅ Release funds ✅ Resolve disputes

This tutorial will guide you through the full escrow lifecycle using the Dapp UI, breaking it into structured phases for clarity.

1. Getting Started

Before using the Dapp, ensure you have the necessary prerequisites:

1.1. Stellar Wallet Setup

1.2. Getting Testnet Tokens

The Dapp currently operates on Stellar Testnet, so you’ll need:

• XLM (for transaction fees)

• USDC (to test escrow functionality)

2. Full Escrow Lifecycle in the Dapp

Core Phases of the Escrow Lifecycle

This section walks through the structured process of managing a transaction using the Dapp.

2.1. Initiation Phase

📌 Goal: Define the escrow agreement and configure its parameters.

• Select parties involved (payer, receiver, approver, etc.).

• Set milestones and funding conditions.

• Deploy the smart escrow contract.

➡️ Step-by-step guide for Initiation

2.2. Funding Phase

📌 Goal: Deposit funds into the escrow, securing the transaction.

• The payer deposits funds (USDC/XLM).

• The escrow status updates to reflect the deposit.

• The contract balance is displayed in the UI.

➡️ Step-by-step guide for Funding

2.3. Milestone Updates Phase

📌 Goal: Track progress and mark work as completed.

• The service provider updates milestone completion.

• Status changes to "Pending Approval".

➡️ Step-by-step guide for Milestone Updates

2.4. Approval Phase

📌 Goal: Approve or dispute completed milestones.

• The payer or designated approver reviews milestone progress.

• If approved, funds move to pending release.

• If disputed, the transaction enters the Dispute Resolution Phase.

➡️ Step-by-step guide for Approvals

2.5. Release Phase

📌 Goal: Finalize the escrow transaction by releasing funds.

• Upon milestone approval, funds are automatically released to the service provider.

• The escrow status updates to "Completed."

• The transaction is finalized.

➡️ Step-by-step guide for Releasing Funds

3. Alternative Phases (Special Cases)

Some transactions require additional steps:

3.1. Dispute Resolution Phase

📌 Goal: Resolve conflicts when a milestone is disputed.

• The dispute resolver evaluates the case.

• Adjustments are made based on the ruling.

• Funds are either released, partially released, or refunded.

➡️ Step-by-step guide for Dispute Resolution

4. Additional Resources

📖 Guides & Tutorials

• How to Set Up a Stellar Wallet

• How to Get Testnet Tokens

• Understanding Escrow Roles

Next Steps

Kindfy is one of the standout projects emerging from Trustless Work, demonstrating the transformative potential of blockchain-powered escrows. Focused on social aid and impact, Kindfy is building a crowdfunding platform designed to connect funders with projects that make a difference.

The Vision Behind Kindfy

Kindfy seeks to revolutionize how aid and social impact projects are funded by offering:

• 🛠️ Transparency: Leveraging Trustless Work’s escrow technology to ensure every contribution is securely held and released only when milestones are met.

• 🌱 Inclusivity: Providing an accessible platform for small and large-scale projects alike.

• 💡 Flexibility: Supporting both milestone-based and lump-sum fund releases.

Building Momentum

💼 A Pitch That Resonated Alberto successfully pitched Kindfy to representatives from USAID and other government programs, garnering strong interest in the platform’s ability to ensure accountability and transparency in funding.

🌐 Expanding Networks Outreach to foundations and NGOs in Costa Rica has begun to:

• Understand the unique challenges these organizations face in securing and managing funding.

• Explore how Kindfy can address these pain points and serve as an exemplary application of Trustless Work’s infrastructure.

Why Kindify Matters

Kindfy is not just a product—it’s a proof of concept for how blockchain technology can enable social good. By leveraging Trustless Work, Kindfy demonstrates how secure and transparent escrows can empower:

• Donors: Ensuring their contributions are used as intended.

• Project Leaders: Providing a trusted platform to attract more funding.

• Communities: Driving impact through trust and accountability.

A Bright Future

Kindfy is poised to become a flagship example of what’s possible with Trustless Work, paving the way for more social impact projects to embrace blockchain-powered escrows.

Whether you’re a foundation, an NGO, or an individual looking to fund meaningful initiatives, Kindfy represents the next evolution in trust-based crowdfunding.

Trustless Work provides a flexible Escrow-as-a-Service platform that can be applied across many different use cases. Our Smart Escrow Technology is adaptable, with configurations and fund flows that can be adjusted to fit the needs of different industries and applications.

Explore the Possibilities 🚀

We’re currently exploring a range of exciting use cases that can benefit from Smart Escrows:

• Security Deposits 🏠: Ideal for rental platforms—securely hold deposits until all parties agree conditions are met.

• Marketplaces 🛒: Protect buyers and sellers by holding funds until delivery is confirmed.

• Crowdfunding 🤝: Hold contributions securely, releasing them only when funding milestones are achieved.

• Revenue Share 💸: Automate the distribution of revenue among multiple stakeholders based on predefined conditions.

• Trade Finance 🌐: Facilitate cross-border transactions, holding funds securely until delivery conditions are fulfilled.

These use cases just scratch the surface of what’s possible with Trustless Work. Our technology is built to be adaptable, making it suitable for any scenario where trust, security, and transparent fund management are required.

Interested in Exploring More? 🤔

Have an idea for how Smart Escrows could work for your industry? We’re always looking for new and innovative ways to apply Trustless Work's technology. Whether you have a use case in mind or need support in figuring out how to leverage escrows for your platform—we’d love to hear from you!

➡️ Reach out to us and let’s build something amazing together.

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.

Version

We actually 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 , please read this section.

Dapp:

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.

Roles: roles are assigned to parties, represented by Stellar public addresses. Depending on each party's role, they will be allowed to sign and update the escrow status and flags. Learn more about roles here

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.

• We are using the Stellar Wallet Kit library.

• We are using axios library with a pre-configuration with the Trustless Work URL and the Bearer token.

• You should connect to your favorite wallet, if you are in development, Freighter is recommended.

• You'll be able to see the Escrow entity in the page below.

Steps

1. Initialize Escrow

The escrow contract must be deployed, which in turn initializes the escrow with its metadata.

Payload Type:

Execute Endpoint:

References:

1. Fund Escrow

Each escrow must be funded before the release funds or resolve dispute. It's important to clarify that you can fund the escrow in any moment, but just for this case, we'll fund it in the beginning.

Payload Type:

Execute Endpoint:

References:

1. Edit Milestones

You can edit the milestones in any moment, but just the Platform Entity will be able to do it. Only the pending milestones will be editable.

Payload Type:

Execute Endpoint:

References:

ADD REFERENCES

1. Change Milestone Status

With this endpoint you'll change the status of the milestones, but just the Service Provider will be able to do it.

Payload Type:

Execute Endpoint:

References:

1. Change Milestone Flag

With this endpoint you'll approve the milestones, but just the Approver will be able to do it.

Payload Type:

Execute Endpoint:

References:

1. Change Dispute Flag

In any moment, the approver or service provider can start a dispute. This cannot executed without funds in the escrow's balance.

Payload Type:

Execute Endpoint:

References:

1. Distribute Escrow Earnings

When the escrow is ready to be released, you can do it with this endpoint. Only the release signer can do it.

Payload Type:

Execute Endpoint:

References:

1. Resolve Dispute

When the escrow is in dispute, you can resolve it with this endpoint. Only the dispute resolver can do it.

Payload Type:

Execute Endpoint:

References:

All endpoints related to escrow management return the transaction unsigned. This is done by means of a string returned in XDR (External Data Representation) format, which is a format that stellar uses to encode transactions. This string is what you should use to sign the transaction with the wallet of your choice. After being signed it will return the transaction signed in the same way by means of a string in XDR format.

• This string is the one that must be sent to the next endpoint for the transaction to be sent to the Stellar network:

That's all, thanks.

POST deployer/invoke-deployer-contract

Headers

Body params:

Milestone

Example:

Possible Responses

Use example (Using axios):

Allows flexible USDC amounts to be transferred to the escrow contract.

POST escrow/fund-escrow

Headers

Body

Example of Request Body:

Possible Responses

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 (Using axios):

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.

• Get Multiple Escrow Balance: This endpoint allows users to retrieve the balances of multiple escrow accounts simultaneously.

• 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.

The first step in register in our dApp, in order to be able to have an user and get our API Key.

In order to get register, you have to connect with your favorite wallet. To complete this step, see this section:

Also, you can see this video:

Then, when you are 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".

GET escrow/get-escrow-by-contract-id

Headers

Params

Example of Request Params:

Possible Responses

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.