Trustless Work
  • Welcome
    • Why Escrows Matter
    • 🛤️Our Journey so Far
      • 🤔The Problem: Origins of Trustless Work
      • 👾The team comes together
      • 💡The Solution: Escrows
      • 🏆Key Milestones
        • 🌠DraperU Stellar Astro Hacker House: A Pivotal Moment
        • Launching the API V1 at ETH Pura Vida Hackathon
      • 🚀Current Programs
        • 🌟DraperU Embark Program
        • 💻OD Hack Campaigns
      • 🛠️Vertical Development
      • 🔮Future Vision
  • 📌Start Here
    • ☀️About Trustless Work
      • Vision and Mission
      • Team
  • ⚒️Understanding Smart Escrows
    • 🥸Smart Escrow Design
      • What does a Smart Escrow "look like"?
      • Roles in Trustless Work
      • Escrow Lifecycle
        • Initiation Phase
        • Funding Phase
        • Complete phase
        • Approval phase
        • Release phase
        • Dispute Resolution
    • 💵USDC: The Stablecoin Powering Trustless Work
    • 🌟Stellar & Soroban: The Backbone of Trustless Work
  • 💻Developer Resources
    • Introduction
    • Schema
    • Types
      • Basic
      • Entities
      • Payloads
      • Responses
      • Errors
    • Quickstart
      • Integration Demo Project
        • Getting Started
        • Configuration
        • Context API
        • Wallet Setup
        • Trustlines
        • Services
        • Helpers
        • Error Handling
        • Forms
          • Initialize Escrow
          • Fund Escrow
          • Get Escrow
          • Get Multiple Escrow Balances
          • Resolve Dispute
          • Change Milestone Status
          • Change Milestone Flag
          • Change Dispute Flag
          • Release Funds
          • Update Escrow
        • UI Components
          • Pages
          • Cards
          • Tabs
          • Utils
    • Authentication
      • Request Api Key
    • API Reference
      • Deploy
        • Initialize Escrow
      • Escrows
        • Fund Escrow
        • Get Escrow
        • Resolve Dispute
        • Change Milestone Status
        • Change Milestone Flag
        • Start Dispute
        • Release Funds
        • Update Escorw
      • Helpers
        • Set Trustline
        • Send Transaction
        • Get Multiple Escrow Balance
    • React Library
      • Getting Started
      • useSendTransaction
      • useGetEscrow
      • useGetMultipleEscrowBalances
      • useInitializeEscrow
      • useUpdateEscrow
      • useFundEscrow
      • useChangeMilestoneApprovedFlag
      • useChangeMilestoneStatus
      • useReleaseFunds
      • useStartDispute
      • useResolveDispute
    • 🚀Smart Escrow API
    • 🧰Essential Tools for Developers
      • Stellar Wallets
        • Freighter Wallet
        • Albedo Wallet
        • xBull Wallet
        • Rabet Wallet
        • Lobstr Wallet
        • Hana Wallet
        • Additional Resources
        • Troubleshooting & FAQs
      • How to Get Testnet Tokens
  • 🌍Use Cases by Industry
    • Marketplaces & E-commerce
    • Grants, Bounties, and Hackathons
    • P2P Exchanges and OTC Desks
    • Security Deposits
    • Milestone-based Freelance & Contract Work
    • Crowdfunding & Pre-orders
    • DAO Treasury & Working Group Budgets
    • Education & Online Courses
    • Subscription + Performance-based Retainers
  • 🤖Using the dApp
    • Step 1: Accessing the Trustless Work Dapp and Logging In
    • Step 2: Creating a Profile and Requesting an API Key
    • Step 3: Creating an Escrow
    • Step 4: Funding an Escrow
    • Step 5: Marking a Milestone as Done ✅
    • Step 6: Approving the Milestone
    • Step 7: Releasing the Payment
    • Resolving Disputes
  • 🏴‍☠️Community
    • 🌎Spotlight: Kindfi
    • 🛣️Roadmap: The Journey Ahead
    • Contributor's Guide
    • 📂Open-Source Templates & Developer Tools
  • ✒️Background & Theory
    • 📘Core Concepts & Escrow Glossary
    • 🎒Historical Context
      • 📜Escrow History:
        • 🗿Ancient to Colonial Era
        • 🏦Banking Era (19th - 20th Century)
        • 💻The Digital Era and Online Escrow
      • ⛓️Blockchain Era: Smart Escrows
  • Links
    • ⚒️Trustless Work dApp
    • 🌐Trustless Work Website
    • 📣Telegram Chat
    • 💎Only Dust Profile
    • 👩‍💻Swagger for API
    • 📜Github
  • 📢Appendices
    • Contact and Support
    • Notion for Startups
    • Meru
Powered by GitBook
LogoLogo

Links

  • Website
On this page
  • Introduction
  • 1. Getting Started
  • 2. Full Escrow Lifecycle in the Dapp
  • 3. Alternative Phases (Special Cases)
  • 4. Additional Resources

Was this helpful?

Export as PDF

Using the dApp

Interact with Escrows Seamlessly

PreviousSubscription + Performance-based RetainersNextStep 1: Accessing the Trustless Work Dapp and Logging In

Last updated 3 months ago

Was this helpful?

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

To log in, you must connect a Stellar-compatible wallet. Read more in the .

Learn more at.

🔹 Ready to start? Access the 🔹 Need support? Join our Telegram or Ask our AI.

🤖
Stellar wallets section
Dapp
Get Testnet Tokens