Reference

FAQ and troubleshooting

Release-safe answers for addresses, quotes, failed transactions, stuck games, claims, and Community markets.

Source-level guide · live values pending release

Release, network, and address questions

Where are the contract addresses?: Only an accepted immutable manifest is an address book. This snapshot intentionally publishes no placeholder V3 addresses because the public Testnet release is still in progress.
Which network?: Source targets Robinhood Chain Testnet 46630. Robinhood Chain Mainnet 4663 is not deployed and remains NO-GO.
Does a green `/health` mean I can play?: No. Require the relevant /ready layer plus matching release/manifest/finalized identity, open capacity, active Catalog, and a successful exact Gateway simulation.
Why did the API return 503?: A runtime, RPC, finality, journal, proof, worker, or readiness check failed closed. It is not a zero balance, no entitlement, or permission to continue.

Symptom	Likely cause	Safe response
Settlement quote expired or used	≤60s request deadline, quote expiry, quote ID or signer nonce already consumed	Discard it, reload Status, use a fresh random request nonce, re-authorize and requote
Max FLIP input exceeded	Pool moved or signed exact input is above the user cap	Do not widen silently; show the new quote and obtain fresh confirmation
Allowance failure	Wrong spender/token or allowance below the exact signed input	Resolve Router from the same manifest and approve only the shown limit
Canonical trade output is lower than expected	3% Hook fee, 0.30% LP fee, price impact, slippage, or exact-in gross/net branch	Read both fee events and raw balance deltas; use exact-output when receipt must be fixed
Community trade rejected	Token has no finalized Factory-registered PoolKey, deadline/limit failed, or wrong Router	Read the launch detail and `registeredPool(token)` from the accepted Community Router

Coin is still AwaitingRandomness: Before the frozen time/block boundary, wait. After either boundary, anyone may call refundExpired; the player receives B+F and the Provider Bond separately pays frozen additionalReserveRaw.
Parity has no report: The report deadline is inclusive for submission. Starting one second later, voidExpired returns B+F and slashes the responsible Reporter Bond for additionalReserveRaw.
Mystery use did not clear: A settled Ticket completes its use; a protocol timeout/VOID restores it. If the best-effort callback failed, call retryMysteryAccess in the matching terminal state.
Fee has not reached Treasury: After a settled win/loss, anyone may call flushFee. Refunded/voided fees are returned and cannot be flushed as revenue.

01
Read the liability
Resolve the receipt-derived liability key and query finalized /v3/liabilities/:liabilityKey plus getLiability(game, id).
02
Retry before SLA
While PurchasePending and before cashFallbackAt, attemptJitPurchase is permissionless. A failed quote/venue attempt leaves the full liability intact.
03
Close after SLA
At or after the SLA, anyone may call makeCashClaimable; this changes state but pays nobody.
04
Winner claims
Only liability.player may call claimCash. It pays the entire prize notional to that player exactly once and cannot coexist with StockDelivered.
05
Repair capacity accounting
If the terminal payout succeeded but capacity close emitted failure, call retryJitCapacityClose after confirming StockDelivered or CashClaimed.

Who is eligible?: A non-excluded address whose finalized snapshot FLIP balance is at least ceil(totalSupplyRaw/100,000), the minimum whole raw-unit amount that reaches 0.001% of fixed supply.
How is my amount calculated?: floor(fundedStockRaw × accountBalanceRaw / eligibleSupplyRaw). Each account rounds down; leftover raw units are recycled dust.
Do I need to stake?: No. Eligibility is a fixed-block wallet-balance snapshot after policy exclusions.
Can somebody steal my proof?: Anyone can relay claim, but the leaf fixes account and the contract transfers only to that account.
Why is a claim missing?: The epoch may be Funded but not Active, the address may be below threshold/excluded, the floor may be zero, or evidence may be unavailable. A 503 must not be displayed as zero.

Does creation prove the object is real?: No. It commits identity and metadata hashes. Custody, authenticity, legal rights, issuer solvency, and provenance still require independent evidence.
Is every Community token a game reward?: No. Creation, public trading, eligibility review, and inclusion in a new active Reward Catalog are separate transitions.
Where did unused launch liquidity go?: Read LaunchLiquiditySettled and launchAccounting. V4 rounding may create exact token/USDG refunds; requested contribution must not be presented as actual spend.
Why is Mainnet launch blocked?: The public-mempool CREATE2 initialization race needs a fail-closed private builder or audited Factory-only Guard Hook before Mainnet.

Chain ID, release, manifest hash, finalized block/hash, and the Status/readiness response timestamp.
Transaction hash and receipt status; Game/Router address resolved from the manifest; emitted Bet/Ticket/Request/liability ID.
Exact endpoint path, HTTP status, public reasonCode, and request ID—never a private key, seed phrase, bearer token, or raw secret.
For Parity: target, source URL identity, capture timestamps and evidence hash. For JIT: liability key and quote ID. For Holder: epoch/index/account/root.
Expected versus actual raw integer amounts and token decimals. Screenshots may help explain UI state but never replace these identifiers.