InvoFi — Contracts

Soroban smart contracts for InvoFi — a decentralized invoice financing protocol on Stellar.

Frontend: invofi-frontend Live contract: CDJS6AFE6VRPAPWOPWOPZLSLQ7NCISA7YHOMAE7HJWOD7G6CQDCVT4L2 (testnet)

---

This repo vs. the main repo

This is where contract contributions happen — fork it, open a PR here for anything touching Soroban/Rust code. It has its own CI and issue queue, scoped to just the contract.

Production runs out of Stellar-VaultLink/invofi, the integration monorepo that combines this contract with invofi-frontend and is what Vercel actually deploys. Merged PRs here get pulled into that repo periodically. If you're looking for the full project (roadmap, deployed demo, both stacks together), start there instead.

---

Contracts

invofi-invoice-registry

The core protocol contract. Handles the full invoice financing lifecycle:

• Register invoices on-chain
• Accept and reject financing offers — accepting pulls the lender's approved principal (via a prior token.approve) and pays it directly to the business
• Repay invoices — pays principal + yield directly to the lender
• Mark overdue, and reclaim (mark Defaulted) after a 7-day grace period
• Yield rate oracle: admin-configured rates per risk tier (A/B/C)

Requires a one-time initialize(admin, token) call after deployment, setting the admin and the SEP-41 token used for fund movement. There is no collateral custody — if a business never repays, reclaim_invoice only produces an on-chain default record, since principal was already disbursed at acceptance.

invofi-core

Shared data types and storage helpers used by the registry contract.

---

Prerequisites

• Rust 1.70+
• wasm32-unknown-unknown target: rustup target add wasm32-unknown-unknown
• Stellar CLI: cargo install --locked stellar-cli

Quick Start

git clone https://github.com/Stellar-VaultLink/invofi-contracts.git
cd invofi-contracts
cargo test

Build

stellar contract build
# → target/wasm32v1-none/release/invofi_invoice_registry.wasm

Deploy to Testnet

stellar keys generate --global invofi-deployer --network testnet
stellar keys fund invofi-deployer --network testnet

stellar contract deploy \
  --wasm target/wasm32v1-none/release/invofi_invoice_registry.wasm \
  --source invofi-deployer \
  --network testnet

After deploying, call initialize once before anything else — accept_offer/repay_invoice will panic with "Not initialized" until this runs:

stellar contract invoke \
  --id <CONTRACT_ID> \
  --source invofi-deployer \
  --network testnet \
  -- initialize --admin <ADMIN_ADDRESS> --token <SEP41_TOKEN_ADDRESS>

Or use the scripts in scripts/:

bash scripts/fund-and-deploy.sh   # generate + fund a deployer key, then build + deploy
bash scripts/deploy.sh            # build + deploy with an existing key

Test

cargo test -- --nocapture

Test	Verifies
test_register_and_get_invoice	Invoice creation and retrieval
test_duplicate_invoice_id_panics	Duplicate ID rejection
test_get_non_existent_invoice	Not-found panic
test_update_invoice_status	Status mutation
test_create_and_get_offer	Offer creation and retrieval
test_accept_offer	Offer acceptance + principal transferred to business
test_reject_offer	Offer rejection
test_repay_invoice	Full repayment flow, principal + yield transferred to lender
test_repay_unfinanced_invoice_panics	Guard against premature repayment
test_initialize_twice_panics	initialize() can only be called once
test_reclaim_invoice_after_grace_period	Reclaim marks offer Defaulted after the grace period
test_reclaim_before_grace_period_panics	Reclaim rejected before the grace period elapses
test_set_and_get_rate	Yield rate set/read for all three risk tiers
test_set_rate_out_of_range_panics	Rate validated to 0-10000 bps
test_set_rate_unauthorized_panics	Only admin can set rates
test_get_unset_rate_panics	Reading an unconfigured tier panics
test_transfer_admin	Admin rotation, new admin can act
test_transfer_admin_unauthorized_panics	Only the current admin can transfer admin rights

18 tests total.

License

MIT © 2026 InvoFi Contributors