> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vanna.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Open Vanna on Stellar testnet, connect a wallet, mint free test tokens and pick what you want to do.

Vanna is a credit layer on Stellar (Soroban). You can lend into Vanna's pools, or open one **margin account**, borrow up to **10x** against it, and use the loan in Stellar DeFi: swaps on **Soroswap** and **Aquarius**, and supply on **Blend**. One health factor covers the whole account.

**Live app:** [test.vanna.finance](https://test.vanna.finance) (choose **Stellar** in the chain switcher at the top right; the first visit asks for an access code)

> [!NOTE]
>
> This guide describes **Stellar testnet** at [test.vanna.finance](https://test.vanna.finance). Get test tokens from **Deposit → Test funds** in the app header, pick the exact USDC variant (BLUSDC, AqUSDC or SoUSDC) the pool or venue needs, and keep some XLM for fees and reserves.

## Three steps to start

**1. Install a wallet and switch it to Testnet**

Install [Freighter](https://www.freighter.app/) (OneKey also works) and set its network to **Testnet**. See [Connect Your Wallet](https://docs.vanna.finance/stellar/guides/connect-wallet.md).

**2. Connect**

Open [test.vanna.finance](https://test.vanna.finance), enter your access code if asked, choose **Stellar** in the chain switcher, then click the connect button at the top right and approve the connection in your wallet.

**3. Mint test tokens**

Click **Deposit** in the header. Under **Test funds**, press **Mint all**, or **Mint** one token at a time: XLM (Friendbot), BLUSDC (Blend faucet), AqUSDC (Aquarius faucet) and SoUSDC (Soroswap faucet).

![Portfolio account modal with Deposit and Transfer tabs, Test funds tiles for 10,000 XLM, BLUSDC, 1,000 AqUSDC and SoUSDC each with a Mint button, a Mint all button, and a Receive panel with the Freighter address and QR code](https://mintcdn.com/vannafinance/nTvFas2wipJFpeKy/images/stellar/onboarding/deposit-modal-test-funds.png?fit=max\&auto=format\&n=nTvFas2wipJFpeKy\&q=85\&s=4ef009b18c5ef268cc0db1dde71f4ccd)

The Portfolio account modal: one-click test funds on the left, your receive address and QR code on the right. Click the image to zoom.

## The app at a glance

The header groups the pages the way money flows:

| Group | Page | What you do there |
| - | - | - |
| | [Portfolio](https://docs.vanna.finance/stellar/guides/portfolio.md) | Net worth, net earnings and health factor; Lender, Trader and Balances tabs |
| **Lend** | [Earn](https://docs.vanna.finance/stellar/guides/earn/overview.md) | Supply XLM, BLUSDC, AqUSDC or SoUSDC to Vanna's pools |
| **Borrow & Trade** | [Margin](https://docs.vanna.finance/stellar/guides/margin/overview.md) | Deposit collateral, borrow at 1x to 10x, repay, move collateral |
| **Borrow & Trade** | [Trade → Spot](https://docs.vanna.finance/stellar/guides/trade/spot-swap.md) | Swap inside your margin account via Soroswap or Aquarius |
| **Borrow & Trade** | [Farm](https://docs.vanna.finance/stellar/guides/farm/overview.md) | Supply margin funds to Blend, or add LP on Soroswap / Aquarius |
| | [Analytics](https://docs.vanna.finance/stellar/guides/analytics/overview.md) | Protocol-wide risk, read live from the chain |
| | [Copilot](https://docs.vanna.finance/stellar/guides/copilot.md) | Ask about your account or describe a change in plain English |
| | Rewards | Marked **Soon** in the header |

The **Deposit** button and your wallet name sit at the top right. A small **Assist** tab on the right edge of every page opens a guide that explains what you're looking at and can hand you over to Copilot.

## Supported assets

| Asset | What it is | Lend (Earn) | Borrow | Margin collateral |
| - | - | :-: | :-: | :-: |
| XLM | Native Stellar lumens | ✓ | ✓ | ✓ |
| BLUSDC | Blend's testnet USDC | ✓ | ✓ | ✓ |
| AqUSDC | Aquarius's testnet USDC | ✓ | ✓ | ✓ |
| SoUSDC | Soroswap's testnet USDC | ✓ | ✓ | ✓ |

> [!WARNING]
>
> The three USDC tokens are **different contracts**, each priced at about \$1. Blend uses BLUSDC, Aquarius uses AqUSDC and Soroswap uses SoUSDC. Borrowing one does not give you another.

Blend supply receipts and Soroswap / Aquarius LP positions held in your margin account also count as collateral.

> [!TIP]
>
> A wallet signature is not the final result. Wait for the confirmation and refreshed balances before the next step that depends on it.

Continue with [Connect Your Wallet](https://docs.vanna.finance/stellar/guides/connect-wallet.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.