> High-performance, modular Soroban smart contracts powering **StellarFlow**—a next-generation decentralized liquidity, automated market maker (AMM), vault management, and ZK-shielded cross-border remittance architecture built on the Stellar network.
stellarflow-contracts provides the foundational on-chain logic for the entire StellarFlow ecosystem. Designed for maximum security, extreme gas efficiency, and modular interoperability, the repository is structured into distinct protocol layers:
stellarflow-contracts/ ├── contracts/ │ ├── amm/ # Concentrated liquidity AMMs, constant-product pools, and swap routers │ ├── vaults/ # Multi-asset collateralized vaults, borrow/lend engines, and liquidations │ ├── yield/ # Auto-compounded yield strategies, staking pools, and reward emission schedulers │ ├── governance/ # Timelocked DAO proposals, voting power checkpointing, and delegation │ ├── remittance/ # SEP-24/31 fiat anchor escrows, SEP-38 rate handlers, and payout settlement │ ├── zk/ # Poseidon Merkle tree verification, zero-knowledge nullifiers, and shielded pools │ ├── oracles/ # Pyth/Band/Reflector aggregators, medianizers, and TWAP filters │ └── shared/ # Cross-cutting reentrancy guards, access control lists, and math primitives └── tests/ # End-to-end integration test suites and fuzzing configurations
- Smart Contract Engine: Soroban / Rust WebAssembly (
wasm32-unknown-unknown) - Blockchain: Stellar Network (Testnet / Mainnet)
- SDK / Framework:
soroban-sdk - Testing & Fuzzing: Cargo Test Framework + Property-based testing
- Deployment & Automation:
ghCLI, Python (post_issues.py), Soroban CLI
- Install Rust:
curl --proto '=https' --tlsv1.2 -sSf [https://sh.rustup.rs](https://sh.rustup.rs) | sh
rustup target add wasm32-unknown-unknown
- Install Soroban CLI:
cargo install --locked soroban-cli
Clone the repository and compile the WASM binaries:
git clone [https://github.com/stellarflow/stellarflow-contracts.git](https://github.com/stellarflow/stellarflow-contracts.git)
cd stellarflow-contracts
cargo build --target wasm32-unknown-unknown --release
Execute the full suite of unit and integration tests:
cargo test --all
We warmly welcome open-source contributors! Whether you are fixing a security edge case, refactoring math routines for gas efficiency, or expanding our test coverage, your contributions make StellarFlow safer and faster for everyone.
- Pick an Issue: Browse open tasks labeled
good-first-issueorhelp-wanted. - Fork & Branch: Create a feature branch (
git checkout -b feature/my-patch). - Commit & Test: Write thorough unit tests for your changes.
- Open a PR: Link your pull request to the corresponding issue ID.
Thank you to all our contributors for building the future of non-custodial decentralized finance on Stellar!
This repository is licensed under the MIT License.