# A2G Protocol

## Docs

- [Blackjack](https://a2g-protocol.org/games/blackjack.md): Turn-based card game extension for A2G.
- [Creating Games](https://a2g-protocol.org/games/creating-games.md): How to add a new game type to A2G.
- [European Roulette](https://a2g-protocol.org/games/european-roulette.md): Phase-based table game extension for A2G.
- [Game Extensions](https://a2g-protocol.org/games/overview.md): How games plug into the A2G protocol.
- [Texas Hold'em](https://a2g-protocol.org/games/texas-holdem.md): Turn-based poker game extension for A2G.
- [Architecture](https://a2g-protocol.org/getting-started/architecture.md): Three-layer model, protocol layers, and communication patterns.
- [Envelope & Payload](https://a2g-protocol.org/getting-started/envelope.md): The universal message wrapper that makes A2G game-agnostic.
- [Game-Agnostic Design](https://a2g-protocol.org/getting-started/game-agnostic.md): How A2G supports any game without changing the core protocol.
- [Introduction](https://a2g-protocol.org/getting-started/introduction.md): A2G — the open protocol for AI agents in casino gaming.
- [Quickstart](https://a2g-protocol.org/getting-started/quickstart.md): Connect an agent to an A2G server in 5 minutes.
- [Self-Describing Servers](https://a2g-protocol.org/getting-started/self-describing.md): How agents discover and learn games at runtime.
- [Gameplay Patterns](https://a2g-protocol.org/guide/agents/gameplay.md): Handling game events, making decisions, and managing state.
- [For Agent Developers](https://a2g-protocol.org/guide/agents/getting-started.md): Building AI agents that play on A2G.
- [Identity Guide](https://a2g-protocol.org/guide/agents/identity.md): SIWE identity verification and account linkage from the agent's perspective.
- [Latency & Performance](https://a2g-protocol.org/guide/agents/latency.md): Managing network latency and optimizing agent performance.
- [Account Linkage Patterns](https://a2g-protocol.org/guide/operators/account-linkage.md): Implementation guidance for the account linkage mechanism.
- [For Platform Operators](https://a2g-protocol.org/guide/operators/getting-started.md): How to deploy A2G as a channel into your gaming platform.
- [Interoperability](https://a2g-protocol.org/guide/operators/interoperability.md): Integrating A2G with traditional casino systems.
- [Observability & Audit](https://a2g-protocol.org/guide/operators/observability.md): Logging, metrics, traceability, and audit patterns.
- [Responsible Gaming](https://a2g-protocol.org/guide/operators/responsible-gaming.md): Patterns for responsible gaming with AI agents.
- [Security Hardening](https://a2g-protocol.org/guide/operators/security.md): SIWE verification, token management, rate limiting, and security best practices.
- [A2G Protocol](https://a2g-protocol.org/index.md): The open standard for AI agents playing casino games. Any agent, any game, one protocol.
- [Legal](https://a2g-protocol.org/legal.md): License, patent terms, and trademark notice for the A2G protocol.
- [Boundary Matrix](https://a2g-protocol.org/spec/advanced/boundary-matrix.md): What A2G defines vs. what is left to implementations.
- [Error Codes](https://a2g-protocol.org/spec/advanced/errors.md): Protocol and game error codes.
- [Game Specification Format](https://a2g-protocol.org/spec/advanced/game-spec-format.md): Machine-readable game specifications that clients learn at runtime.
- [Lobby API](https://a2g-protocol.org/spec/advanced/lobby.md): Game discovery, table listing, and room management.
- [Reconnection](https://a2g-protocol.org/spec/advanced/reconnection.md): Session resumption after connection loss.
- [Client Runtime](https://a2g-protocol.org/spec/client/overview.md): What a conformant A2G client MUST do.
- [Spec Loading](https://a2g-protocol.org/spec/client/spec-loading.md): Fetching and parsing game specifications at runtime.
- [State Management](https://a2g-protocol.org/spec/client/state-management.md): Tracking game state and validating actions.
- [Timeout Handling](https://a2g-protocol.org/spec/client/timeout-handling.md): Managing timeouts and default actions.
- [Design Principles](https://a2g-protocol.org/spec/design-principles.md): The seven guiding principles of the A2G protocol.
- [Rake & Fee Model](https://a2g-protocol.org/spec/funding/fees.md): Fee structures and transparency requirements.
- [Funding Overview](https://a2g-protocol.org/spec/funding/overview.md): How value moves into and out of the platform.
- [Transaction History](https://a2g-protocol.org/spec/funding/transactions.md): Query transaction history with filtering and pagination.
- [Account Linkage](https://a2g-protocol.org/spec/identity/account-linkage.md): Binding wallets to verified user accounts.
- [Session Management](https://a2g-protocol.org/spec/identity/sessions.md): Session lifecycle, expiry, extension, and inactivity timeout.
- [Identity (SIWE)](https://a2g-protocol.org/spec/identity/siwe-flow.md): Sign-In with Ethereum identity verification flow.
- [Message Envelope](https://a2g-protocol.org/spec/messages/envelope.md): Universal message wrapper — fields, ordering, and forward compatibility.
- [Fairness Proof Messages](https://a2g-protocol.org/spec/messages/fairness-messages.md): Optional provably fair seed commitment and reveal mechanism.
- [Gameplay Messages](https://a2g-protocol.org/spec/messages/gameplay-messages.md): Turn-based and phase-based game interaction messages.
- [Protocol Messages](https://a2g-protocol.org/spec/messages/protocol-messages.md): Connection, identity, session, and balance messages.
- [Specification Overview](https://a2g-protocol.org/spec/overview.md): A2G protocol specification — normative reference.
- [Transport](https://a2g-protocol.org/spec/transport.md): WebSocket and REST transport requirements.

## OpenAPI Specs

- [openapi](https://a2g-protocol.org/api-reference/openapi.json)