How defindex-io/stellar-contracts works
DeFindex is a Soroban contract suite for creating and operating tokenized vaults that allocate assets to yield strategies. The principal workflow is to deploy a factory and strategies, create a vault, then deposit, invest, report gains, and withdraw. TypeScript scripts configure networks, deploy contracts, and maintain address books; on-chain Rust contracts implement vault, factory, and strategy behavior. Edges follow excerpts and the README; unsampled strategy and vault internals are represented at their exact source paths, with only evidenced relationships shown.
Main entry points: lib.rs Vault contract · strategies.rs Strategy management · vault.ts Vault operations · deploy_blend.ts Blend deployment
Components 31
Deployment tooling
- Network config
src/utils/env_config.ts - Address book
src/utils/address_book.ts - Transaction helpers
src/utils/tx.ts - Contract deployment
src/utils/contract.ts - Factory deployment
src/deploy_factory.ts - Strategy deployment
src/strategies/deploy_strategies.ts - Blend deployment
src/strategies/deploy_blend.ts - Vault deployment
src/deploy_vault.ts - Vault operations
src/utils/vault.ts
Vault contracts
- Vault contract
vault/src/lib.rs - Deposits and shares
vault/src/deposit.rs - Funds management
vault/src/funds.rs - Investment routing
vault/src/investment.rs - Strategy reporting
vault/src/report.rs - Strategy management
vault/src/strategies.rs - Roles and access
vault/src/access.rs - Vault state
vault/src/storage.rs
Yield strategies
- Blend strategy
strategies/blend/src/lib.rs - Blend reserves
strategies/blend/src/reserves.rs - Blend state
strategies/blend/src/storage.rs - Fixed APR strategy
strategies/fixed_apr/src/lib.rs - Hodl strategy
strategies/hodl/src/lib.rs - Soroswap strategy
strategies/soroswap/src/lib.rs - Xycloans strategy
strategies/xycloans/src/lib.rs - Unsafe Hodl strategy
strategies/unsafe_hodl/src/lib.rs
Factory contract
- Vault factory
factory/src/lib.rs - Factory state
factory/src/storage.rs
Shared contract types
- Strategy core
strategies/core/src/lib.rs - Shared models
common/src/models.rs
Other components
- Deployer
- Stellar network
Connections 35
- Deployer → Factory deployment: runs deployment
- Deployer → Strategy deployment: runs deployment
- Deployer → Vault deployment: runs deployment
- Factory deployment → Network config: loads settings
- Strategy deployment → Blend deployment: dispatches
- Blend deployment → Network config: loads settings
src/strategies/deploy_blend.ts - Blend deployment → Address book: reads addresses
src/strategies/deploy_blend.ts - Blend deployment → Contract deployment: deploys contracts
src/strategies/deploy_blend.ts - Contract deployment → Address book: updates entries
src/utils/contract.ts - Contract deployment → Transaction helpers: submits transactions
src/utils/contract.ts - Vault deployment → Address book: reads addresses
- Vault deployment → Vault factory: creates vault
- Vault operations → Contract deployment: invokes contracts
src/utils/vault.ts - Vault operations → Address book: uses addresses
src/utils/vault.ts - Vault operations → Vault factory: calls factory
src/utils/vault.ts - Vault operations → Vault contract: calls vault
src/utils/vault.ts - Vault factory → Factory state: reads and writes
factory/src/lib.rs - Vault factory → Vault contract: deploys vault
- Vault contract → Deposits and shares: processes deposits
vault/src/lib.rs - Vault contract → Funds management: manages funds
vault/src/lib.rs - Vault contract → Investment routing: routes investments
vault/src/lib.rs - Vault contract → Strategy reporting: fetches reports
vault/src/lib.rs - Vault contract → Strategy management: manages strategies
vault/src/lib.rs - Vault contract → Roles and access: checks roles
vault/src/lib.rs - Vault contract → Vault state: reads and writes
vault/src/lib.rs - Blend strategy → Blend reserves: uses reserves
strategies/blend/src/lib.rs - Blend strategy → Blend state: reads and writes
strategies/blend/src/lib.rs - Strategy management → Blend strategy: dispatches to
- Strategy management → Fixed APR strategy: dispatches to
- Strategy management → Hodl strategy: dispatches to
- Strategy management → Soroswap strategy: dispatches to
- Strategy management → Xycloans strategy: dispatches to
- Strategy management → Unsafe Hodl strategy: dispatches to
- Blend strategy → Strategy core: uses shared core
strategies/blend/src/lib.rs - Vault contract → Shared models: uses shared models