Contract methods

Curated player and integrator methods on ChancePool. Admin and keeper methods (epoch rotation, params, pause) are intentionally omitted.

Place

All four share the same tail: clientSeed (non-zero), expectedCommitId (must equal currentCommitId()), optional affiliate (zero address stores feeRecipient), and optional platform / game attribution strings (≤ 64 bytes, emit-only). Each returns the new betId.

placeStrike

Solidity

function placeStrike(
    uint256 stakeAmount,
    uint256 multipleBps,
    bytes32 clientSeed,
    uint64 expectedCommitId,
    address affiliate,
    string calldata platform,
    string calldata game
) external returns (uint256 betId);

Arg	Meaning
`stakeAmount`	USDG stake (pool pulls it via `transferFrom` - approve first)
`multipleBps`	Payout multiple in bps: `20000` = 2×. Win pays `stake × multipleBps / 10000`

placeRange

Solidity

function placeRange(
    uint256 stakeAmount,
    uint256 payoutMin,
    uint256 payoutMax,
    bytes32 clientSeed,
    uint64 expectedCommitId,
    address affiliate,
    string calldata platform,
    string calldata game
) external returns (uint256 betId);

Arg	Meaning
`payoutMin` / `payoutMax`	USDG payout band; must bracket `EV × stake`

placeTieredBetter

Solidity

function placeTieredBetter(
    uint256 stakeAmount,
    uint256[] calldata payouts,
    uint256[] calldata massWad,
    bytes32 clientSeed,
    uint64 expectedCommitId,
    address affiliate,
    string calldata platform,
    string calldata game
) external returns (uint256 betId);

Arg	Meaning
`payouts`	USDG payout per bucket (1-64 buckets)
`massWad`	Probability mass per bucket in WAD; must sum to 1e18 and satisfy the exact EV identity

placeShuffle

Solidity

function placeShuffle(
    uint256 stakeAmount,
    uint256[] calldata payouts,
    uint256[] calldata pickIndexes,
    bytes32 clientSeed,
    uint64 expectedCommitId,
    address affiliate,
    string calldata platform,
    string calldata game
) external returns (uint256 betId);

Arg	Meaning
`payouts`	USDG payout per rung (1-64 rungs)
`pickIndexes`	Distinct seat indexes in `[0, N)`; entropy permutes rungs, then those seats pay

Claim

All claim methods are bettor-only (msg.sender must be the bet’s player). amount = 0 claims the whole remaining payout; a positive amount claims a slice and leaves the bet Settled until it is fully drained. Shared payout choice: claimAsChance = false pays USDG from bankroll cash (no claim fee); true takes claim-as-CHANCE fees from the claimed USD, then spends the net remainder buying CHANCE on the V4 pool. minChanceOut floors that net buy.

Method	Signature	Use when
`claimBet`	`claimBet(uint256 betId, uint256 amount, bool claimAsChance, uint256 minChanceOut)`	The bet is settled, or its epoch seed is already revealed (it settles then claims in one tx). Reverts `NotRevealed` if pending and unrevealed
`claimBetWithProof`	`claimBetWithProof(uint256 betId, uint256 entropy, bytes proof, uint256 amount, bool claimAsChance, uint256 minChanceOut)`	You have the API’s entropy + Groth16 proof - settle and claim in one tx before the epoch closes
`claimBets`	`claimBets(ClaimBetRequest[] requests, bool claimAsChance, uint256 minChanceOut)`	Batch claim; each request is `(betId, entropy, proof, amount)` with an optional per-bet proof. When claiming CHANCE, one V4 buy covers the total net and `minChanceOut` floors the batch

Losses never revert a claim - a settled zero-payout bet is a silent no-op. USDG claims revert InsufficientBankroll if the pool’s free cash cannot cover the payout. Partial claims emit remaining on ClaimedUsd / ClaimedChance.

Stake (bankroll)

Deposits may queue while settleable bets exist (StakeQueued); they mint shares once that cutoff clears (activateStake or the next settle). Exits are tranches: each requestUnstake / requestUnstakeAll gets its own cooldown and claim.

Method	Signature	What it does
`stake`	`stake(uint256 assets)`	Deposit USDG. Mints immediately when the bankroll is quiet; otherwise queues. Public only when `stakingEnabled` is on, otherwise operator-only (`StakingDisabled`)
`activateStake`	`activateStake(address staker)`	Permissionless mint of a ready queued deposit
`cancelPendingStake`	`cancelPendingStake()`	Return queued USD while it is still blocked (never minted, never underwrote)
`requestUnstake`	`requestUnstake(uint256 principalAssets, uint256 earningsAssets)`	Open a new exit tranche for a principal and/or earnings slice
`requestUnstakeAll`	`requestUnstakeAll()`	Request all currently free principal + earnings as one tranche
`cancelUnstakeRequest`	`cancelUnstakeRequest(uint256 requestId)`	Abort one tranche
`claimStakerPrincipal`	`claimStakerPrincipal(uint256 requestId, uint256 assets)`	Withdraw an unlocked tranche’s principal as USDG (`assets = 0` = all remaining)
`claimStakerEarnings`	`claimStakerEarnings(uint256 requestId, uint256 assets, bool asChance, uint256 minChanceOut, address affiliate)`	Withdraw an unlocked tranche’s earnings as USDG or as CHANCE

See Deposit & withdraw and Rewards.

Views you’ll use

View	Returns
`currentCommitId()`	Live epoch id - pass as `expectedCommitId` when placing
`getBet(betId)`	Full `Bet` struct (player, mode, stake, liability, status, payout, claimed, …)
`getTieredBetterBuckets(betId)`	TieredBetter `payouts[]` + cumulative masses (empty for other modes)
`getShuffleBuckets(betId)`	Shuffle place-time `payouts[]` + `pickIndexes[]` (empty for other modes)
`validateStrike` / `validateRange` / `validateTieredBetter` / `validateShuffle`	Structural EV checks only - they do not apply size, Kelly, bankroll, or mode flags
`pendingBetCount(player)` / `getPendingBetIds(player, offset, limit)`	Actionable bets (pending, or settled with unclaimed payout); pages cap at 100
`availableBankroll()`	Free USDG underwriting new bets
`maxBetCap()` / `maxBetLiabilityCap()` / `maxBetKellyCap(stake, payoutLo)` / `effectiveMaxMultiplierBps()`	Live place gates - see Bet constraints
`computeCommitment(seed)` / `computeEntropy(seed, clientSeed, betId)`	Poseidon helpers for fairness verification
`withdrawablePrincipal(staker)` / `withdrawableEarnings(staker)`	Unlocked tranche USD claimable right now
`unstakeRequestAt(staker, requestId)` / `previewStakerPosition(staker)`	Tranche + position readiness

Permissionless settlement

settleBet(betId), settleBets(betIds), settleWithSeed(betId, serverSeed), settleWithProof(betId, entropy, proof), and forceRefundOnTimeout(betId) are callable by anyone - settlement never depends on the operator being online. In practice the claim methods above fold settlement into the claim transaction, so most integrations never call these directly.

​Place

​placeStrike

​placeRange

​placeTieredBetter

​placeShuffle

​Claim

​Stake (bankroll)

​Views you’ll use

​Permissionless settlement

Place

placeStrike

placeRange

placeTieredBetter

placeShuffle

Claim

Stake (bankroll)

Views you’ll use

Permissionless settlement