Contracts overview
The protocol is split into 6 main contracts.
| Contract | Purpose |
|---|---|
TokenFactory | Deploys BattleMemeToken, charges 0.01 ETH, bootstraps LP via the hook |
BattleMemeToken | ERC-20 with mint/burn gated to the hook + freeze flag |
BattleHook | Uniswap V4 hook: state machine, LP bootstrap, fee accounting |
BattleOrchestrator | Queue, warmup, rounds, scoring, elimination, graduation |
ClaimManager | Loser → winner burn-to-claim |
GraduationLP | Per-winner LP custodian (wide + wall, locked in-protocol) |
VoucherManager | Independent creator-promo (ECDSA-signed vouchers) |
Hook permissions
The BattleHook is deployed with all 14 v4 callbacks enabled (0x3FFF).
Network
Ethereum mainnet.