Architecture
BTCFi Architecture
BTCFi Architecture
Vauban supports multiple BTC wrapper tokens on Starknet with yield aggregation and portfolio management.
Supported BTC Wrappers
| Token | Symbol | Decimals | Source |
|---|---|---|---|
| Wrapped BTC | wBTC | 8 | Bridge |
| tBTC | tBTC | 18 | Threshold Network |
| Lombard BTC | LBTC | 8 | Lombard |
| Solv BTC | sBTC | 18 | Solv Protocol |
Staking Paths
Each BTC wrapper can be staked in two modes:
Native Staking
wBTC --> VaubanDelegationManager --> BTC Pool --> STRK rewardsLiquid Staking (LST)
wBTC --> VaubanVault (vawBTC) --> VaubanDelegationManager --> BTC Pool
Returns vawBTC token (tradeable on DEX)BTCFi Hub
The frontend provides a yield comparison dashboard:
- Yield Sources: Compare APY across all BTC products
- Risk Levels: LOW / MEDIUM / HIGH categorization
- Holdings: Aggregated view across all BTC wrappers
- Recommendations: Best yield for user's risk tolerance
Decimal Handling
BTC wrappers use different decimal precisions:
| Token | Decimals | 1 BTC in wei |
|---|---|---|
| wBTC | 8 | 100000000 |
| LBTC | 8 | 100000000 |
| tBTC | 18 | 1000000000000000000 |
| sBTC | 18 | 1000000000000000000 |
Always use the token's native decimals when converting from wei to display values.