Build
Architecture
One core contract, a few helpers, and clear roles.
Check your version
The contracts still use the working name Gigapot (for example Gigapot and GigapotLens). This reference follows contract code e1056f7. The test network runs older code from 19 September (8a20efb). The launch contracts add fee bands, a Backer allowlist, prize minimums and the 25% jackpot; their calls will be listed here once the audited ABI is final. Use the ABI that matches the contracts you call.
The contracts#
| Contract | What it does |
|---|---|
| Gigapot | The core. Rounds, batches, results, prize credits, Backer accounting and the pool’s money. |
| TicketRights | Slices, transfers, splits, signatures, vouchers and claims. |
| FeeVault | Custodies purchase fees, pays Highroll’s cut and records referral commissions. |
| PythDrawSource + SP1 verifier | Random numbers and proof checks, kept separate. |
| RelayGateway | Buys lines for routed purchases. Holds nothing. Not a bridge. |
| GigapotLens | Read-only summaries: Backer value, positions, batches and slices. |
| EarnVault | Tracks pool money placed in an outside ERC-4626 vault. |
| TierPricing, EpochAccounting, RoundPipeline | Three linked libraries that run on the core’s state. |
Who can do what#
| Role | Can do | Limits |
|---|---|---|
| Anyone | Buy, manage their own lines, submit valid proofs | Normal ownership, payment and proof checks |
| Owner | Change settings for future rounds, unpause | The plan is a Safe plus a timelock. Check what’s deployed. |
| Guardian | Freeze only | Can’t unpause. Existing prizes and exits stay. |
| Treasurer / treasury | Move pool money out and back | exportCapital: treasurer. returnCapital: treasurer or treasury. |
| Settlement operator | Report results early | Proofs are still needed before claims. |
Where data lives#
Purchases create batches that never change. materializeQueue hashes them in small steps. SP1 proofs tie together the queue, the winning numbers and the claim tree.
Read state from the core and GigapotLens. Chosen numbers and referral details come from events and calldata.
Deployed modules
The older test record lists a deployed Lens, an SP1 Groth16 verifier and a TierPricing library address. It doesn’t show EpochAccounting or RoundPipeline deployed. Check a new manifest before using the e1056f7 ABI against a live address.