# Vanna

- [Vanna on Solana](https://docs.solana.vanna.finance/home.md)
- [Getting Started](https://docs.solana.vanna.finance/guides/getting-started.md): Open the live Vanna Solana demo, connect a wallet, mint test stocks, and pick a flow.
- [Connect Your Wallet](https://docs.solana.vanna.finance/guides/connect-wallet.md): Connect Phantom, Backpack, Solflare, or Privy and mint test assets on the Vanna fork.
- [Why Tokenized Stocks Needed Vanna](https://docs.solana.vanna.finance/guides/why-vanna.md): No perps. Zero Kamino yield. Hold-only bags. Vanna turns xStocks and PreStocks into credit, leverage, and one-click yield.
- [Portfolio](https://docs.solana.vanna.finance/guides/portfolio.md): Read lender positions, trader collateral, and combined balances in one place.
- [How Vanna Works](https://docs.solana.vanna.finance/guides/how-vanna-works.md): Lending pools, cross-margin accounts, Pyth prices, Jupiter swaps, and Kamino yield on one Solana program.
- [For Liquidity Providers](https://docs.solana.vanna.finance/guides/for-liquidity-providers.md): Supply stocks and stables to Vanna pools and earn borrower interest.
- [For Traders and Borrowers](https://docs.solana.vanna.finance/guides/for-traders.md): Use a cross-margin account to long, short, swap, and farm tokenized stocks.
- [Earn Overview](https://docs.solana.vanna.finance/guides/earn/overview.md): Supply SOL, USDC, and tokenized stocks to Vanna lending pools.
- [Supply](https://docs.solana.vanna.finance/guides/earn/supply.md): Deposit wallet assets into a Vanna reserve and receive vTokens.
- [Withdraw](https://docs.solana.vanna.finance/guides/earn/withdraw.md): Redeem vTokens for the underlying asset, limited by available pool cash.
- [Margin Account](https://docs.solana.vanna.finance/guides/margin/overview.md): Cross-margin borrowing account: collateral vaults, debt shares, and one shared account-wide health factor.
- [Open Account](https://docs.solana.vanna.finance/guides/margin/open-account.md): Create the per-wallet margin PDA. Required once.
- [Deposit Collateral](https://docs.solana.vanna.finance/guides/margin/deposit-collateral.md): Move wallet tokens into the margin vault. The live balance is the credit.
- [Borrow](https://docs.solana.vanna.finance/guides/margin/borrow.md): Pull reserve cash into the margin vault and open a debt-share position.
- [Repay](https://docs.solana.vanna.finance/guides/margin/repay.md): Burn debt shares by paying from the margin vault or from the wallet.
- [Transfer Collateral](https://docs.solana.vanna.finance/guides/margin/transfer-collateral.md): Move tokens between wallet and margin, or withdraw excess after a health check.
- [Spot Swap](https://docs.solana.vanna.finance/guides/trade/spot-swap.md): Swap SOL, USDC, xStocks, and PreStocks through Jupiter from wallet or margin.
- [Perps Overview](https://docs.solana.vanna.finance/guides/perps/overview.md): The missing long/short market for tokenized stocks. Cross-margin, up to 5×, one signature.
- [Long a Stock](https://docs.solana.vanna.finance/guides/perps/long.md): Deposit USDC, borrow more USDC, swap the total into TSLAx / GOOGLx / AAPLx / PreStocks.
- [Short a Stock](https://docs.solana.vanna.finance/guides/perps/short.md): Deposit the stock, borrow more of it, swap the total into USDC.
- [Farm Overview](https://docs.solana.vanna.finance/guides/farm/overview.md): One-click leveraged yield: stock collateral into Kamino's real USDC or SOL market.
- [One-Click Deploy](https://docs.solana.vanna.finance/guides/farm/one-click.md): Deposit stock, set leverage, and send the proceeds to Kamino in one flow.
- [Farm Positions](https://docs.solana.vanna.finance/guides/farm/positions.md): Read collateral, debt, Kamino receipts, and exit 25% / 50% / 75% / 100%.
- [Health Factor](https://docs.solana.vanna.finance/guides/margin/health-factor.md): How Vanna decides whether a margin account is safe to borrow, withdraw, or liquidate.
- [Liquidation](https://docs.solana.vanna.finance/guides/margin/liquidation.md): Permissionless close of an unhealthy account. 50% close factor, bonus to the liquidator.
- [Run and Setup](https://docs.solana.vanna.finance/guides/setup.md): Local Surfpool fork, hosted demo RPC, and how to boot the full stack.
- [Core Concepts](https://docs.solana.vanna.finance/learn/overview.md): Lending, cross-margin accounts, vTokens, health, oracles, and Kamino on Solana.
- [Protocol Architecture](https://docs.solana.vanna.finance/learn/protocol-architecture.md): One program, PDA accounts, Pyth, Jupiter, and Kamino CPI.
- [Tokenized Stocks](https://docs.solana.vanna.finance/learn/tokenized-stocks.md): xStocks and PreStocks on Solana — what existed, and what Vanna added.
- [Margin Accounts](https://docs.solana.vanna.finance/learn/margin-accounts.md): One PDA per wallet. Live vault balances are collateral. Debt is shares.
- [Lending Pools](https://docs.solana.vanna.finance/learn/lending-pools.md): Per-mint reserves: cash ledger, borrow totals, kink rates, caps.
- [vTokens](https://docs.solana.vanna.finance/learn/vtokens.md): Share receipts for a Vanna reserve. Exchange rate rises with interest.
- [Composable Leverage](https://docs.solana.vanna.finance/learn/composable-leverage.md): Borrowed assets stay in the margin PDA and move into Jupiter and Kamino.
- [Health Factor](https://docs.solana.vanna.finance/learn/health-factor.md): Canonical 1.10 collateral-to-debt threshold, conservative rounding.
- [Liquidation](https://docs.solana.vanna.finance/learn/liquidation.md): Permissionless, partial, bonus-paid close of HF ≤ 1.10 accounts.
- [Interest Rate Model](https://docs.solana.vanna.finance/learn/interest-rate-model.md): Kink utilization curve. Borrow APR funds lender APY.
- [Oracle System](https://docs.solana.vanna.finance/learn/oracle-system.md): Pyth PriceUpdateV2 with feed id, staleness, and confidence checks.
- [Kamino Integration](https://docs.solana.vanna.finance/learn/kamino-integration.md): Why xStocks APY is zero, and how Vanna uses the main market instead.
- [Developer Overview](https://docs.solana.vanna.finance/developers/overview.md): Integrate with the Vanna Solana program and the Next.js fork app.
- [Architecture](https://docs.solana.vanna.finance/developers/architecture.md): Program, PDAs, frontend, API routes, and remaining-accounts health scans.
- [Configured Accounts](https://docs.solana.vanna.finance/developers/deployed-contracts.md): Program ID, mints, Pyth feeds, Kamino markets used by the fork app.
- [Math Reference](https://docs.solana.vanna.finance/developers/math-reference.md): WAD, shares, kink rates, health, and liquidation formulas from the Solana program.
- [Frontend](https://docs.solana.vanna.finance/developers/frontend.md): Next.js routes, stores, and which screens are live on Solana.
- [Developer Setup](https://docs.solana.vanna.finance/developers/setup.md): Toolchain, tests, env, and hosted fork notes.
- [Review Scope](https://docs.solana.vanna.finance/developers/review-scope.md): What these docs claim, and what they do not.
- [Program Entrypoint](https://docs.solana.vanna.finance/developers/contracts/program.md): vanna_lending instruction list and module map.
- [Account Layout](https://docs.solana.vanna.finance/developers/contracts/accounts.md): ProtocolConfig, AssetConfig, Reserve, MarginAccount, Debt, Lite.
- [Lending Instructions](https://docs.solana.vanna.finance/developers/contracts/lending.md): lender_supply, lender_redeem, public_refresh_reserve.
- [Margin Instructions](https://docs.solana.vanna.finance/developers/contracts/margin.md): Create, deposit, withdraw, close vaults and the account.
- [Borrow and Repay](https://docs.solana.vanna.finance/developers/contracts/borrowing.md): Debt positions, user_borrow, repay from margin or wallet, deposit-and-borrow.
- [Lite / Kamino Instructions](https://docs.solana.vanna.finance/developers/contracts/lite.md): admin_register_lite_strategy, lite_open, supply, reduce, unwind.
- [Margin Swap](https://docs.solana.vanna.finance/developers/contracts/swap.md): user_margin_swap — Jupiter v6 from the margin vault with a post-swap health check.
- [Liquidation Instruction](https://docs.solana.vanna.finance/developers/contracts/liquidation.md): public_liquidate — permissionless, remaining-accounts complete.
- [Admin Instructions](https://docs.solana.vanna.finance/developers/contracts/admin.md): Init, two-step admin, modes, asset and reserve config, fees.
- [TypeScript Getting Started](https://docs.solana.vanna.finance/developers/sdk/getting-started.md): Use the application-local Anchor client. There is no published package yet.
- [Transaction Flow](https://docs.solana.vanna.finance/developers/sdk/transaction-flow.md): Price refresh, remaining accounts, simulate, then send.
- [PDA Helpers](https://docs.solana.vanna.finance/developers/sdk/pdas.md): Seeds used by the program and Backend-Solana/lib/solana/pdas.ts.
- [Integrate Lending](https://docs.solana.vanna.finance/developers/guides/integrate-lending.md): Supply and redeem from another client.
- [Integrate Margin](https://docs.solana.vanna.finance/developers/guides/integrate-margin.md): Create an account, deposit, borrow, and pass a complete remaining-accounts set.
- [Liquidation Bots](https://docs.solana.vanna.finance/developers/guides/liquidation-bots.md): Watch HF, repay debt, seize collateral. Permissionless.
- [Security and Protocol Controls](https://docs.solana.vanna.finance/security/overview.md): What the Solana program actually enforces. Not an audit certificate.
- [FAQ](https://docs.solana.vanna.finance/resources/faq.md): Common questions for the Stocklana Solana demo.
- [Stocklana](https://docs.solana.vanna.finance/resources/hackathon.md): What we built for Solana's tokenized-stock hackathon, and how to judge it.

## Optional

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