How It Works
Quantum Raffle is a single on-chain contract. Players send ETH to enter; the contract tracks every ticket, builds the two prize pools, decides the Power Slots when a game ends, and pays winners out in ETH. There are no tokens, no admin upgrades, and nothing happens off-chain — everything you need to verify a game is on the contract itself.
What you can rely on
| ETH-only | Entries and prizes are denominated in ETH. There are no ERC-20 paths to reason about. |
| Non-upgradeable | Once deployed, the rules are immutable. There is no proxy, no admin switch, and no way for anyone — including the host — to change the contract's behavior after the fact. |
| Self-contained | No proxies, no delegatecall, no external token or oracle dependencies. The contract holds the ETH and runs the whole game by itself. |
| Per-game config lock | Every parameter — entry amount, deadline, the log bases, the pool split, the deposit fee, and the minimum-ticket floor — is locked in the moment a game starts. The host can queue changes for the next game, but can never alter the game you're already in. |
| Dual entry path | Sending ETH with no calldata credits prizes to the sender. Sending exactly 20 bytes of calldata routes prizes to the address you encode — so you can enter from a hot wallet but have winnings land in a cold wallet. |
The host role
Each deployment has a single host. The host opens games, can configure the next game's parameters, sweeps the final cohort's leftover pool, and withdraws any accrued deposit fee. The host cannot touch an active game's rules, take players' pooled ETH, or stop a winner from claiming. See the Host Guide for the full scope of the role.
Where the ETH goes
Every entry is split, in fixed proportions locked at game start, between:
- The Grand Prize Pool — paid out equally to the Power Slots when the game ends. See Power Slots.
- The Virality Prize Pool — paid out per-cohort to earlier entrants as the game grows. See Adoption Bonus & Cohorts.
An optional deposit fee can be skimmed to the host before that split, and a small amount of dust from integer division stays locked in the contract. The Prize Math Specification and Worked Examples account for every wei.
Interacting with the contract
Entering is just sending ETH. Reading game state and claiming prizes are plain function calls that any wallet, frontend, bot, or agent can make directly. Start with the Public Interface and Events & Errors.