Tilt Docs Play
Docs

Developers

Contracts

On this page
  1. Overview
  2. The Tilt vault
  3. Roles
  4. Players
  5. Bankroll and revenue
  6. Tables
  7. Mainnet tables
  8. Tilt Hold'em table (Coming soon)
  9. Rounds and settlement
  10. Fairness
  11. Payout queue
  12. Admin
  13. Events
  14. Safety properties and limits
  15. EIP-712 consent
  16. The $TILT token
  17. Staking (Coming soon)
  18. Future mainnet allocation (Coming soon)
  19. BLS verifier
  20. Build and test
  21. Deployment status

Tilt's vault is deployed on Elysium mainnet, with an escrow contract and immutable play-session and beacon helpers. Player free funds, locked stakes and house revenue are separate accounting buckets. The $TILT token is live and wired to the vault. There is no staking contract on mainnet yet.

Network
Elysium, 99901
Settlement
USDC, 6 decimals
Language
Solidity 0.8.24, Foundry
Vault deployment block
7,672,722

Overview

  • The Tilt vault: free deposits/withdrawals, house rounds, bankroll, FIFO winning-profit debt and daily revenue.
  • PokerEscrow: created with the vault. Tilt Hold'em does not use it, and no player-versus-player table is configured on mainnet.
  • PlaySessionVerifier: immutable grant verification and cumulative session stake limits; house play only.
  • DrandBeaconVerifier: immutable BN254 verification helper for the named beacon.
  • The $TILT token: live on mainnet, minted by the vault on losses. There is no staking contract on mainnet yet.

The Tilt vault

Contract amounts are raw token units: 1 USDC equals 1,000,000. Legacy fields named amountCents or lossCents still contain micro-units. A Tilt Hold'em ante is in whole cents, and the vault locks 40,000 micro-units per ante cent, which is four antes.

Roles

A dedicated operator relays exact player consent and manages game timing/outcomes. The owner configures/pauses/rotates roles and can withdraw only permitted house bankroll. Neither role can withdraw player free balance as house funds. Today the owner is a single wallet. Outcome proofs and operator continuity remain part of the trust model. The role addresses are on Networks and addresses.

Players

deposit requires USDC approval and credits free balance. withdraw transfers available free balance to the wallet and has no pause check. Locked stakes and unpaid queue debt must become free balance before withdrawal. Plain token transfers do not create deposits.

Bankroll and revenue

fundBankroll explicitly funds house accounting, filling needed queue funds first. Owner bankroll withdrawal excludes live exposure and undistributed net profit, and is held while debt is queued. House losses and gross wins offset in one daily account. Tilt Hold'em has no rake. Player deposits/top-ups/refunds/queue service are not revenue.

After at least 86,400 seconds, the daily close requires cleared house rounds, exposure and queued debt, and no open legacy poker hands. Positive net profit splits 40% stakers/30% retained reserve/30% treasury (set by the deployment script). With no staking contract, the 40% staker slice stays held in the vault. Deficits offset later gains. The internal reserve is nonwithdrawable and is not spendable bankroll. Legacy stake-rate rake uses a separate sweep.

Tables

Tables set activity, maximum stake/payout and loss-mint policy. Ordinary fee caps are at most 1,000 basis points; the special10,000 marker selects daily net-profit accounting, not a 100% fee. Relevant settings freeze when the round opens.

Mainnet tables

The owner set these limits on the mainnet vault. The table id is keccak256 of "<game>:<tableId>". Every table uses rakeBps 10,000 (the daily net-profit marker used by every house table) and mintOnLoss true, so losses on these tables mint $TILT.

