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

Was this helpful?

Export as PDF
  1. Using the dApp

Step 3: Creating an Escrow

PreviousStep 2: Creating a Profile and Requesting an API KeyNextStep 4: Funding an Escrow

Last updated 3 months ago

Was this helpful?

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.

📌 Tip: If you want to understand roles in escrows, refer to the

🤖
Roles in Escrow Design section.