Join our stargazers :)

Soroban Escrow Contract

Smart Contract ensuring transparent and trustless payment processing between project maintainers (bounty sponsor) and contributors (beneficiary).

• Secure Escrow Management: Holds USDC bounty payments in escrow until task completion.
• Automated Payments: Instant payment release upon task approval.
• Dispute Resolution: Built-in dispute handling with partial payment options.

Prerequisites

• Rust (v1.85.0 or higher)
• Stellar CLI
• Git (latest version)

Installation & Setup

1. Clone the Repository

git clone https://github.com/devasignhq/soroban-contracts.git
cd soroban-contracts

2. Install the target

rustup target add wasm32v1-none

3. Build the Contract

# Build the contract
stellar contract build

4. Configure an Identity

# Create an identity (change 'lenny' to any name you want)
stellar keys generate --global lenny --network testnet --fund

# Get the public key of lenny 
stellar keys address lenny

Fund the account using Stellar's Friendbot

5. Deploy to Testnet

# Deploy contract
stellar contract deploy \
  --wasm target/wasm32v1-none/release/devasign_task_escrow.wasm `
  --source-account lenny \
  --network testnet \
  --alias devasign_task_escrow

# Initialize contract
stellar contract invoke \
  --id <CONTRACT_ID> \
  --source lenny \
  --network testnet \
  -- initialize \
  --admin <ADMIN_ADDRESS> \
  --usdc_token <USDC_TOKEN_ADDRESS>

Testing

# Run all tests
cargo test

# Run specific test module
cargo test --test test_contributor_assignment

License

This project is licensed under the Apache 2.0 License. See LICENSE for more details.

Related Projects

• DevAsign API Server - Backend API and AI engine
• DevAsign Project Maintainer App - Frontend for project maintainer
• DevAsign Contributor App - Frontend for contributors

---