A small protocol surface with several ways in.
The dashboard, swap, liquidity, and earn pages share one wallet and one BNB Smart Chain connection, but each action settles through a different contract path.
Product map
| Surface | What it reads | What it can write |
|---|---|---|
| Dashboard | Protocol metrics, token prices, wallet balances | Nothing by default |
| Swap | Quotes, balances, allowances, pool reserves | Approval, permit, wrap/unwrap, or swap |
| Liquidity | Pair address, reserves, wallet LP positions | Approval, add liquidity, remove liquidity |
| Earn | MasterChef and SmartChef pool state | Approval, deposit, withdraw, harvest |
| Tokens | Curated identity plus market endpoints | Opens prefilled swap or liquidity flows |
| Governance | Informational roadmap | No live proposal action in the main app |
Protocol layers
Interface layer
Next.js, wagmi, viem and RainbowKit connect the browser to BNB Smart Chain. A fallback list of BSC RPC endpoints is configured for reads and transaction tracking.
Routing layer
The quote engine probes candidate paths through base assets such as WBNB, BUSD, USDT, ETH, BBKFI and WBBK, then compares eligible providers.
AMM layer
The BitBlocks Router calls the BitBlocks Factory and V2 pair contracts. Pairs hold reserves, apply the constant-product invariant, and mint LP tokens.
Reward layer
One MasterChef manages many BBKFI pools. Separate SmartChef contracts each manage one pre-funded reward schedule over a defined block range.
Related BitBlocks products
The Finance app is one product in the broader BitBlocks ecosystem:
- BitBlocks ecosystem — the network and project landing site.
- WBBK bridge — conversion between BBK and its BNB Chain representation.
- BitBlocks explorer — explorer for the BitBlocks chain.
- Voting site — a separate ecosystem voting experience.
The bridge and vote site are separate applications. Their contracts and behavior are not inferred from the BitBlocks Finance frontend; verify their own prompts and documentation before signing.
Design boundaries
- The Finance app is configured for BNB Smart Chain only.
- Native BNB is represented as WBNB inside AMM paths; direct BNB ↔ WBNB actions use wrap/unwrap logic.
- WBBK V2 is the curated active WBBK asset. WBBK V1 remains searchable but is labeled deprecated in the interface configuration.
- 1inch is optional and only participates when its provider flag and server credential are configured.
- Protocol routes and external routes have different spender addresses. The app derives the approval target from the selected quote.