Vauban Documentation

Vauban is a Starknet-native staking platform enabling users to stake STRK and BTC tokens through a delegation pool mechanism with liquid staking tokens.

What is Vauban?

Vauban provides:

• Native Staking -- Delegate STRK and BTC wrappers to Starknet validators
• Liquid Staking Tokens (LST) -- Receive vaSTRK/vaBTC tokens representing your staked position
• DCA Engine -- Automated dollar-cost averaging via AVNU aggregator
• BTCFi Hub -- Compare and optimize BTC yield across Starknet

Architecture at a Glance

Frontend (Next.js 15)
    |
    v
Backend API (Express/TypeScript)
    |
    v
Smart Contracts (Cairo)
    |
    v
Starknet Network

The backend prepares transaction calldata but never executes transactions. All signing happens client-side in the user's wallet.

Quick Links

• Quickstart -- Set up a local development environment
• Architecture Overview -- How the system fits together
• Native Staking Guide -- Stake STRK or BTC tokens
• LST Guide -- Liquid staking with vaSTRK/vaBTC
• API Reference -- Cheatsheet and reference

Project Components

Component	Technology	Purpose
Smart Contracts	Cairo 2.13	VaubanDelegationManager + VaubanVault
Backend API	Express/TypeScript	Transaction preparation, metrics, cron jobs
Event Indexer	TypeScript + PostgreSQL	On-chain event tracking
Frontend	Next.js 15	User interface with wallet integration
Infrastructure	K3s + ArgoCD	Kubernetes deployment on Hetzner