> For the complete documentation index, see [llms.txt](https://docs.fast.poker/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fast.poker/smart-contracts-reference/05-contracts.md).

# Programs, instructions, accounts, errors

Lookup index for the on-chain pieces. The programs below are deployed on Solana mainnet at the addresses listed.

## Programs

| Program               | Address                                        | Role                                                                                           |
| --------------------- | ---------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `fastpoker`           | `PokerXYdXL2SKNnfGbv1WE7vJHipTpNsfZbZeVvoJLn`  | Main game logic: tables, seats, vaults, gameplay, settlement.                                  |
| `fastpoker_registry`  | `pokerQBdo685uLSkpVSyZ1vWooPYYTUhGkeKAHyCmax`  | Existing Dealer Licenses, closed issuance, retired listing state, and wrap/unwrap restoration. |
| `nft_license`         | `WRAPYBFx2VZoMz9wwZbBoYA7PHDu6MR4ygNVgHLYcUW`  | Dealer license NFT wrap/unwrap path.                                                           |
| Steel tokenomics      | `FASTPjXb68fPW9JRYSBS3EDoaT6inz84GoqkPK52dsA9` | Raw $FP, Liquid $FP, Burned $FP, and reward accounting support.                                |
| MagicBlock Delegation | `DELeGGvXpWV2fqJUhqcF5ZSYMS4JTLjteaAMARRSaeSh` | ER delegation and commit flow.                                                                 |

## Instruction groups

| Group                  | Examples                                                                                                                            |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Lifecycle and joining  | `register`, `join_sng_pool`, `seat_from_pool`; cash creation/deposit entries are retired                                            |
| Gameplay               | `start_game`, `tee_deal`, `player_action`, `tee_reveal`, `settle_hand`, `handle_timeout`                                            |
| Flat Bounty duels      | `init_sng_duel_state`, `delegate_sng_duel_state`, `maybe_start_sng_duel`, `sng_duel_action`, `sng_duel_timeout`, `resolve_sng_duel` |
| Cashout and rake       | `process_cashout_v2`, `settle_table_rewards`, `record_cash_hand_tip`                                                                |
| SNG settlement records | `init_settlement_record`, `delegate_settlement_record`, `distribute_prizes_from_record`, `close_settlement_record`                  |
| SNG lifecycle          | `settle_sng_jackpots`, `assert_table_clean`, `reset_sng_table`, `repair_sng_reward_checked_gap`                                     |
| Emission governance    | `init_emission_ctrl`, `init_pool_idle`, `set_emission_ctrl_config`, `reset_emission_ctrl_pool_caps`                                 |
| Reward accounting      | `update_acc_reward_per_weight`, `finalize_operator_reward_epoch`, `claim_operator_rewards`                                          |
| Registry               | License restore/wrap helpers and cleanup of historical auction state; purchase/grant/bid/list writes are retired                    |

## Important state

| Account             | Purpose                                                           |
| ------------------- | ----------------------------------------------------------------- |
| Table               | Table phase, blinds, seats, game type, rake cap, and match state. |
| Seat                | Player seat and stack state.                                      |
| SeatCards           | Private hole-card state.                                          |
| DeckState           | Deck commitment and reveal state.                                 |
| TableVault          | SOL or token custody for a table.                                 |
| Player              | Player stats and XP.                                              |
| DealerLicense       | Registry license PDA for dealer earnings.                         |
| OperatorClaim       | Dealer reward claim state.                                        |
| SngPool             | SNG queue and tier state.                                         |
| SngDuelState        | Persistent 6-max/9-max Flat Bounty point and active-duel sidecar. |
| SngSettlementRecord | Transient per-game final SOL/$FP payout record.                   |
| EmissionCtrl        | Global governed demand/idle emission controller.                  |
| PoolIdle            | Per-format/tier last-game state for capped idle boosts.           |
| Jackpot accounts    | Lucky/Royal jackpot pools, weights, and settlements.              |

## Current public IDL release

The 2026-07-17 FastPoker IDL exposes 168 instructions, 36 account types, and 199 custom errors. These additions are backward-compatible at the IDL level, but operators and integrations must understand the new mandatory accounts and fail-closed lifecycle gates before handling record-enabled or duel-mode tables.

## Source of truth

Instruction names and account layouts can change across releases. Verify against the current IDL, release tag, or deployed binary when building tooling.