Technical Documentation

Comprehensive protocol documentation covering core concepts, architecture, security model, and integration guides.

Core Concepts

Single-Asset Vaults
Isolated, non-custodial token storage with oracle-based accounting

Architecture

Each vault is dedicated to a single SPL token type, ensuring complete asset isolation. Vaults are implemented as Program Derived Addresses (PDAs) with deterministic seeds, providing cryptographic guarantees about vault ownership and authority.

Vault Structure

Seeds: ["vault", asset_mint]

Purpose: Holds deposited SPL tokens

Properties: Isolated per asset, immutable mint binding

No LP Token Exposure

Unlike traditional AMM-based protocols, Teranium vaults maintain single-asset exposure. Users deposit one token and receive the same token back plus yield, eliminating impermanent loss risk associated with liquidity provision.

Protocol Quick Reference

Security Model
  • • PDA-enforced authorities
  • • No admin custody keys
  • • Deterministic state transitions
  • • Immutable vault-mint bindings
Vault Mechanics
  • • Single SPL token per vault
  • • Oracle-based accounting
  • • Adaptive yield routing
  • • Permissionless withdrawals
Swap Execution
  • • Pyth Network oracles
  • • Slippage-bounded trades
  • • Reduced MEV exposure
  • • Deterministic pricing
Risk Management
  • • Solvency guarantees
  • • Diversification constraints
  • • Oracle staleness checks
  • • Position tracking PDAs
Developer Resources
  • • TypeScript SDK
  • • Anchor-compatible programs
  • • Wallet adapter support
  • • Example integrations
Protocol Status
  • • Solana Mainnet
  • • Production-ready
  • • Open-source codebase
  • • Community-driven