# Vanna

## Docs

- [Architecture](https://docs.vanna.finance/developers/architecture.md): How Vanna's 14 Soroban smart contracts fit together: layers, call graphs, and data flows for deposits, borrows, and liquidations.
- [AccountManager](https://docs.vanna.finance/developers/contracts/account-manager.md): The single entry point for all margin account operations. Function reference with parameters, return values, errors, and events.
- [Lending Pools](https://docs.vanna.finance/developers/contracts/lending-pools.md): Function reference for LendingPoolXLM and LendingPoolUSDC — deposit, vToken redemption, borrow, repay, and interest state functions.
- [RateModel](https://docs.vanna.finance/developers/contracts/rate-model.md): Interest rate model contract. Computes per-second borrow rates as a polynomial function of pool utilization.
- [Registry](https://docs.vanna.finance/developers/contracts/registry.md): On-chain address book for all Vanna Protocol contracts. Every protocol contract resolves peer addresses here at runtime.
- [RiskEngine](https://docs.vanna.finance/developers/contracts/risk-engine.md): Stateless health-check contract. Function reference for borrow gates, withdrawal gates, health factor computation, and collateral valuation.
- [SmartAccount](https://docs.vanna.finance/developers/contracts/smart-account.md): Per-user deployed contract that holds collateral, tracks debt, and routes capital to external protocols. Function reference with external protocol actions.
- [Tracking Tokens](https://docs.vanna.finance/developers/contracts/tracking-tokens.md): Single contract tracking Blend b-token positions and Aquarius/Soroswap LP token balances per margin account.
- [vTokens](https://docs.vanna.finance/developers/contracts/vtokens.md): Fungible tokens representing LP share in a Vanna lending pool. Function reference for vXLM and vUSDC contracts.
- [Deployed Contracts](https://docs.vanna.finance/developers/deployed-contracts.md): All Vanna Protocol contract addresses on Stellar Testnet, including lending pools, tokens, and external protocol integrations.
- [Events & Indexing](https://docs.vanna.finance/developers/guides/events-indexing.md): Complete reference for all Vanna Protocol contract events with XDR schemas, Mercury integration patterns, and real-time streaming.
- [Integrate Lending](https://docs.vanna.finance/developers/guides/integrate-lending.md): End-to-end guide for integrating Vanna's lending pools: supply liquidity, read pool state, and redeem vTokens.
- [Integrate Margin Accounts](https://docs.vanna.finance/developers/guides/integrate-margin.md): End-to-end guide for integrating Vanna margin accounts: create accounts, deposit collateral, borrow assets, deploy to external protocols, repay, and close.
- [Liquidation Bots](https://docs.vanna.finance/developers/guides/liquidation-bots.md): How to build a liquidation bot for Vanna Protocol: discover accounts, monitor health factors, and trigger liquidations.
- [Math Reference](https://docs.vanna.finance/developers/math-reference.md): Complete formula reference for Vanna Protocol: WAD arithmetic, interest accrual, vToken exchange rates, borrow shares, health factor, and the rate model polynomial.
- [Developer Overview](https://docs.vanna.finance/developers/overview.md): Everything you need to build on Vanna Protocol — margin accounts, lending pools, liquidation bots, and yield integrations on Stellar Soroban.
- [TypeScript SDK: Getting Started](https://docs.vanna.finance/developers/sdk/getting-started.md): How to set up your environment and start calling Vanna Protocol contracts from TypeScript using the Stellar SDK and Freighter wallet.
- [Mercury Indexer](https://docs.vanna.finance/developers/sdk/mercury-indexer.md): How to query historical contract events from Vanna Protocol using the Mercury indexer — deposits, borrows, repayments, and liquidations.
- [Transaction Flow](https://docs.vanna.finance/developers/sdk/transaction-flow.md): How to build, simulate, sign with Freighter, and submit a Soroban transaction to Vanna Protocol contracts.
- [Liquidations](https://docs.vanna.finance/guides/analytics/liquidations.md): Monitor recent liquidation events and wallets currently eligible for liquidation.
- [Risk Monitoring Dashboard](https://docs.vanna.finance/guides/analytics/overview.md): Protocol-wide risk intelligence dashboard - monitor positions, liquidation risk, bad debt, and run stress simulations in real time.
- [Positions](https://docs.vanna.finance/guides/analytics/positions.md): View all active margin positions, HF distribution, leverage analytics, and live borrow rates across pools.
- [Risk Explorer](https://docs.vanna.finance/guides/analytics/risk-explorer.md): Run stress simulations to understand how the protocol responds to market crashes, depegs, and liquidity shocks.
- [Connect Your Wallet](https://docs.vanna.finance/guides/connect-wallet.md): Step-by-step guide to connecting your Stellar wallet to Vanna and claiming testnet tokens from the faucet.
- [Earn Overview](https://docs.vanna.finance/guides/earn/overview.md): How Liquidity Providers (LPs) Earn on Vanna
- [Supply to Earn](https://docs.vanna.finance/guides/earn/supply.md): Deposit assets into a Vanna lending pool and start earning yield immediately.
- [Withdraw from Earn](https://docs.vanna.finance/guides/earn/withdraw.md): Redeem your vTokens and receive your original deposit plus all accrued yield.
- [LP Pools](https://docs.vanna.finance/guides/farm/amm-liquidity.md): Provide liquidity to AMM pools with two assets and earn a share of every swap's trading fee.
- [Single-Asset Pools](https://docs.vanna.finance/guides/farm/blend-pools.md): Deposit one asset into a lending pool, receive b-Tokens, and earn yield from borrower interest.
- [Lite Mode](https://docs.vanna.finance/guides/farm/leveraged-yield.md): Lite Mode is Vanna's simplified one-click leveraged yield strategy - deposit collateral, borrow, and deploy into a yield pool in a single transaction.
- [Farm Overview](https://docs.vanna.finance/guides/farm/overview.md): Deploy assets from your Margin Account into external yield strategies - single-asset lending pools and multi-asset LP pools.
- [For Passive Investors](https://docs.vanna.finance/guides/for-liquidity-providers.md): Supply assets to Vanna's lending pools and earn higher yields from borrower interest - passively, with no active management required.
- [For Traders](https://docs.vanna.finance/guides/for-traders.md): Access leveraged yield strategies and composable margin trading on Vanna - choose Lite Mode for simplicity or Pro Mode for full control.
- [Getting Started](https://docs.vanna.finance/guides/getting-started.md): Connect your wallet, choose your side, and start using Vanna in minutes.
- [How Vanna Works](https://docs.vanna.finance/guides/how-vanna-works.md): How Liquidity Providers and Traders Create a Win-Win Situation for Both.
- [Borrow](https://docs.vanna.finance/guides/margin/borrow.md): How to borrow assets against your Margin Account collateral.
- [Deposit Collateral](https://docs.vanna.finance/guides/margin/deposit-collateral.md): How to deposit assets into your Margin Account as collateral.
- [Health Factor](https://docs.vanna.finance/guides/margin/health-factor.md): What your Health Factor means, what moves it, and how to keep your position safe.
- [Liquidation](https://docs.vanna.finance/guides/margin/liquidation.md): What liquidation is, when it happens, and how to avoid it.
- [Open a Margin Account](https://docs.vanna.finance/guides/margin/open-account.md): How to create your Margin Account on Vanna.
- [Margin Account](https://docs.vanna.finance/guides/margin/overview.md): Your personal on-chain account for depositing collateral, borrowing assets, and trading with leverage.
- [Repay a Loan](https://docs.vanna.finance/guides/margin/repay.md): How to repay your borrowed assets and improve your Health Factor.
- [Transfer Collateral](https://docs.vanna.finance/guides/margin/transfer-collateral.md): How to move assets between your wallet and your Margin Account.
- [Sample Strategies](https://docs.vanna.finance/guides/sample-strategies.md): Practical strategies for using Vanna's Earn, Margin, Trade, and Farm sections to build yield-generating positions with minimal downside.
- [Cross-Pool Rate Carry](https://docs.vanna.finance/guides/strategies/cross-pool-rate-carry.md): Borrow XLM from Vanna and deploy it into an external Blend XLM pool - earning the spread between the two rates while holding zero net XLM price exposure.
- [Dual Yield Stack](https://docs.vanna.finance/guides/strategies/dual-yield-stack.md): Supply USDC to Vanna's Earn pool while simultaneously running an XLM rate carry in Margin - stacking two independent yield streams with no directional price exposure.
- [Earn + Borrow Hedge](https://docs.vanna.finance/guides/strategies/earn-borrow-hedge.md): Supply XLM to Vanna's Earn pool for yield, then borrow an equal value of XLM and swap it to USDC - creating a delta-neutral position that earns on both sides.
- [Parallel Rate Carry](https://docs.vanna.finance/guides/strategies/parallel-rate-carry.md): Borrow XLM from a single USDC collateral base and split it across two yield venues - Blend's XLM pool and Aquarius's XLM/USDC pool - stacking two independent rate spreads with no net XLM price exposure.
- [Spot Swap](https://docs.vanna.finance/guides/trade/spot-swap.md): How to trade assets using borrowed margin from your Margin Account.
- [Vanna Protocol](https://docs.vanna.finance/home.md)
- [Health Factor](https://docs.vanna.finance/learn/health-factor.md): The solvency invariant computed by the Risk Engine before every borrow, withdrawal, and liquidation. Never stored - always derived on demand from live oracle prices and current account state.
- [Interest Rate Model](https://docs.vanna.finance/learn/interest-rate-model.md): How Vanna automatically adjusts borrowing costs based on pool utilization - no governance votes, no fixed rates.
- [Lending Pools](https://docs.vanna.finance/learn/lending-pools.md): The passive liquidity layer that powers every borrow on Vanna.
- [Liquidation](https://docs.vanna.finance/learn/liquidation.md): The debt clearance mechanism that runs when an account's health factor falls to or below 1.1x. Repays all outstanding debt and returns remaining direct token collateral to the account owner.
- [Oracle System](https://docs.vanna.finance/learn/oracle-system.md): How Vanna fetches real-time asset prices to value collateral and compute account health.
- [Concepts Overview](https://docs.vanna.finance/learn/overview.md)
- [Protocol Architecture](https://docs.vanna.finance/learn/protocol-architecture.md): How Vanna's contracts are layered, what each one does, and how they connect.
- [Registry](https://docs.vanna.finance/learn/registry.md): The on-chain address book that maps identifiers to contract addresses, owners to accounts, and underlying assets to vTokens. The one address every integrator hardcodes.
- [Margin Accounts](https://docs.vanna.finance/learn/smart-accounts.md): A separately deployed smart contract per user that holds collateral, tracks debt, and executes external protocol calls. The atomic unit of Vanna's risk model.
- [vTokens](https://docs.vanna.finance/learn/vtokens.md): vTokens are the share tokens issued by Vanna's Lending Pools. They represent a depositor's proportional claim on the pool and grow in redemption value as borrowers repay debt with interest.
- [Coming Soon](https://docs.vanna.finance/resources/coming-soon.md): Resources are on their way.
- [Coming Soon](https://docs.vanna.finance/security/coming-soon.md): Security documentation is on its way.

## Optional

- [Discord](https://discord.gg/vanna)