xendune Documentation
Welcome to the official documentation for xendune — a decentralized escrow marketplace built for EVM-compatible blockchains.
xendune enables trustless peer-to-peer transactions through on-chain escrow with USDT settlement, merchant deposits, and community-driven dispute arbitration. Currently deployed on BNB Smart Chain (BSC) mainnet.
The Problem
Current online transactions suffer from fundamental trust issues:
- Centralized custody risk: Traditional platforms hold user funds in custodial accounts — a single point of failure vulnerable to fraud, censorship, or insolvency
- Cross-border payment friction: International transactions face high fees, slow settlement, foreign exchange losses, and regulatory barriers
- Opaque dispute resolution: Buyers and sellers have no visibility into how disputes are adjudicated, and platforms can freeze funds arbitrarily
- Lack of merchant accountability: Bad actors can defraud buyers and disappear without facing economic consequences
- Platform lock-in: Merchant reputation accumulated on one platform is lost entirely if they leave or are banned
How xendune Solves These Problems
- Trustless on-chain escrow: Funds are locked in smart contracts, not custodial accounts. No individual or entity can misappropriate or redirect user funds — all fund movements are triggered by business logic (settlement, arbitration, deposit forfeiture) with every transfer recorded on-chain
- USDT settlement: Stablecoin payments eliminate foreign exchange risk, enable instant cross-border transactions, and remove dependency on traditional payment processors
- Transparent arbitration: Disputes are adjudicated by community arbitrators randomly selected on-chain (up to 13 per case), who must stake ≥ 1,000 USDT to participate. All rulings are recorded on-chain with full audit trails
- Merchant deposit system: Sellers must stake 500–1,000,000 USDT as collateral. If they lose arbitration, buyers are compensated directly from the deposit, creating real economic accountability
- Portable reputation: Ratings, sales records, and arbitration history are stored on-chain. Merchant reputation is verifiable by anyone and not controlled by any single platform
- Multi-chain ready: Built on standard EVM contracts (Solidity ^0.8.35), deployable to any EVM-compatible chain without modification
Quick Navigation
- Protocol Overview — What xendune is and how it works
- System Architecture — Contract interactions and data flow
- Contract Reference — All 32 deployed contracts
- Security — Audit findings, access control, and security modes
Core Features
- Four product types: Physical goods, virtual/digital goods, local services, and WantToBuy orders—each with tailored escrow workflows
- Timed auctions: On-chain timed bidding with anti-snipe extension, 5% fee
- C2C OTC trading: Peer-to-peer USDT↔fiat exchange with escrow protection, 0.2% fee
- Shuifang exchange: Professional exchange merchant listings executed by escrow contracts
- Keyword bidding: On-chain auction for search ranking positions (Top 20 per keyword, daily reset)
- Merchant deposits: Stake-based trust system; also the entry threshold for community arbitrators (≥ 1,000 USDT)
- Community arbitration: Decentralized voting by staked arbitrators; 10% arbitration fee (90% to arbitrators, 10% to platform)
- Referral commission system: Two-tier rewards, L1 gets 20%, L2 gets 10% (from fee portion), automatically distributed on settlement
Technical Highlights
- All product contracts deployed via EIP-1167 minimal proxy (clone) pattern for massive gas savings
- Archive-based storage with generational rotation for unlimited scalability
- Platform fees configurable by product type (0.2%–5%)
- Fee automatically split 3-way via PlatformFeeSplitter (payee addresses locked at deployment)
- Chain-agnostic design: Standard EVM with no chain-specific dependencies