This repository contains Grainlify's Stellar Soroban smart contracts and their supporting tests, manifests, benchmarks, and deployment tooling.
contracts/contains the primary contract packages, SDK, manifests, and contract-focused documentation.soroban/contains the Soroban workspace and its program-escrow and stream contracts; itsescrowcrate is superseded (reference/parity only).benchmarks/contains contract performance baselines and thresholds.scripts/andfix/contain contract validation, testing, upgrade, and maintenance utilities.
The deployment status in each README reflects evidence recorded in this repository. Missing network IDs mean a live deployment is unverified here, not that one has never existed.
| Manifest directory | Purpose |
|---|---|
| contracts | Rust utility library and CLI |
| contracts/bounty_escrow | SDK 21 workspace for the bounty contract |
| contracts/bounty_escrow/contracts/escrow | SDK 21 bounty fund escrow |
| contracts/escrow-view-facade | Bounty and program read facade |
| contracts/grainlify-core | Governance, upgrades, and shared types |
| contracts/program-escrow | SDK 21 program funds and payouts |
| contracts/view-facade | Registry and program read facade |
| soroban | SDK 23 workspace |
| soroban/contracts/escrow | Separate SDK 23 bounty-style escrow |
| soroban/contracts/program-escrow | Separate SDK 23 program registry and search |
| soroban/contracts/stream | Gas regression test fixtures |
Escrow authority: the deployed escrow contract is
contracts/bounty_escrow/contracts/escrow(bounty_escrow.wasm). Thesoroban/contracts/escrowcrate is superseded and is never deployed. Seedocs/contracts/escrow-implementation-authority.md.
The following documents describe the current architecture and behavior of the system:
- Deployable Artifacts - Lists every deployable WebAssembly artifact produced by this repository.
- Release Schedules Usage - Details the time-based release schedules (vesting) feature for escrow contracts.
- Upgrade and Migration Policy - Defines the rules and requirements for authorizing, executing, and reverting contract upgrades.
Run the primary workspace tests with:
cargo test --manifest-path soroban/Cargo.tomlValidate the contract manifests with:
cd contracts
npm testThe contract workflows under .github/workflows/ run the repository's contract checks, benchmark gate, upgrade smoke tests, and storage-layout validation.
The repository is intentionally limited to on-chain contract code and contract-related tooling. Application backend, frontend, website, design, and deployment material are maintained elsewhere.