Core smart contracts for the VeriNode Decentralized Savings Circle protocol, providing a trustless Rotating Savings and Credit Association (ROSCA) infrastructure on Stellar Soroban.
- Decentralized ROSCA Protocol: Create and join savings circles with custom contribution rules, cycle rollovers, and automated payouts.
- Collateralized Entry & Slashing: Built-in collateral requirements for high-value groups with slashing mechanisms for defaulting members.
- Leniency Voting & Buddy System: Governance extensions for grace periods via democratic voting and buddy pairing safety fallback payments.
- Language/Framework: Rust / Soroban WASM
- Key Dependencies:
soroban-sdk
Ensure you have the required toolchains installed:
- Rust toolchain (cargo, rustc)
- Stellar CLI / Soroban CLI
# Clone the repository (if running manually)
git clone https://github.com/VeriNode-Labs/VeriNode--Core
# Build the smart contracts
cargo build --target wasm32-unknown-unknown --release
# Run the test suite
cargo testThe Rust CI workflow builds the workspace, runs the full test suite, and enforces a minimum line coverage threshold before a pull request can merge. Coverage is generated with cargo-llvm-cov and the workflow fails when line coverage is below the COVERAGE_THRESHOLD value configured in .github/workflows/rust.yml (currently 80%).
To check the same threshold locally, install cargo-llvm-cov and run:
rustup component add llvm-tools-preview
cargo install cargo-llvm-cov
cargo llvm-cov --workspace --all-targets --locked --fail-under-lines 80 --summary-onlyContributions are highly welcome. Please ensure your commits are cryptographically signed using GPG or SSH keys. For major structural changes, please open an issue first to discuss your proposal.