Quickstart

How to install, configure, validate, and operate the Build a Bear Vault repository.

Quickstart

This page is the fastest path to understand and validate the repository.

Prerequisites

• Node.js 18+
• pnpm
• Rust toolchain
• Solana CLI
• Anchor CLI for program deployment and local program work

Install dependencies

pnpm install

Start with offline validation

Run the complete offline suite first:

node --test --experimental-strip-types tests/offchain/*.test.ts

Useful local demos:

node --experimental-strip-types services/solver/src/cli/demo.ts
node --experimental-strip-types services/solver/src/cli/backtest.ts
node --experimental-strip-types services/ranger/src/demo.ts

Create your environment file

cp .env.example .env

Then fill the values in Operations / Environment.

Validate runtime configuration

Before any live test, run:

node --experimental-strip-types services/ranger/src/doctor.ts

This checks:

• RPC URLs
• local signer loading
• protocol owner/signer alignment
• derived vault PDA
• on-chain visibility of the configured program and vault

Recommended validation order

If your goal is to bring the whole vault up on Solana devnet first, follow:

• Operations / Devnet Deploy

1. Protocol build-only checks

Validate that the protocol adapters can build real bundles:

node --experimental-strip-types services/ranger/src/drift-smoke.ts
node --experimental-strip-types services/ranger/src/kamino-smoke.ts

2. Direct protocol transaction

Validate Drift without depending on the vault:

node --experimental-strip-types services/ranger/src/drift-live-send.ts

3. Vault bootstrap

Once the program is deployed and wallets are funded:

node --experimental-strip-types services/ranger/src/vault-bootstrap.ts
node --experimental-strip-types services/ranger/src/vault-status.ts

4. Full rebalance path

After the vault exists on-chain:

node --experimental-strip-types services/ranger/src/demo.ts

What not to do first

Do not start with a mainnet bootstrap unless these are already true:

• the program ID points to a real executable program
• the operator wallets have SOL
• VAULT_SHARE_MINT_KEYPAIR_PATH and VAULT_TREASURY_KEYPAIR_PATH are set
• the protocol owner addresses match local signers

Next pages

• Current Status
• Operations / Devnet Deploy
• Operations / Environment
• Operations / Protocol Testing