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

> ## Agent Instructions
> These are the customer docs for kinematic, a name written in lowercase except at the start of a sentence. Kinematic provides provably fair casino games, served to a casino's site by a game server: a Cloudflare Worker that the kinematic dashboard deploys into the casino's own Cloudflare account.
> Never put SESSION_SECRET or WALLET_SECRET in code, prompts, logs, commits or chat. Read them from environment variables and ask the person you work with to set them. The dashboard's Integration page shows each secret once.
> Values such as lucky-star, luckystar.example, og-rgs-lucky-star.luckystar.workers.dev, games.luckystar.example and player_48213 are examples. Use the casino's own casino ID, game server origin, element tag, session issuer and currencies: the Instructions for your coding agent on the dashboard's Integration page hold them, or ask the person you work with.
> To debug, start at https://docs.kinematic.run/troubleshooting and https://docs.kinematic.run/reference/errors. The wallet contract is at https://docs.kinematic.run/api/wallet.openapi.yaml.
> Sandbox bets are recorded on Solana devnet. Live game servers record nothing on Solana until the audited mainnet program is deployed.

# Return to player

> Choose your casino's return to player of 99%, 98%, 97% or 96%, which games follow it, how their payouts change, and how players see and verify it.

Your casino has one return to player (RTP), which you choose on the **Games** page: 99% (the default), 98%, 97% or 96%. That is a house edge of 1%, 2%, 3% or 4%.

## Which games follow it

| Games | At your return |
| - | - |
| Dice, Limbo, Crash, Mines, Pump, HiLo | Every multiplier follows a formula with your edge in it. |
| Wheel | Every layout returns exactly your figure. |
| Plinko, Keno, Diamonds | Each payout table is derived from its 99% table for your figure. |
| Roulette | Keeps its single-zero rules: 97.30% on every bet. |
| Baccarat | Keeps its fixed payouts: Player 98.77%, Banker 98.94%, Tie 85.88%. |
| Blackjack | Keeps its fixed rules: 99.49% with basic strategy. |

## How payouts change

* **Formula games.** Dice, Limbo, Crash, Mines, Pump and HiLo compute their multipliers with `10000 − edge`, in basis points, where the 99% games use 9900. Over 50.00, Dice pays 1.98× at 99%, 1.96× at 98%, 1.94× at 97% and 1.92× at 96%.
* **Wheel.** Every paying segment pays a little less, by the same rule for every layout, so each of the 15 layouts returns exactly your figure.
* **Plinko, Keno and Diamonds.** Each 99% table is scaled to your figure and rounded down to the hundredth, then the entries furthest below their scaled value are raised one hundredth at a time while the table stays at or below your figure. Every derived table returns at most your figure and within 0.12 points of it, and no payout is higher at a lower return.
* **At 99%** every payout is the same as before the options existed.

Multipliers are paid in hundredths, rounded down, so some settings return a little less than your headline figure: some Dice targets, Mines and Pump cash outs, and Crash's small cash outs. The engine also rounds every payout down to the currency's minor unit.

## What players see

The return is signed into your catalog and into the manifest that every bet names. Players check it in the **Odds** tab of the Provably fair dialog, which computes the game's return and the chance of every payout in the browser from your signed table, at the settings on screen. The checks under it confirm that the table matches the open engine code, that your game server signed it, and that every casino on the same version at your return pays the same table.

Each game returns this at each option. The **Games** page also lists each game's return under `What each game returns at <figure>`.

| Game | 99% | 98% | 97% | 96% |
| - | - | - | - | - |
| Dice | 98.98% | 97.98% | 96.98% | 95.98% |
| Limbo | 99.00% | 98.00% | 97.00% | 96.00% |
| Crash, by cash out | 98.03% to 99.00% | 97.04% to 98.00% | 96.05% to 97.00% | 95.06% to 96.00% |
| Mines, at every setting | 98.28% to 99.00% | 97.28% to 98.00% | 96.25% to 97.00% | 95.30% to 96.00% |
| Pump, at every setting | 98.28% to 99.00% | 97.28% to 98.00% | 96.25% to 97.00% | 95.30% to 96.00% |
| HiLo, on its first call | 98.46% to 99.00% | 97.31% to 98.00% | 96.46% to 97.00% | 95.38% to 96.00% |
| Plinko, at default settings | 98.99% | 98.00% | 97.00% | 96.00% |
| Keno, at default settings | 99.04% | 98.00% | 97.00% | 96.00% |
| Wheel, at default settings | 99.00% | 98.00% | 97.00% | 96.00% |
| Diamonds, at default settings | 99.00% | 98.00% | 97.00% | 96.00% |
| Roulette | 97.30% | 97.30% | 97.30% | 97.30% |
| Baccarat | Player 98.77%, Banker 98.94%, Tie 85.88% | the same | the same | the same |
| Blackjack, with basic strategy | 99.49% | 99.49% | 99.49% | 99.49% |

Where the player decides how a round plays, the return is a range across the ways to play.

## Changing it

A change applies to new bets. Bets accepted before it settle and verify at the return they were placed under. A bet that a player's browser had already signed under your previous table is refused once with `authorization_binding`, and the player's next bet is signed under the new one.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.