This document provides a single source of truth for the deployment readiness and integration status of all Soroban smart contracts in the contracts/ workspace.
| Contract | Status | Supported? | Description | Known Blockers / Notes |
|---|---|---|---|---|
| achievement-badges | Production | ✅ Yes | NFT achievement badges | None. Ready for integration. |
| flash-loan | Production | ✅ Yes | Flash loan protocol | None. Fully tested. |
| path-payment | Production | ✅ Yes | Automatic currency conversion | None. |
| split-template | Production | ✅ Yes | Reusable split templates | None. Supports versioning. |
| staking | Production | ✅ Yes | Staking, governance & rewards | None. Fully tested. |
| dispute-resolution | Broken | ❌ No | On-chain dispute handling | Compilation errors. Mid-port to pinned Soroban toolchain. |
| split-escrow | Broken | ❌ No | Trustless bill split escrow | DO NOT INTEGRATE. Compilation errors; draft/broken source. |
| multi-sig-splits | Broken | ❌ No | Multi-signature coordination | E0507 move error; needs ownership fix. |
| reminder | Archived | ❌ No | On-chain payment reminders | Orphaned contract area. Incomplete structure. |
The frontend and backend must only integrate with contracts marked as Production.
Contracts listed as Broken (such as split-escrow) are currently undergoing heavy refactoring or toolchain upgrades and cannot be deployed or interacted with locally or on testnet. Attempts to compile the broken modules using cargo build --workspace will currently fail unless they are specifically excluded from the workspace (which they are in Cargo.toml).
When fixing a broken contract:
- Ensure
cargo test -p <contract_name>passes locally. - Ensure
cargo clippy --target wasm32-unknown-unknownyields no errors. - Update
contracts/README.mdand this document to reflect theProductionstatus. - Add the contract to the CI build scripts.