Overview
Examples
Complete example configurations, each validated against the gateway config loader.
Each example is a complete config.yaml in the repository's examples/ directory, validated against the real config loader. Start from the one closest to your shape.
Local chain
Simple paid APIOne endpoint, paywalled with x402, HTTP only.Free and premiumA free and a paid resource over HTTP and MCP.Paid MCP toolMCP only: no resource can be invoked over HTTP.
Protocols
Public networks
Base SepoliaReal testnet USDC, no key in the gateway.Base mainnetReal funds through an authenticated facilitator.Base mainnet (PayAI)Real funds through a public facilitator with no credential.Arbitrum SepoliaAnother EVM testnet, settling in its built-in USDC. Not yet run.Solana devnetA USDC transfer whose fee the facilitator pays.NEAR testnetA NEP-366 delegate submitted by the facilitator's relayer.Multi-network mainnetOne resource offered on Base, Polygon, Arbitrum One and Solana.
| Example | Protocols | Network | Needs env? |
|---|---|---|---|
| simple-paid-api | HTTP | local | no |
| free-and-premium | HTTP, MCP | local | no |
| paid-mcp-tool | MCP | local | no |
| acp-checkout | ACP | — | no |
| base-sepolia | HTTP, MCP | Base Sepolia | MERCHANT_WALLET |
| base-mainnet | HTTP, MCP | Base | yes — almost nothing defaulted |
| base-mainnet-payai | HTTP, MCP | Base | MERCHANT_WALLET, ALLOW_X402_MAINNET |
| arbitrum-sepolia | HTTP, MCP | Arbitrum Sepolia | MERCHANT_WALLET |
| solana-devnet | HTTP, MCP | Solana devnet | SOLANA_MERCHANT_WALLET |
| near-testnet | HTTP, MCP | NEAR testnet | NEAR_MERCHANT_ACCOUNT, X402_FACILITATOR_URL |
| multi-network-mainnet | HTTP, MCP | Base, Polygon, Arbitrum One, Solana | yes — opt-in, wallets, facilitator and admin token |