Open protocol for tokenizing physical agricultural commodity deposits on Stellar. Soroban smart contracts, a token metadata standard, and a TypeScript SDK for warehouse receipt tokenization across Nigerian agricultural markets.
farmledge-protocol enables licensed warehouse custodians to issue on-chain warehouse receipts representing physical commodity deposits. Each receipt is a Soroban token carrying structured metadata — commodity type, quantity, grade, custodian identity, and expiry — making it tradeable, financeable, and auditable without leaving the Stellar network.
Current commodities: Maize · Sesame
farmledge-protocol/
├── contracts/
│ ├── maize-receipt/ # Soroban contract — maize warehouse receipts
│ └── sesame-receipt/ # Soroban contract — sesame warehouse receipts
├── sdk/ # TypeScript SDK for dApp and backend integration
├── scripts/ # Deployment and account-funding scripts
├── docs/
│ ├── TOKEN_STANDARD.md # Token metadata specification
│ ├── GRADING_STANDARDS.md
│ └── CUSTODIAN_GUIDE.md
└── .github/
├── workflows/ # CI: test + audit
└── ISSUE_TEMPLATE/
| Contract | Network | Address |
|---|---|---|
| maize-receipt | Testnet | TBD |
| maize-receipt | Mainnet | TBD |
| sesame-receipt | Testnet | TBD |
| sesame-receipt | Mainnet | TBD |
Prerequisites
- Rust stable +
wasm32-unknown-unknowntarget - Stellar CLI
- Node.js 20+
Build contracts
rustup target add wasm32-unknown-unknown
cargo build --workspace --target wasm32-unknown-unknown --releaseRun tests
cargo test --workspaceInstall SDK
cd sdk && npm install| Document | Description |
|---|---|
| Token Standard | Metadata fields and token lifecycle |
| Grading Standards | Commodity grade codes and inspection process |
| Custodian Guide | Onboarding and operational guide for custodians |
Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request. For security issues, see SECURITY.md.
Apache 2.0 — see LICENSE. Copyright 2026 Farmledge Labs.