TableTable id (bytes32)maxPayoutBpsmaxStakeState
dice:dice-main0x73c958f36ea3d40c208506a29739a6138f7c5bb4fed573037d5b53557db7c8f2492,4635,000,000 (5.00 USDC)Active
flip:flip-main0x945e365b8858fe15d4f7aa71ffaac0fdaeb6224e007339b7af2a5ab33eab6a1919,6005,000,000 (5.00 USDC)Active
blackout:blackout-main0xa51b65bcfcf89d5046962a1c3adfa9fffa5ac20d57400b42b04d815e65237dd1186,3325,000,000 (5.00 USDC)Active
crash:crash-main0x76ca4bfecbda1f47d46e35b4bee00aa156fee834f75c089a304d014fd9a1efab400,0005,000,000 (5.00 USDC)Active
overhang:overhang-normal0x3b885bde4e847618d1eea242b5f739be888cb8e69fa6d2a5e37c237fb5953bd1309,3805,000,000 (5.00 USDC)Active
overhang:overhang-hard0x69bb8d5c7b752ec53b7a65b8ad1f55eab10b002048314f794a55d2bea78b76c82,508,800800,000 (0.80 USDC)Active
pinwheel:pinwheel-steady0x56966f377b2d64c021ab5f1d8c486b7d416c28b63bdf130c6a205b3e4f1c2977194,0005,000,000 (5.00 USDC)Active
pinwheel:pinwheel-wild0xff2f4a122ccda02163f790e5ab95299a9f4112e97f9f557533bec636a844cad7436,5004,640,000 (4.64 USDC)Active

These limits follow the owner's launch table and the server policy for chain 99901. Crash Tower's table caps a payout at 40× the stake. No Wick table and no Tilt Hold'em table is configured on the mainnet vault.

The vault reserves stake × maxPayoutBps / 10,000 − stake when a stake locks and frees it at settlement or refund. It rejects a stake above maxStake and a payout above stake × maxPayoutBps / 10,000. The vault has no minimum stake, so the server enforces the minimums (0.10 USDC for every house game). A round freezes its table's maxPayoutBps when it opens, so a later reconfiguration cannot change an open round.

The vault does not enforce the following limits. The server does, before each stake is signed and again before it is relayed:

  • A round is admitted while its worst-case profit (the reserve above) is at most 25% of the vault bankroll.
  • It fits in the free bankroll, which is the bankroll minus the reserve already held.
  • Open reserve plus this one stays within the game's budget: 500 USDC for Overhang (both levels together) and 500 USDC for Pinwheel.

The page shows the largest stake that fits right now as Max now, or Table full when none fits. If the bankroll falls, that maximum falls with it and the odds do not change. Winnings the bankroll cannot cover queue first-in first-out as with any other house game. Per-game rules are on the Overhang and Pinwheel pages.

Tilt Hold'em table Coming soon

When Real Tilt Hold'em opens, each hand takes one wallet signature through lockStakeFor, for four times the ante, and settles through the vault with the revealed seed. The owner-signed values are rakeBps 10,000, maxPayoutBps 267,500, maxStake 20,000,000 (20.00 USDC) and mintOnLoss true. The reserve is 4 × ante, at most 20.00 USDC. The largest payout is 107 × ante, which is 535.00 USDC at a 5.00 ante and equals 26.75 times the reserve. Per-hand rules are on the Tilt Hold'em page.

Rounds and settlement

Managed house rounds accept only relayed signed stakes. The server saves an exact result, submits an opaque seal and waits for twelve canonical L2 confirmations before exposing seed/payout preimages. Any holder of the exact sealed preimage can complete it. The vault checks seed links, digest, allocation completeness/uniqueness and payout caps; game outcome math is recomputed by the verifier.

Sealed outcomes cannot turn into refunds. Eligible unsealed unfinished rounds retain a permissionless ten-minute elapsed-time refund. Losing both a sealed result's private journal and unpublished preimage is an operational recovery limitation.

Fairness

A chain root and future drand round are committed before play. Only that exact round's BLS-valid signature supplies the salt; the twelve-minute window permits delayed submission, not selection of another beacon. Outcomes and reveals use the fairness specification.

Payout queue

The returned portion of a successful payout becomes free balance; a losing stake is not refunded. Winning profit that cannot be covered queues as FIFO USDC debt. payoutDequeue services the oldest entry first, using the side bucket then unreserved bankroll, with partial payment allowed. Normal player deposits do not fund it. There is no payout deadline guarantee.

Admin

Pause closes new deposits/stakes/rounds where applicable while free withdrawals and eligible recovery remain available. Table, operator, treasury, beacon key and token/revenue configuration changes emit events. Key rotation does not replace a frozen known result.

Events

Player, stake/payout, seed, round, queue, revenue and role events support exact receipt mirroring. A UI ledger entry is not a new token transfer; confirmed custody events remain authoritative.

