Ag402

  • Name: Ag402
  • URL: https://github.com/AetherCore-Dev/ag402
  • Category: x402 wrapper / Solana-USDC middleware
  • Tags: solana-ecosystem ethereum-ecosystem
  • Summary: Ag402 is x402 wrapper glue for Solana USDC. It patches buyers, fronts sellers, and absorbs wallet, budget, and RPC chores. Useful operator tooling, not a protocol.
  • What it does:
    • Auto-pays x402-style 402 Payment Required responses for Python agents through ag402 run or the ag402_core.enable() monkey-patch path
    • Wraps existing APIs or MCP servers behind a paid proxy through ag402 serve, so sellers can bolt a paywall onto an existing service without rewriting the backend
    • Packages Solana USDC settlement with local wallet handling, spend caps, RPC failover, prepaid credentials, and seller-no-key operation
    • Ships install and operator flows for Claude Code, Cursor, OpenClaw, wallet status, history, budgets, env checks, and exports
  • Key claims:
    • Calling Ag402 the payment layer for x402 is marketing. The durable thing is convenience packaging around the underlying paid-request handshake.
    • The package split — open402, ag402-core, ag402-mcp, and ag402-client-mcp — shows a real operator stack spanning header parsing, payment execution, seller gatewaying, and client adapters rather than one tiny helper library.
    • Non-custodial wallet handling, seller-no-key mode, budget caps, and RPC failover make the real control surface local operator policy, not a new settlement rail.
    • Ag402 matters as a concrete Solana-USDC x402 stack for agents and tool runtimes. It still does not redefine the request grammar.
  • Whitepaper: No canonical standalone Ag402 whitepaper or litepaper surfaced in this pass. The clearest current source of truth was the main GitHub repository, the project llms.txt, and associated first-party docs embedded in the repo; see ../whitepapers/ag402-primary-sources-2026-05-03.md.
  • Sources:

Internal linkages

  • Protocol base: x402
  • Stronger packaging/discovery reference: 402-index

Control surface

  • The leverage sits in autopay interception, proxy defaults, prepaid or HMAC shortcuts, wallet policy, spend caps, and Solana RPC choices.

  • That makes Ag402 useful middleware around paid requests, not a protocol center.

  • Last reviewed: 2026-06-16 UTC