System design and launch status

The Game Factory handbook defines the concept brief, payout math, deterministic randomness, component lifecycle, test matrix, asset rules, metadata, submission transformation, and final report required for every future Stonks Casino game.

The required Ape Church public records are RoundQuote, RoundSettlement, VaultState, StakeActivation, and RewardStream. Exact ABI names and callback semantics will follow the official protocol specification; this project does not invent a mainnet interface.

Both games use the same economic contract: choose a wager, play against a disclosed 5% house advantage, and either lose the wager or finish on a published multiplier. A multiplier tells the player how many times the original wager the winning preview returns. A 5 APE wager settled at 3x therefore displays a 15 APE payout.

Equity Bros is a press-your-luck game about a private-equity hold. The player chooses Safer, Risky, or Extreme before the round begins. Each mode has the same eight deal stages and 25x maximum, but a more aggressive opening multiplier makes the early survival chance lower. Passing a stage moves the deal to the next published rung. Failing any attempted stage loses the complete wager.

1. Choose the capital structure.Safer uses the conservative ladder, Risky uses the base ladder, and Extreme uses the covenant-lite ladder.
2. Complete the two mandatory quarters.The player cannot exit after Q1. Passing Q2 unlocks the first cash-out decision.
3. Exit or risk everything.After Q2 through Q7, exit pays the current rung; continuing attempts the next stage and puts the entire wager at risk.
4. Finish automatically at Q8.Passing the Exit Auction settles at 25x. A failure at any quarter settles at 0x.

P(reach Q1) = (1 − 0.05) ÷ firstMultiplier
P(pass Qk | reached Qk−1) = previousMultiplier ÷ nextMultiplier
P(reach Qk) = (1 − 0.05) ÷ multiplier(Qk)
P(reach any permitted cash-out) × its multiplier = 0.95
Expected multiplier at any cash-out rung = 0.95

The Fed is a mines-style game played across 25 economic sectors. Every board contains exactly six hidden breaks and nineteen safe sectors. Choosing a safe sector advances the policy path and unlocks a larger pivot multiplier. Choosing a break ends the round at 0x. Every unrevealed sector has the same chance before its hidden status is known.

1. Lock the board.The round seed deterministically ranks all 25 sectors and fixes the six hidden break locations before the first selection.
2. Reveal one sector.A safe sector adds 25 basis points and moves to the next payout rung. A hidden break immediately loses the wager.
3. Pivot or hike again.After every safe reveal, the player may settle at the displayed multiplier or risk the full wager on another unrevealed sector.
4. Stop at twelve safe reveals.The game ends automatically at the 98.04x maximum even though seven additional safe sectors remain on the full board.

“Next reveal” is measured immediately before achieving the safe-reveal count shown. For example, after six safe reveals there are 13 safe sectors and six breaks among 19 unrevealed sectors, so the seventh reveal is safe with probability 13 ÷ 19.

After s safe reveals:
P(next sector is safe | s) = (19 − s) ÷ (25 − s)
P(next sector breaks | s) = 6 ÷ (25 − s)
P(reach safe rung k) = product of the first k conditional safe probabilities
multiplier(k) = 0.95 ÷ P(reach safe rung k)

Deterministic means the same round seed and the same player decisions reproduce the same economic result. It does not remove player agency: an Equity Bros player chooses when to exit, while a The Fed player chooses which sector to reveal and when to pivot. It prevents animations, timing, refreshes, and browser randomness from secretly changing an already committed round. Domain-separated hashes keep survival, board layout, payout ticker, and presentation data independent even though they share one round seed.

Equity Bros outcome domain: equity-bros:{mode}:outcome:{quarter}
The Fed board domain:       the-fed:v1:mine-layout:{tile}
Payout ticker domain:       separate from every survival or board domain
Presentation domain:        never read by payout calculation

Stonks Casino uses explicit, versioned product events—not unrestricted page autocapture. Before a visitor opts in, no analytics visitor identifier is created and PostHog is not initialized. Global Privacy Control automatically keeps both analytics and replay off. Analytics and masked session replay have separate choices, can be withdrawn at any time, and include a client-held credential for anonymous deletion.

Canonical event lifecycle

Public metric definitions

• Activated player: a consented visitor completing a first server-verified preview round.
• Retention: an activated player starting another verified round on day 1, 7, or 30.
• Share rate: activated players creating at least one share divided by activated players.
• Referral activation: a challenge landing that completes a verified round within seven days.
• Viral coefficient: average valid challenge landings per activated sharer multiplied by landing-to-activation conversion.
• Partner conversion: valid partner leads divided by qualified unique visitors.

Public visitor and cohort cells below 10 display <10. Public pages never expose wallet, lead, visitor, session, or raw-event records. “Preview APE” is simulated play volume only: it is not revenue, deposits, TVL, or gambling turnover. Raw analytics are retained for 180 days, replay recordings for 30 days, inactive identifiers for 13 months, share attribution for 24 months, and closed partner leads for 24 months unless deleted sooner. Privacy-safe daily aggregates are retained for lifetime reporting.

PostHog receives consented events only after D1 persistence and is used for deeper funnels, cohorts, and a 10% sample of separately consented replay sessions. Replay masks all inputs and configured sensitive text, and is completely disabled on administration, NFT application, wallet-signature, and partner-interest states. No analytics record contains a raw IP address, full user agent, URL query string, wallet signature, wallet address, seed, mine layout, lead field, or free-form game text.

A winning round selects one ticker uniformly from NVDA, AAPL, GOOG, TSM, and AMZN. APE/USD and all five stock-token prices are locked when the wager is accepted.

stockTokenAmount =
wagerAPE × lockedAPEPriceUSD × payoutMultiplier ÷ lockedStockTokenPriceUSD

New rounds must pause if any marketed ticker is inactive, halted, stale, undergoing an unresolved corporate action, or lacks sufficient reserved liquidity. Maximum wager is constrained by the least-liquid possible random ticker.

• LPs deposit APE on ApeChain through a new Ape Church product, not the existing House Pool.
• The approved bridge converts deposits into an equal-value five-stock basket on Robinhood Chain.
• LP shares track combined stock-market P&L and casino P&L in USD NAV terms.
• Settled and in-flight player payouts are reserved before any LP redemption.
• Redemptions return the maximum available pro-rata in-kind basket without consuming payout reserves.

Required controls include fresh canonical oracles, explicit slippage limits, corporate-action multipliers, per-ticker reserves, free-liquidity accounting, replay protection, retries, message ordering, and finality rules.

Equity Bros NFTs hard-stake in ApeChain escrow. Dreamweavers register non-custodially because their ERC-5192 tokens cannot transfer. Cross-chain activation and deactivation require authenticated acknowledgements. Accrued rewards remain claimable after deactivation.

Initial administration uses two-step ownership transfer so control can later move to a Safe or stronger signer. Submission contact: Telegram sixtheplug.

• Brutal v3 deterministic preview, replay, and statistical tests
• Otherside Developers consumer experience and attendee workflow
• Five-stock availability monitoring
• Official Ape Church vault, bridge, quote, and settlement specification
• Source-reviewed stock-token deployments, router, and oracle policy
• ApeChain and Robinhood Chain testnet implementation
• Independent contract, economic, bridge, and frontend security reviews
• Required eligibility policy and capped production pilot approval

No mainnet vault, bridge adapter, staking escrow, or reward-streaming contract will be deployed until the missing protocol interfaces are approved.