Developers
Contracts
On this page
- Overview
- The
vault - Roles
- Players
- Bankroll and revenue
- Tables
- Mainnet tables
Hold'em table (Coming soon)- Rounds and settlement
- Fairness
- Payout queue
- Admin
- Events
- Safety properties and limits
- EIP-712 consent
- The $TILT token
- Staking (Coming soon)
- Future mainnet allocation (Coming soon)
- BLS verifier
- Build and test
- Deployment status
'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
vault: free deposits/withdrawals, house rounds, bankroll, FIFO winning-profit debt and daily revenue. PokerEscrow: created with the vault.
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
vault
Contract amounts are raw token units: 1 USDC equals 1,000,000. Legacy fields named amountCents or lossCents still contain micro-units. A
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.
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.
| Table | Table id (bytes32) | maxPayoutBps | maxStake | State |
|---|---|---|---|---|
dice:dice-main | 0x73c958f36ea3d40c208506a29739a6138f7c5bb4fed573037d5b53557db7c8f2 | 492,463 | 5,000,000 (5.00 USDC) | Active |
flip:flip-main | 0x945e365b8858fe15d4f7aa71ffaac0fdaeb6224e007339b7af2a5ab33eab6a19 | 19,600 | 5,000,000 (5.00 USDC) | Active |
blackout:blackout-main | 0xa51b65bcfcf89d5046962a1c3adfa9fffa5ac20d57400b42b04d815e65237dd1 | 186,332 | 5,000,000 (5.00 USDC) | Active |
crash:crash-main | 0x76ca4bfecbda1f47d46e35b4bee00aa156fee834f75c089a304d014fd9a1efab | 400,000 | 5,000,000 (5.00 USDC) | Active |
overhang:overhang-normal | 0x3b885bde4e847618d1eea242b5f739be888cb8e69fa6d2a5e37c237fb5953bd1 | 309,380 | 5,000,000 (5.00 USDC) | Active |
overhang:overhang-hard | 0x69bb8d5c7b752ec53b7a65b8ad1f55eab10b002048314f794a55d2bea78b76c8 | 2,508,800 | 800,000 (0.80 USDC) | Active |
pinwheel:pinwheel-steady | 0x56966f377b2d64c021ab5f1d8c486b7d416c28b63bdf130c6a205b3e4f1c2977 | 194,000 | 5,000,000 (5.00 USDC) | Active |
pinwheel:pinwheel-wild | 0xff2f4a122ccda02163f790e5ab95299a9f4112e97f9f557533bec636a844cad7 | 436,500 | 4,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
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.
Hold'em table Coming soon
When Real
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
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
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
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), 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.
| Value | Reading |
|---|---|
MAX_SUPPLY | 1,000,000,000 $TILT |
LOSS_MINT_BUDGET | 700,000,000 $TILT, reserved for loss mints |
curveLocked() | true |
| Curve parameters | setCurveParams(35e30, 0, 2e13): a flat 35 $TILT per 1 USDC lost to start |
| Minted at creation | 300,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
| Contract | Elysium address |
|---|---|
vault | 0xE98c4F533f963027552f9972727a7ce27ab59e88 |
Poker escrow (created with the vault; Hold'em does not use it) | 0xf2793D09feB3FdA10d3B88308f787978D7ce9ab5 |
| USDC | 0xb47c4C8F73F009CC0C0d3f92B388d13E293F0B65 |
| $TILT token | 0x070b8b876415908A6E777e28133c03C6AdE93593 |
| Staking contract | None 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.