Validated and submitted through the Ape Church host.
STONKS CASINO / GAME FACTORY
One exact standard for every new game
This is the model handoff for turning a finance concept into a deterministic, tested, Ape Church submission-ready casino game without inventing protocol behavior.
NON-NEGOTIABLE CONTRACT
Wager in. Multiplier out.
The game consumes protocol randomness and never creates payout randomness.
Zero for a loss or one declared, liquidity-bounded win multiplier.
The approved Stonks host converts value into one of five stock tokens.
Stock conversion, price locking, reserves, bridging, and Robinhood Chain settlement stay outside the individual game. If Ape Church has not supplied an interface, the implementation must stop at a typed adapter and label the feature as unavailable.
EXECUTION ORDER
Concept to reviewed pull request
- Read current authority.Official build docs, template README and SKILL.md, submissions README, then the canonical handoff.
- Freeze the concept.Write the wager, player choices, outcomes, maximum multiplier, house edge, randomness inputs, and retail rule in one brief.
- Approve the math first.Produce exact probabilities, expected return, liquidity ceiling, and a deterministic simulation before UI work.
- Create a new template repository.Use the official GitHub template. Do not fork it and do not build the submission inside Trade Bangers.
- Implement the lifecycle.Typed state, guarded actions, exact replay, complete reset, and cleanup on unmount.
- Build the retail experience.Plain rules, visible odds, mobile controls, reduced motion, mute, and no fake near misses.
- Run every check.Exact math, deterministic replay, large seed samples, double clicks, cleanup, TypeScript, lint, build, assets, and console.
- Transform only allowed files.Components, assets, and metadata move into the three exact submission paths.
- Open one PR.One game only. Fix automated checks and reviewer feedback. A merge is preview approval, not a guaranteed live launch.
FAIRNESS
Hard games, disclosed math
Σ(pᵢ × mᵢ) = 1 − houseEdge Σpᵢ = 1 mᵢ ≥ 0
P(reach rung k) = (1 − h) ÷ mₖ P(pass k | k−1) = mₖ₋₁ ÷ mₖ P(reach k) × mₖ = 1 − h
Volatility may create frequent losses and rare large wins, but it may not hide a larger house edge. Every displayed probability must come from the exact configuration used by the deterministic resolver.
VERIFICATION
Submission-ready means proven
Edge, ladders, tables, limits, mandatory steps, and expected value at every outcome.
Same seed, choices, path, presentation, result, and multiplier with no new transaction.
Observed results agree with theoretical probabilities within a declared tolerance.
Double clicks, invalid phases, stale replay, protocol rejection, and settlement exactly once.
Timers, frames, listeners, sound, refs, canvas, and WebGL resources are released.
Desktop, tablet, narrow mobile, keyboard, focus, reduced motion, mute, and no console errors.
npx tsc --noEmit npm run lint npm run build # plus the template's current automated test command
THREE ALLOWED TREES
Nothing extra enters the PR
components/my-game/ → components/games/<game-slug>/ public/my-game/ → public/submissions/<game-slug>/ metadata.json → submissions/<team-slug>/<game-slug>/metadata.json
Rewrite every asset URL from /my-game/... to
/submissions/<game-slug>/.... Card art must be 1:1, banner art
2:1, total assets below 10 MB, and audio MP3 or OGG only. Revenue shares must total
exactly 100 and all addresses must be re-confirmed before submission.
MODEL INSTRUCTION
Start from the canonical Markdown
The complete handoff contains the concept schema, typed state model, lifecycle contracts, cleanup pattern, metadata example, exact test matrix, submission transformation, required delivery report, and a copy-paste prompt for another model.
Read the full machine-ready handoff