Developers
How
is built
On this page
is a static website plus a game server and a vault contract on Elysium mainnet. The game server runs each round and the vault holds the money. Real play is open for Crash Tower, Dice, Blob Flip, Blackout, Overhang and Pinwheel while the game server reports it is ready. The $TILT token is live on mainnet; staking is not.
- Site
- Static pages served from
dev/ - Real play
- Game server, Elysium mainnet vault, USDC
- Network
- Elysium, chain 99901
- $TILT
- Live on mainnet; staking is not
At a glance
| Part | Status | Where in the repository |
|---|---|---|
| Site and game pages | Live | dev/ |
| Chat and friends | Live in simulation mode | dev/social/ |
| Bridge page (USDC and HYPE through Elysium's canonical bridge) | Live on mainnet; swap off | dev/bridge.html |
Game server: accounts, game API, Hold'em hand service | Real play is open when it reports ready | server/ |
| Seed commits, drand salts and reveals | Server Elysium adapter, for Real rounds | Server Elysium adapter |
The vault | Deployed on Elysium mainnet | contracts/src/ |
| $TILT token | Live on mainnet; minted by the vault on losses | Elysium, address on Networks |
| $TILT staking | Coming soon; no staking contract on mainnet | None yet |
The site today
The whole site is the dev/ folder, served as static files. The repository's vercel.json serves the lobby (index.html) at / and every other path to the file of the same name in dev/. Game pages have no build step: each one is a single HTML file with its own inline script.
| Page | File | What it does |
|---|---|---|
| Lobby | index.html | Game lobby |
| Crash Tower | crash.html | Cash out before the multiplier crashes |
| Dice | dice.html | Roll over or under a line |
| Blob Flip | flip.html | Call heads or tails |
| Blackout | blackout.html | 49 cells, 3 hidden shorts, cash out between picks |
Hold'em | holdem.html | Coming soon: not playable yet |
| Overhang | overhang.html | Build a tower, cash out before it topples |
| Pinwheel | pinwheel.html | Fire pins, cash out before one clashes |
| Profile | profile.html | Your real-money stats |
| Bridge | bridge.html | Bridges USDC and HYPE between HyperEVM and Elysium |
To run the site locally, serve the folder with any static server, for example python3 -m http.server 8899 --directory dev, then open http://127.0.0.1:8899/.
Chat and the bridge
The chat dock runs in simulation mode: it works inside your browser with bot regulars, and nothing leaves your browser. A Firebase back end for real chat is written but not connected. See Chat, friends and tips.
The bridge page sends your transactions from your wallet to Elysium's canonical bridge contracts, between HyperEVM (chain 999) and Elysium (chain 99901).
's own contracts are not involved, and
never holds the funds. See Bridge USDC and HYPE.
Server and contracts
your browser (the same static pages)
| HTTPS + WebSocket
v
game server (Node 22, uWebSockets.js)
|-- account host ....... sessions, wallet sign-in, USDC ledger
|-- game engine ........ secret seed chains, rounds, settlement
|-- Tilt Hold'em service one committed deck per hand, street decisions
| seed commits, drand salts, reveals, settlements
v
Elysium (chain 99901, HYPE for gas)
|-- the Tilt vault ..... USDC deposits, bankroll, payout queue,
| seed commits, drand salt check (BLS)
|-- $TILT token ........ minted by the vault on losses
|-- $TILT staking ...... not live (no contract yet)
Game server
One Node.js process (Node 22 or later) built on uWebSockets.js. It mounts three parts, each optional:
- Account host. Opaque session tokens, wallet sign-in with a signed message, and the ledger. Ledger amounts are integer units of 1/1,000,000 USDC. Through the account host a signed-in player can only rename the account or link a wallet; every money move on the ledger is a command from the server itself.
- Game engine. A deterministic state machine: it never reads the clock or
Math.randomon its own, outcomes come only from revealed seed-chain seeds, and a rejected command changes nothing. It emits money moves that the server applies to the ledger in one atomic step.
Hold'em service. Hand-by-hand HTTPS routes. It commits a seed for each hand, deals from that committed deck, applies each bet or fold in order and settles through the vault. It sends you only the cards you have reached so far.
State is kept as JSON snapshots plus append-only journals in a data folder. The endpoints and messages are described in Game server API.
Seed chains, commits and drand salts
- Each table plays a SHA-256 hash chain of secret seeds: 10,000 seeds per chain for the originals. Each Hold'em hand gets a chain of one seed. Only the chain's commit, the SHA-256 of its first seed, is public at the start.
- For Real rounds, the commit is posted to the vault before any stake, naming a drand evmnet beacon round at least 3 seconds after the commit. The salt is the SHA-256 of that round's beacon signature, which the vault checks on-chain. Nobody running
or the Elysium sequencer controls that beacon. - Each round's outcome is HMAC-SHA256 of the round's seed over a message that includes the domain tag
tilt:v1, the table, the round index and the salt. - Seeds are revealed after their rounds, and anyone can check a revealed seed against the commit.
The drand round math and salt derivation are in the shared engine; the onchain salt check is in the vault contract. Exact formats: fairness specification.
The vault and $TILT
- The
vault holds USDC: player deposits and withdrawals (withdrawals of your free balance are never pausable), the bankroll, per-table limits, seed commits, drand salts and reveals, and round settlement with a first-in, first-out payout queue for any win the bankroll cannot cover at once. Swept rake is split between stakers, a reserve and the treasury, 40/30/30 by default. - $TILT is an ERC-20 on Elysium mainnet, minted by the vault when a player's loss settles, on a locked curve with a 1,000,000,000 supply cap and a 700,000,000 loss-mint budget. See Contracts.
- $TILT staking is not live. There is no staking contract on mainnet, and the staker slice of revenue stays held in the vault.
The vault is deployed on Elysium mainnet; its address is on Contracts. Functions, events and safety properties: Contracts. Player-facing explanations: $TILT overview and How every win gets paid.