yinkscss/StellarEscrow

★ 0Forks 0GitHub ↗Compare

README

StellarEscrow

Decentralized escrow on Stellar/Soroban Network.

Features

✅ Trade creation form (preview + confirm) ✅ Buyer funding flow (USDC approval + tx confirmation) ✅ Seller completion + buyer receipt confirmation ✅ Dispute resolution with registered arbitrators ✅ Tiered fees based on volume ✅ Trade history & CSV export ✅ New: Buyer funding UI (client/)

Quick Start

Backend (Soroban Contract + Indexer)

# Deploy contract (Soroban CLI)
soroban contract deploy --wasm target/*.wasm --source dev --network testnet

# Run indexer
cd indexer
cargo run

Frontend (SvelteKit UI)

cd client
pnpm install
pnpm dev    # http://localhost:5173

Test Funding: Visit /trades/1 → Fund Trade → Review preview → Approve USDC → Confirm

Contract Functions

Key funding flow:
  • get_funding_preview(trade_id, buyer) → FundingPreview (balance, allowance)
  • execute_fund(trade_id, buyer, preview) → transfers USDC, emits funded

Analytics

Query on-chain trade metrics (volume, success rate, unique addresses, time windows) via analytics_query. See docs/analytics.md for full details.

Architecture

- `contract/` → Soroban WASM contract
- `indexer/` → Event monitoring + API/WebSocket  
- `client/` → SvelteKit UI (funding interface #32)

## Development

pnpm dev # Frontend cargo test # Backend tests docker-compose up # Indexer + DB


Contributors

Mystery-CLIjohnsaviour56-ship-itmanuelusman73-pngFidelis900Austinaminu2ComputerOracleJenola344Dev-Vik-Torgoldemaverick-uiManuel1234477abore9769famvilianity-engfejilaup-cloudHahfyeexInkman007Dami24-hubJust-BamfordMooreTheAnalystMarkodibaLex-StudiosJayydyjxsonyxchukwudiikehHaroldwonderGrace-CODE-DEjirowebfirohan911438Nonso-Ezesoma-enyiobajecollinsmicheal-cmd

Issues