> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hoodshot.games/llms.txt
> Use this file to discover all available pages before exploring further.

# The HoodShot Smart Contract

> One casino contract holds every rule: bets, limits, fees, the RSA key, and settlement. All of it is readable on Blockscout.

Everything HoodShot enforces lives in one contract on Robinhood Chain:

|         |                                                                                                                                          |
| ------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Address | [`0xB0d213833612E5557Ad68F4Dcc96d024B5B74Fb7`](https://robinhoodchain.blockscout.com/address/0xB0d213833612E5557Ad68F4Dcc96d024B5B74Fb7) |

## Views worth knowing

Anyone can read these, no wallet needed:

| Call                             | Returns                                                      |
| -------------------------------- | ------------------------------------------------------------ |
| `bets(id)`                       | The full stored bet: player, game, pick, stake, settled flag |
| `betDigest(id)`                  | The exact digest the house must sign for bet `id`            |
| `modulus()`                      | The house RSA public key the contract verifies against       |
| `betLimits(game, params, token)` | Live min and max stake for a specific bet shape              |
| `quote(game, params, stake)`     | The payout a winning bet would receive right now             |
| `feeBps()` / `settlerShareBps()` | 100 (1% fee) and 5000 (half of it to the settler)            |

## Events

`BetPlaced`, `Settled(id, h, outcome, payout)`, `SettlerFeePaid`, and `PayoutClaimed` form the complete public history. Indexers, the leaderboard, and the verify page are all built from these events, and you can rebuild any of it independently.

## Safety properties

* Payouts for every pending bet are **reserved** at placement, so the house can never take a bet it cannot pay.
* Bet terms are snapshotted per bet: a fee or edge change never affects a bet already placed.
* Settlement verifies the RSA signature on-chain against the key version the bet was placed under, so key rotation cannot orphan or alter old bets.