Safety properties and limits

  • Free player withdrawals are not pausable.
  • Player buckets are separate from owner-withdrawable bankroll.
  • Seals bind exact allocations; frozen caps/mint policy survive later configuration.
  • A failed bounded-gas $TILT mint cannot reverse valid player settlement.
  • Queued winners block revenue release; the retained reserve is not counted as available win funding.
  • Twelve canonical L2 confirmations reduce shallow-fork risk; they do not guarantee irreversible settlement or an instant result.

EIP-712 consent

House stake domain: name Tilt, version 1, chain ID 99901 and the vault address as verifying contract; type Stake(player,roundId,amount,nonce,deadline). Round ID hashes the returned UTF-8 server ID. A Tilt Hold'em hand's reserve will use the same Stake type for four times the ante. Its street decisions are signed in a separate Hold'em typed-data domain and are checked by the game server, not by the vault. Nonces are unused uint256 values, not a required sequential counter. Consent is separate from token approval.

The vault also accepts PlaySession(player,sessionKey,cap,expiry,epoch,nonce) in the same Tilt domain. The wallet signs one grant; the browser key signs each house Stake. The site asks for a spending limit and a length: the default is 20 USDC for 24 hours, and the server refuses a new approval above 500 USDC or 7 days. The vault itself enforces whatever cap and expiry the wallet signed, bounded by available USDC and table limits. Approvals made earlier keep working until they expire. Grant nonces must match the next grant nonce; stake nonces keep their existing unused-nonce rules. Session keys cannot withdraw or transfer. The per-stake wallet path remains supported. See session safety.

The $TILT token

The token is named Tilt (TILT), has 18 decimals and is deployed at 0x070b8b876415908A6E777e28133c03C6AdE93593. The token is wired to the vault, and the vault holds MINTER_ROLE, so the vault mints for each eligible realised loss inside settlement. A failed mint, bounded to 200,000 gas, emits LossMintFailed and cannot reverse a valid settlement.

ValueReading
MAX_SUPPLY1,000,000,000 $TILT
LOSS_MINT_BUDGET700,000,000 $TILT, reserved for loss mints
curveLocked()true
Curve parameterssetCurveParams(35e30, 0, 2e13): a flat 35 $TILT per 1 USDC lost to start
Minted at creation300,000,000 at block 7,942,387: 150,000,000 to the treasury and 150,000,000 to 0x063dA39D228B5B2583C9fED463D4Ea809A68fB0b

The curve slows the rate as total losses grow. It is locked, so the curve cannot be changed. How minting works for players is on How $TILT is earned. The House page reads the live supply, rate and transfer setting from the contract.

Staking Coming soon

Future mainnet allocation Coming soon

The approved plan is 50% KNTQ buy-and-burn, 25% HYPE to stakers and 25% HYPE to treasury. Game settlement stays USDC. The current contracts do not execute those purchases, burns, conversions or native HYPE claims. A separately implemented and reviewed release is required; a percentage change alone cannot implement the destinations and currencies.

Today's vault split is 40/30/30 in USDC, with the 40% staker slice held because there is no staking contract.

BLS verifier

The immutable beacon helper uses the vendored BN254 BLS implementation and EVM precompiles. Named-round commitment timing, salt storage and owner key rotation remain in the vault.

Build and test

cd contracts
forge build
forge test -vv

The repository pins Solidity 0.8.24 with optimizer/via-IR and includes vault and escrow tests. Tests use MockUSDC; mainnet uses the six-decimal USDC at the address below. Deployment and runtime evidence is separate from unit-test success.

Deployment status

ContractElysium address
Tilt vault0xE98c4F533f963027552f9972727a7ce27ab59e88
Poker escrow (created with the vault; Tilt Hold'em does not use it)0xf2793D09feB3FdA10d3B88308f787978D7ce9ab5
USDC0xb47c4C8F73F009CC0C0d3f92B388d13E293F0B65
$TILT token0x070b8b876415908A6E777e28133c03C6AdE93593
Staking contractNone yet

Owner: 0xe931bA6CF407b71b934d59598F183AC86442A0c2 (a single wallet today); operator: 0x7E0ed158ac302085212aC99923cabb0a8fAd7A4d; treasury: 0x1cEb75645C015549cF2d5EDcD0d23FCBdB308020. The vault was created at block 7,672,722 and launched with a 1,000 USDC bankroll. An earlier test release ran on a separate test network; its contracts are not listed here. Check the network settings before signing.