Tilt Docs Play
Docs

Developers

How Tilt is built

On this page
  1. At a glance
  2. The site today
  3. Chat and the bridge
  4. Server and contracts
  5. Game server
  6. Seed chains, commits and drand salts
  7. The vault and $TILT

Tilt 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

PartStatusWhere in the repository
Site and game pagesLivedev/
Chat and friendsLive in simulation modedev/social/
Bridge page (USDC and HYPE through Elysium's canonical bridge)Live on mainnet; swap offdev/bridge.html
Game server: accounts, game API, Tilt Hold'em hand serviceReal play is open when it reports readyserver/
Seed commits, drand salts and revealsServer Elysium adapter, for Real roundsServer Elysium adapter
The Tilt vaultDeployed on Elysium mainnetcontracts/src/
$TILT tokenLive on mainnet; minted by the vault on lossesElysium, address on Networks
$TILT stakingComing soon; no staking contract on mainnetNone 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.

PageFileWhat it does
Lobbyindex.htmlGame lobby
Crash Towercrash.htmlCash out before the multiplier crashes
Dicedice.htmlRoll over or under a line
Blob Flipflip.htmlCall heads or tails
Blackoutblackout.html49 cells, 3 hidden shorts, cash out between picks
Tilt Hold'emholdem.htmlComing soon: not playable yet
Overhangoverhang.htmlBuild a tower, cash out before it topples
Pinwheelpinwheel.htmlFire pins, cash out before one clashes
Profileprofile.htmlYour real-money stats
Bridgebridge.htmlBridges 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). Tilt's own contracts are not involved, and Tilt 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.random on 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.
  • Tilt 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 Tilt 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 Tilt 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.