> ## 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.

# Developer Overview

> Integrate with the reviewed Stellar testnet contracts and application.

This reference describes the local `Protocol_V1_Soroban_testnet` contracts and the Stellar app in `Vanna_Finance_Backend/apps/stellar`, reviewed on **2026-10-29**. Configured contract addresses were verified on-chain on 2026-10-24. It does not describe the Solana, Solidity, or older Soroban directories.

Start with [Architecture](https://docs.vanna.finance/stellar/developers/architecture.md), [Configured Contracts](https://docs.vanna.finance/stellar/developers/deployed-contracts.md), and [Math Reference](https://docs.vanna.finance/stellar/developers/math-reference.md). The [contract reference](https://docs.vanna.finance/stellar/developers/contracts/account-manager.md) includes the current Rust signatures, including privileged callbacks. Env is implicit at the transaction boundary.

## Repository map

| Directory or file | Responsibility |
| - | - |
| `Protocol_V1_Soroban_testnet/contracts` | Core contracts, controllers, deployers, shared library |
| `Protocol_V1_Soroban_testnet/integrated_test` | Lifecycle, controller, risk, registry, and regression tests |
| `Protocol_V1_Soroban_testnet/deploy` | Deployment and verification scripts |
| `Vanna_Finance_Backend/apps/stellar/app` | Next.js pages and server API routes (`/api/stellar/*`) |
| `Vanna_Finance_Backend/apps/stellar/lib/*-utils.ts` | Stellar transaction and read services |
| `Vanna_Finance_Backend/apps/stellar/hooks` | Query, mutation, wallet, and snapshot hooks |
| `Vanna_Finance_Backend/apps/stellar/lib/copilot` | Copilot planning, authentication, approval, execution |
| `Vanna_Finance_Backend/packages/shared` | Header, sign-in dialog, funds modal and mascot shared with the Solana app |

## Current scope

Four lending markets, per-trader SmartAccounts, Blend supply, and Soroswap/Aquarius controller integrations are implemented. External availability remains pool/configuration dependent. Perpetuals and options are not enabled in this Stellar application. Read the [frontend reference](https://docs.vanna.finance/stellar/developers/frontend.md) for routes and data limitations.

The TypeScript integration is application-local service code, not a published `@vanna/sdk` package. Use [Getting Started](https://docs.vanna.finance/stellar/developers/sdk/getting-started.md) and [Transaction Flow](https://docs.vanna.finance/stellar/developers/sdk/transaction-flow.md).


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