Skip to content

ergo-use-x402#

ergo-use-x402 is an experimental implementation of x402 payments for Ergo's USE stablecoin. It demonstrates a payer spending USE while holding no ERG: the transaction uses a Babel-fee box so the miner fee is paid in USE and the facilitator verifies and broadcasts without holding a key.

Scope#

The repository includes:

  • an x402 exact scheme for ergo:mainnet and ergo:testnet;
  • a client package for building USE payments with a wallet/provider abstraction;
  • a stateless facilitator with /verify, /settle, and /supported endpoints;
  • an Agentic Commerce Protocol merchant package;
  • a Hono test resource server;
  • a storefront with Nautilus and ErgoPay paths;
  • a self-hosted ErgoPay reducer example using AppKit.

The README reports seven confirmed mainnet payment paths across direct client broadcast, facilitator settlement, HTTP 402, ACP checkout, Nautilus storefront, and ErgoPay storefront flows.

Caveats#

  • The project is an example implementation, not a ratified Ergo payment standard.
  • ergo:mainnet is used as a convention between client and facilitator, not a finalized CAIP-2 namespace.
  • Mempool acceptance is not finality. The repository recommends confirmed settlement for resources with economic value.
  • Babel liquidity is an operational dependency; the USE Babel box needs enough ERG to cover backed payments.