Build on 4626
Build on 4626
How the 4626 contracts fit together on Base, and where to start when you integrate.
Lookup
Registry4626
Creator coin → contracts
Vault
1000:1CreatorOVault
Holds the creator coin
Share
ShareOFT
Tradable, cross-chain
Fees
Gauge
Splits fees, holds the pot
Prizes
LotteryManager
Draws winners with VRF
Prices
CreatorOracle
TWAP price feed
Launch
CCA launch arm
Runs the share auction
Every vault is a small per-creator stack of contracts, built from shared infrastructure (the batcher, factories, and Registry). If you know a creator coin's address, the Registry gives you everything else.
Start here
| I want to | Go to |
|---|---|
| Read a vault's state onchain in a few lines of code | Quickstart |
| Find a live contract address | Contract addresses |
| Deposit, withdraw, or price vault shares | Vault integration |
| Know where the vault differs from plain ERC-4626 | ERC-4626 deviations |
The per-creator stack
| Contract | What it does |
|---|---|
| Registry4626 | Maps a creator coin to its vault, wrapper, ShareOFT, gauge, and oracle |
| CreatorOVault | ERC-4626 vault that holds the creator coin and mints vault claims () |
| CreatorOVaultWrapper | Wraps 1000 vault claims into 1 ShareOFT |
| CreatorShareOFT | The tradable share (), a LayerZero OFT that charges the buy fee |
| CreatorGaugeController | Splits trade fees and holds the lottery pot |
| CCA launch arm | Runs the fair-launch share auction |
| LotteryManager4626 | Calculates odds, draws with VRF, and pays winners |
| CreatorOracle | TWAP price feed |
How a launch maps to contracts
| Phase | Stage | What happens onchain |
|---|---|---|
| 1 | Deployed | The per-creator stack is created, unfunded |
| 2 | Activated | Deposit, wrap, launch split, and Solana bridge |
| 3 | Strategies set | Charm leg (90%) and idle (10%) |
| 4 | Auction | launchDeferredAuction, then settlement to trading live |
Full detail: Vault lifecycle.
Source
All contracts are open source at github.com/wenakita/4626/contracts. Reviews and formal proofs are under Security.