Protocol overview
User-facing loops
| Loop | Action | Payout |
|---|---|---|
| Takeover (Crown) | Pay ETH to take the Mine | 75% prev King, 25% to veCLAIM holders |
| Furnace (Barons) | Enter (ETH/CLAIM/token) → veCLAIM | ETH royalties via ShareholderRoyalties |
Entry token defaults: If user has CLAIM, default to CLAIM. Otherwise ETH. Collect & Lock uses ETH.
Royalty defaults: Collect ETH (mode 0). Optional: Collect & Lock (mode 1).
Protocol primitives
- Crown slot — can be taken over for ETH
- veCLAIM locks — earn ETH from every takeover
- Furnace — converts entry value into veCLAIM with reserve-backed bonus
Contract map
Core (v1.0.0):
| Contract | Purpose |
|---|---|
| ClaimToken | ERC20 CLAIM |
| VeClaimNFT | ERC721 veCLAIM lock positions |
| MineCore | Reigns, takeovers, emissions |
| Furnace | Entry → lock (bonus + LP top-up) |
| ShareholderRoyalties | ETH-per-ve index (Barons) |
| MarketRouter | Lock management (0% fee, CLAIM prices) |
| LpStakingVault7D | Stake Aerodrome LP → harvest CLAIM |
Supporting:
- EntryTokenRegistry — per-surface allowlist + deterministic swap routing
- DexAdapter — Aerodrome v2 router wrapper
- DelegationHub — opt-in bot sessions (EIP-712)
- MaintenanceHub — permissionless upkeep batching
Genesis:
- LaunchController, GenesisLPVault24M
Data flow
Launch timeline
The protocol launches before config freeze. This is intentional.
| Phase | State | Admin powers | Guardian powers |
|---|---|---|---|
| Pre-freeze (launch through audit) | Live and playable | Can re-wire contract addresses (apply audit fixes) | Pause/unpause |
| Post-freeze (permanent) | Immutable | None (config locked forever) | Pause/unpause only |
Sequence: deploy → wire → launch → external audit → apply fixes if needed → freezeConfig() (one-way, irreversible).
The pre-freeze window allows the team to ship fixes from the external security audit before the point of no return. After freeze, the protocol runs on code alone.
Trust boundaries
Immutable after freeze:
- Core wiring (MineCore, VeClaimNFT, ShareholderRoyalties, MarketRouter, Furnace)
- Event schema (indexers depend on it)
Pre-freeze only (removed after freezeConfig()):
- Admin contract re-wiring (registry pointers, router addresses, vault addresses)
Governance-controlled (persists post-freeze):
- EntryTokenRegistry allowlist + routing
- Guardian pausing (takeovers, locking, trading)
Permissionless:
- MaintenanceHub.poke()
- LP fee harvest (bounty-based)