# Build a Bear Vault

> Multi-strategy Solana vault with an off-chain optimizer, on-chain enforcement, and protocol adapters for Drift, Kamino, MarginFi, and Perena.

## Docs

- [Architecture Overview](https://pessoal-86816071.mintlify.app/architecture/index.md): High-level architecture for the Build a Bear Vault, including the on-chain vault, off-chain solver, and protocol execution path.
- [Off-chain Architecture](https://pessoal-86816071.mintlify.app/architecture/offchain.md): How the solver, adapters, Ranger runtime, manifests, and operator CLIs work together.
- [On-chain Architecture](https://pessoal-86816071.mintlify.app/architecture/onchain.md): Anchor program structure, account model, and instruction surface of the multi-strategy vault.
- [Rebalance Flow](https://pessoal-86816071.mintlify.app/architecture/rebalance-flow.md): Detailed rebalance lifecycle from solver inputs to on-chain execution proof.
- [Solver Deep Dive](https://pessoal-86816071.mintlify.app/architecture/solver.md): Technical documentation of the deterministic solver, including its scoring formula, allocation loop, reserve logic, and current limitations.
- [Financial Model](https://pessoal-86816071.mintlify.app/business/financial-model.md): Financial framing of depositor returns, vault economics, and proposed revenue model for the business layer.
- [Business Overview](https://pessoal-86816071.mintlify.app/business/index.md): Product thesis, user value, financial framing, and business-model layer for the Build a Bear Vault.
- [Portfolio Economics](https://pessoal-86816071.mintlify.app/business/portfolio-economics.md): How the vault creates depositor value through sleeves, reserve policy, risk budgets, and blended yield.
- [Product Thesis](https://pessoal-86816071.mintlify.app/business/product-thesis.md): The market problem, product positioning, user value proposition, and why the vault should exist.
- [Current Status](https://pessoal-86816071.mintlify.app/current-status.md): What is implemented, what is ready for offline validation, and what still depends on live infrastructure.
- [Build a Bear Vault](https://pessoal-86816071.mintlify.app/index.md): Overview of the Solana multi-strategy vault, its architecture, and its current MVP scope.
- [Devnet Deploy](https://pessoal-86816071.mintlify.app/operations/devnet-deploy.md): Step-by-step runbook to deploy the Anchor program, bootstrap the vault, and execute the first deposit on Solana devnet.
- [Environment](https://pessoal-86816071.mintlify.app/operations/environment.md): Complete reference for the .env file used by protocol adapters, Ranger, and vault operations.
- [Operations Overview](https://pessoal-86816071.mintlify.app/operations/index.md): Operator-focused documentation for environment setup, vault lifecycle commands, and protocol validation.
- [Protocol Testing](https://pessoal-86816071.mintlify.app/operations/protocol-testing.md): Operator runbook for validating Drift and Kamino before attempting full vault execution.
- [Vault Lifecycle](https://pessoal-86816071.mintlify.app/operations/vault-lifecycle.md): How to bootstrap the vault, manage strategy state, and run user actions safely.
- [Drift](https://pessoal-86816071.mintlify.app/protocols/drift.md): How Drift is integrated, which paths are supported, and how to validate it safely.
- [Protocols Overview](https://pessoal-86816071.mintlify.app/protocols/index.md): Strategy universe, role of each protocol, and current implementation status.
- [Kamino](https://pessoal-86816071.mintlify.app/protocols/kamino.md): How Kamino is integrated, which bundle path is supported, and how to validate it.
- [MarginFi and Perena](https://pessoal-86816071.mintlify.app/protocols/marginfi-perena.md): Manifest-based integration path for protocols that are not yet wrapped by dedicated SDK adapters.
- [Quickstart](https://pessoal-86816071.mintlify.app/quickstart.md): How to install, configure, validate, and operate the Build a Bear Vault repository.
- [Accounts and Types](https://pessoal-86816071.mintlify.app/reference/accounts-and-types.md): Reference for the main on-chain account types and shared TypeScript domain structures.
- [Reference Overview](https://pessoal-86816071.mintlify.app/reference/index.md): Quick access to scripts, data types, account structures, and runtime entrypoints.
- [Scripts](https://pessoal-86816071.mintlify.app/reference/scripts.md): Reference for package scripts and commonly used direct node entrypoints.
- [Roadmap and Gaps](https://pessoal-86816071.mintlify.app/roadmap.md): Known limitations, external dependencies, and the remaining path from scaffold to live product.
- [Testing Overview](https://pessoal-86816071.mintlify.app/testing/index.md): How the repository validates logic offline and what still needs live cluster validation.
- [Live Readiness](https://pessoal-86816071.mintlify.app/testing/live-readiness.md): Checklist for devnet, forked environments, or mainnet before attempting a real bootstrap or rebalance.
- [Offline Testing](https://pessoal-86816071.mintlify.app/testing/offline.md): What the offline suite covers and how to run it.

## OpenAPI Specs

- [openapi](https://pessoal-86816071.mintlify.app/api-reference/openapi.json)