SubEtha Developer Documentation

SubEtha is a local, non-production proof of concept for machine payments: AI agents pay for HTTP resources with the x402 v2 flow, settled through zERC20’s burn → proof-gated mint. What SubEtha hides is the correspondence between payer and provider on-chain; amounts are public.

Where to start

• x402 v2 on SubEtha — how a payment rides the official x402 v2 flow, and why accepted is never the same as finalized.
• Wire protocol reference — the normative subetha-zerc20 scheme: identifiers, payload shapes, EIP-712 definitions, and the facilitator HTTP API.
• Configuration reference — facilitator TOML keys and the SUBETHA_* payer environment variables.
• TypeScript API and Python API — the published payer/provider package surfaces.
• Versions & compatibility — protocol scope, registry-verified package versions, and license boundaries.

Scope

• Everything on this site describes the local, non-production PoC. No page here produces or endorses a production deployment.
• The protocol scope is x402 v2 only; MPP framing is deferred in the product at the pinned commit.
• Quickstarts and the end-to-end tutorial remain the next documentation tasks. The SubEtha product repository is canonical for anything this site does not yet cover. For future localization work, see the English-first policy in Start here; Japanese is not published until complete.