# Architecture: what runs onchain

> **[Test the whole platform on devnet](https://soltoshidice-devnet.pages.dev/)** — Explore the games, community bank and SDICE Perps with test tokens, without using real money. Start at the devnet hub for its own MCP package, invitation requirements, funding instructions and verification guides.

Part of the [SoltoshiDICE playbook](https://soltoshidice.wtf/llms-full.txt). Updated 2026-10-16.

SoltoshiDICE combines six games: Cee-lo, Lucky Block slots, Texas Hold’em, blackjack, Street Fights and Rock Paper Scissors. Poker tournaments use the same private-dealing and settlement system as cash poker. The separate SDICE Perps application provides leveraged synthetic market exposure. Production uses Solana mainnet; local previews and historical devnet evidence are not production balances.

Solana programs enforce funded actions, account ownership, game state transitions, deadlines, token custody and settlement. Program-derived addresses (PDAs) identify protocol accounts and authorize token vaults; they are not ordinary operator wallets with an exportable signing key. SDICE uses Token-2022, six decimals, mint 4nCmpwne7hCoWTSpAd54uENmCgHJrHTyn4DMPCEMpump. The base-layer bank program also implements dice, blackjack, slots, profiles, staking and reward accounting. Poker, fights and RPS have separate game programs.

A browser connects a wallet, registers an onchain player profile, constructs an action and requests approval. Limited game sessions can authorize subsequent permitted moves within their scope. RPC transports requests; confirmed accounts determine the accepted state. Token transfers or escrow credits follow the program’s rules. A hand award, a claimable reward and a completed withdrawal are different balances and can require different transactions.

The 3D scene, player movement, chat, AI banker speech, UI animations and hosting execute offchain. RPC gateways, relays, coordinators and keepers deliver or advance permitted actions; they are not themselves proof that a payment occurred. The AI banker cannot choose a die, card, reel result or winner. Poker proof exchange also happens offchain, with commitments and card openings anchored to Solana. Perps uses a distinct MagicBlock rollup execution layer before base-layer settlement.

Onchain does not mean immutable or dependency-free. Program upgrade authorities remain relevant. Correct software, oracle providers, participant keys, relays, transaction inclusion and service availability still matter. Source and tests are implementation evidence, not an independent security audit or a guarantee that a deployed binary matches a source revision. Verify current program identities and chain receipts before making that claim.

This public guide and protocol manifest can be read without an account. Implementation references point into the project’s access-controlled repository and require repository permission; they are included for maintainers’ traceability. Public oracle specifications, program accounts and transaction receipts can be inspected independently. A source hash or link does not establish a reproducible deployed binary.

### Sources

- [Active bank configuration (repository access required)](https://github.com/battlejoose/hooddice/blob/main/game/chain/active.json)
- [Game architecture and integration boundaries (repository access required)](https://github.com/battlejoose/hooddice/blob/main/game/docs/MODULAR_ONCHAIN_GAMES.md)