Events - CHANCE

The logs an integrator or indexer needs for the bet lifecycle, fairness verification, and staking UX. Admin/config events are omitted.

Enums in logs

Events encode enums as uint8:

Enum	Values
`BetMode`	`0` Strike · `1` Range · `2` TieredBetter · `3` Shuffle
`SettleKind`	`0` Seed · `1` Proof · `2` PostReveal · `3` ForceRefund

Bet lifecycle

BetPlaced

Solidity

event BetPlaced(
    uint256 indexed betId,
    address indexed player,
    BetMode mode,
    uint256 stake,
    uint256 liability,
    uint256 payoutMin,
    uint8 tieredBetterCount,
    uint8 shuffleCount,
    uint8 shufflePickCount,
    uint64 commitId,
    address affiliate,
    string platform,
    string game
);

Field	Meaning
`liability`	Reserved max payout: Strike `W`, Range `P_max`, TieredBetter max bucket, Shuffle sum of K largest rungs
`payoutMin`	Range floor `P_min` (0 for Strike / TieredBetter / Shuffle)
`tieredBetterCount`	TieredBetter bucket count (0 otherwise)
`shuffleCount` / `shufflePickCount`	Shuffle rung count and pick count (0 otherwise)
`commitId`	Epoch the bet settles under
`platform` / `game`	Attribution strings - log-only, not stored on the bet

Strike’s multipleBps and mode bucket arrays are not in the event - read getBet / getTieredBetterBuckets / getShuffleBuckets or the place calldata.

BetSettled

Solidity

event BetSettled(
    uint256 indexed betId,
    uint256 payout,
    uint256 houseWinAmount,
    bool forcedTimeout,
    SettleKind settleKind
);

Field	Meaning
`payout`	Credited to the player’s claimable balance when > 0; `0` means a loss (no claim follows)
`houseWinAmount`	`max(0, stake − payout)`
`forcedTimeout`	`true` on refund paths (payout = stake, no house-win routing)
`settleKind`	Which settle path ran - `Seed` / `Proof` / `PostReveal` / `ForceRefund`

This is the terminal outcome for a bet; wins and refunds still need a claim. Partial claims can leave status Settled until the remaining payout is drained.

ClaimedUsd / ClaimedChance

Solidity

event ClaimedUsd(uint256 indexed betId, address indexed player, uint256 amount, uint256 remaining);
event ClaimedChance(
    uint256 indexed betId,
    address indexed player,
    uint256 usdSpent,
    uint256 chanceOut,
    uint256 remaining
);

remaining is the unclaimed payout left after this call (0 = fully drained, status → Claimed). ClaimedChance.usdSpent is the USD slice claimed (pre-fee); chanceOut is what landed in the player’s wallet from the net V4 buy. In a batch claimBets, one buy covers all bets and chanceOut is attributed pro-rata by net USD.

Epochs (fairness)

Solidity

event EpochOpened(uint64 indexed commitId, bytes32 commitment);
event EpochClosed(uint64 indexed commitId);
event EpochRevealed(uint64 indexed commitId, bytes32 serverSeed);
event EpochForceAdvanced(uint64 indexed commitId, uint256 pendingBets);

Event	Use it for
`EpochOpened`	Track the live `commitId` + `commitment` for placing and for proof inputs
`EpochClosed`	The epoch stopped accepting bets; seed not yet public
`EpochRevealed`	The seed is on-chain - verify outcomes or settle leftovers
`EpochForceAdvanced`	Lost-seed emergency: treat that epoch’s pending bets as refund-eligible

Never expect the seed in a rotate transaction - happy-path rotation is EpochClosed + EpochOpened with the reveal coming later via settleWithSeed or revealEpoch.

Staking

Solidity

event Staked(address indexed staker, uint256 assets);
event StakeQueued(address indexed staker, uint256 assets, uint256 activateAfterBetId, uint64 activateCommitId);
event StakeQueueCancelled(address indexed staker, uint256 assets);
event UnstakeRequested(
    address indexed staker,
    uint256 indexed requestId,
    uint256 principalAssets,
    uint256 earningsAssets,
    uint64 unlockAt
);
event UnstakeRequestCancelled(
    address indexed staker,
    uint256 indexed requestId,
    uint256 principalAssets,
    uint256 earningsAssets
);
event PrincipalClaimed(address indexed staker, uint256 indexed requestId, uint256 assets);
event EarningsClaimedUsd(address indexed staker, uint256 indexed requestId, uint256 assets);
event EarningsClaimedChance(
    address indexed staker,
    uint256 indexed requestId,
    uint256 usdSpent,
    uint256 chanceOut
);

UnstakeRequested.unlockAt drives the exit countdown UI; a tranche can also unlock earlier when SettledWatermarkAdvanced(settledThroughCommitId) passes the request epoch, or when no settleable pre-request bets remain. See Deposit & withdraw.

Live quote data

BankrollSync

Emitted after every place, settle, claim, and stake movement - a full snapshot of availableBankroll, pendingPayoutLiability, effectiveMaxMultiplierBps, maxBetCap, and maxBetLiabilityCap.

Index BankrollSync instead of polling views: a bet ticket UI can quote every constraint from this one log stream with no eth_calls.

​Enums in logs

​Bet lifecycle

​BetPlaced

​BetSettled

​ClaimedUsd / ClaimedChance

​Epochs (fairness)

​Staking

​Live quote data

​BankrollSync

Enums in logs

Bet lifecycle

BetPlaced

BetSettled

ClaimedUsd / ClaimedChance

Epochs (fairness)

Staking

Live quote data

BankrollSync