# Agon Protocol

## Docs

- [Live Devnet Benchmarks](https://docs.agonx402.com/benchmarks/live-devnet.md): Generated from the latest protocol-only Agon devnet demo run.
- [Methodology](https://docs.agonx402.com/benchmarks/methodology.md): How Agon publishes benchmark artifacts for the protocol.
- [Synthetic Capacity Benchmarks](https://docs.agonx402.com/benchmarks/synthetic-capacity.md): Deterministic capacity snapshots for Agon V4 settlement paths.
- [Lightning](https://docs.agonx402.com/comparisons/lightning.md): How Agon's deferred-settlement model differs from Lightning's routing and liquidity model.
- [Managed Rails](https://docs.agonx402.com/comparisons/managed-rails.md): How Agon differs from a managed micropayment rail built around a single operator.
- [Overview](https://docs.agonx402.com/comparisons/overview.md): How Agon positions itself relative to adjacent payment systems.
- [x402](https://docs.agonx402.com/comparisons/x402.md): How Agon's deferred-settlement model differs from exact per-payment x402 settlement.
- [Authorized Settler](https://docs.agonx402.com/core-concepts/authorized-settler.md): How delegated submission works under unilateral settlement.
- [Balances and Withdrawals](https://docs.agonx402.com/core-concepts/balances-and-withdrawals.md): How participant balances, pending withdrawals, and channel locks work in Agon V4.
- [Commitments](https://docs.agonx402.com/core-concepts/commitments.md): Cumulative signed payment updates are Agon's hot-path primitive.
- [Operator Hubs](https://docs.agonx402.com/core-concepts/operator-hubs.md): How hub-style payment operators can be built on top of Agon without turning the base protocol into a managed rail.
- [Participants](https://docs.agonx402.com/core-concepts/participants.md): How permanent, wallet-bound protocol identities work in Agon V4.
- [Payment Channels](https://docs.agonx402.com/core-concepts/payment-channels.md): How Agon V4 models one long-lived, one-way payment relationship.
- [Trust and Collateral](https://docs.agonx402.com/core-concepts/trust-and-collateral.md): How Agon lets different payment relationships pick different safety and efficiency tradeoffs.
- [Yield-Bearing Assets](https://docs.agonx402.com/core-concepts/yield-bearing-assets.md): How yield-accruing dollar assets fit into Agon, and which token designs work best.
- [OWS Gateway Example](https://docs.agonx402.com/demos/ows-gateway.md): An application-layer example of Agon backing paid RPC access.
- [Protocol Demo](https://docs.agonx402.com/demos/protocol-demo.md): The protocol-only Agon devnet demo for the live V4 deployment.
- [Access Modes](https://docs.agonx402.com/gateway/access-modes.md): x402 exact, wallet-authenticated SIWX, and Agon channel routes.
- [Catalog](https://docs.agonx402.com/gateway/catalog.md): Discover every gateway route, its price, and its schema via GET /v1/catalog.
- [Settlement](https://docs.agonx402.com/gateway/facilitator.md): How paid requests settle on Solana, and why you are never charged for a failed call.
- [How it works](https://docs.agonx402.com/gateway/how-it-works.md): What happens when you call the Agon Gateway — from the client's point of view.
- [Agon Gateway](https://docs.agonx402.com/gateway/index.md): A hosted gateway for x402, SIWX, and Agon channel-backed Solana infrastructure routes.
- [Integration Guide](https://docs.agonx402.com/gateway/integration-guide.md): Integrate the Agon Gateway into your own client or service.
- [Pricing](https://docs.agonx402.com/gateway/pricing.md): How paid routes are priced and how Tokens API auth-only routes fit in.
- [Quickstart](https://docs.agonx402.com/gateway/quickstart.md): Make your first paid call to the live Agon Gateway in minutes.
- [Rate Limiting & Guardrails](https://docs.agonx402.com/gateway/rate-limiting.md): What the gateway accepts, what it rejects, and how it tells you.
- [Endpoints](https://docs.agonx402.com/gateway/reference/endpoints.md): Complete endpoint surface of the Agon Gateway.
- [Payment Headers](https://docs.agonx402.com/gateway/reference/payment-headers.md): The HTTP headers the gateway reads and returns for x402, SIWX, and Agon channel flows.
- [Helius Wallet API Routes](https://docs.agonx402.com/gateway/routes/helius-wallet.md): Every paid Helius Wallet API route — method, path, price, params, and example.
- [Solana DAS Routes](https://docs.agonx402.com/gateway/routes/solana-das.md): Every paid Solana DAS route — method, path, price, params, and example.
- [Solana RPC Routes](https://docs.agonx402.com/gateway/routes/solana-rpc.md): Every paid Solana RPC route — method, path, price, params, and example.
- [Tokens API Routes](https://docs.agonx402.com/gateway/routes/tokens-api.md): Every wallet-authenticated Tokens API v1 route — path, params, constraints, and example.
- [Devnet Demo](https://docs.agonx402.com/getting-started/devnet-demo.md): The protocol-only devnet demo: what it covers and what it produces.
- [Your First Payment](https://docs.agonx402.com/getting-started/first-payment.md): An end-to-end walkthrough: register, fund, open a channel, sign a commitment, and settle.
- [Protocol Overview](https://docs.agonx402.com/getting-started/protocol-overview.md): A builder-first tour of the V4 protocol: accounts, messages, and settlement paths.
- [Quickstart](https://docs.agonx402.com/getting-started/quickstart.md): See Agon run end-to-end against the live devnet deployment in a few minutes.
- [Agon Protocol](https://docs.agonx402.com/index.md): A non-custodial clearing and settlement protocol for machine payments on Solana.
- [Accounts](https://docs.agonx402.com/reference/accounts.md): The on-chain account layouts used by the Agon protocol.
- [Agentic Tools](https://docs.agonx402.com/reference/agentic-tools.md): Skills, CLI, MCP, and LLM text for agents integrating Agon Protocol and Agon Gateway.
- [Deployment](https://docs.agonx402.com/reference/deployment.md): Current live deployment details for the Agon Protocol.
- [Errors](https://docs.agonx402.com/reference/errors.md): Custom program errors returned by the Agon protocol.
- [Events](https://docs.agonx402.com/reference/events.md): Anchor events emitted by the Agon program.
- [Glossary](https://docs.agonx402.com/reference/glossary.md): Key terms used throughout the Agon Protocol docs.
- [Instructions](https://docs.agonx402.com/reference/instructions.md): The full on-chain instruction surface of the current Agon protocol.
- [Message Formats](https://docs.agonx402.com/reference/messages.md): The exact signed message formats used by the current Agon protocol.
- [AgonClient](https://docs.agonx402.com/sdk/client.md): Typed wrapper around the Agon Anchor program — one method per instruction.
- [TypeScript SDK](https://docs.agonx402.com/sdk/index.md): @agonx402/sdk — install, quick start, and what is inside.
- [Messages & signatures](https://docs.agonx402.com/sdk/messages.md): Build signed commitment and clearing-round messages and turn them into Ed25519 pre-instructions.
- [PDAs & constants](https://docs.agonx402.com/sdk/pdas.md): Deterministic address derivations and the constants that feed them.
- [Recipes](https://docs.agonx402.com/sdk/recipes.md): End-to-end flows with @agonx402/sdk — register, fund, sign, settle, withdraw.
- [Security Properties](https://docs.agonx402.com/security/properties.md): The concrete on-chain checks that make V4's settlement paths safe to integrate.
- [Trust Model](https://docs.agonx402.com/security/trust-model.md): What Agon guarantees on-chain, and what remains a relationship-level choice.
- [Bundle Settlement](https://docs.agonx402.com/settlement-modes/bundle-settlement.md): One payee settles many `agon-cmt-v5` messages in one transaction.
- [Cooperative Clearing Rounds](https://docs.agonx402.com/settlement-modes/clearing-rounds.md): One signed roster advances many channels and applies only residual balance changes.
- [Direct Settlement](https://docs.agonx402.com/settlement-modes/direct-settlement.md): Settle one channel with one signed `agon-cmt-v5` message.
- [Settlement Modes Overview](https://docs.agonx402.com/settlement-modes/overview.md): The three settlement paths in Agon V4 and when to use each.
- [Design Principles](https://docs.agonx402.com/thesis/design-principles.md): The non-negotiable properties Agon preserves across every settlement path.
- [Motivation](https://docs.agonx402.com/thesis/motivation.md): Why machine payments benefit from a clearing layer instead of one on-chain transfer per interaction.
- [Roadmap](https://docs.agonx402.com/thesis/roadmap.md): How the Agon protocol evolves beyond V4 without changing the core model.
- [Why Not Fee Per Payment](https://docs.agonx402.com/thesis/why-not-fee-per-payment.md): Why exact settlement on every interaction hits a constant cost floor that Agon is designed to remove.

## Optional

- [GitHub](https://github.com/Agonx402/agon-protocol)
- [X](https://x.com/agonx402)