AERONDocs GitHub
docs.aeron.sh

Machine payments, documented.

Developer documentation for the Aeron rail: accept x402 payments in USDG on Robinhood Chain, pay for them from an agent, and read the settlements back off the chain.

Aeron is a payment rail for software that buys things without a human present. A seller answers an HTTP request with 402 Payment Required and a price; a buyer signs an authorization for exactly that amount; the Aeron facilitator checks it and settles it on Robinhood Chain. The whole exchange is two HTTP round trips and one on-chain transfer.

Nothing here needs an account, an API key, or a card. Sellers need an address that can receive USDG. Buyers need USDG — and not ETH, because Aeron’s relayer submits the transaction and pays the gas.

Constants

Every service on the rail is configured with the same five values. Copy them exactly; the facilitator refuses anything else.

Network
eip155:4663
Chain
Robinhood Chain mainnet, chain id 4663
Asset
0x5fc5360d0400a0fd4f2af552add042d716f1d168 (USDG, 6 decimals)
Scheme
exact · x402Version 1
Facilitator
https://x402.aeron.sh
Explorer
robinhoodchain.blockscout.com

Prices are quoted in atomic units of USDG, so six decimals: "2000" is $0.002 and "1000000" is $1.00.

Pick a side

How one call works

  1. The agent calls your endpointwith no payment header. You answer 402 with an accepts[] array: your price, your address, the asset, the network.
  2. The agent signsan EIP-3009 TransferWithAuthorization for exactly that amount and retries the same request with an X-PAYMENT header.
  3. You verifyby posting the payload and your requirements to POST /verify. The facilitator checks the signature, the nonce, the time window, and the payer’s balance — all against the chain.
  4. You do the work.Verification has already proved the authorization is valid, unspent, and funded, so this is the safe moment to spend money on the caller’s behalf.
  5. You settlewith POST /settle. Aeron’s relayer submits the transfer and pays the gas. USDG moves payer → your address in one transaction; nobody custodies it in between.
  6. You answerwith the result and an X-PAYMENT-RESPONSE header carrying the transaction hash, which is the buyer’s receipt.

What is running

ServiceHostWhat it is
Facilitatorx402.aeron.shVerifies and settles x402 payments. Reference
Inferenceinference.aeron.shOpenAI-compatible gateway, paid per call. Docs
Marketplacemarket.aeron.shDirectory of paid endpoints. Docs
RWA datarwa.aeron.shTokenized-stock prices and holdings. Docs
Aeronscanscan.aeron.shOpen explorer of agent payments. Docs
Walletnpm: aeron-walletThe buyer side, run on your own machine. Docs

Each one answers GET /healthz. If something here disagrees with what a service returns, the service is right.

Open access

Settlement through x402.aeron.sh needs no key and no registration until 30 September 2026. Aeron sponsors the gas for the first 1,000,000 settlements in that window. From 1 October 2026, gas runs on credits — the policy, and what it costs.

Source

The two pieces a stranger has to trust are open source and MIT licensed: aeron-facilitator, which holds the settlement path, and aeron-wallet, which holds the buyer’s key. Neither has been audited. Both move real money on mainnet — read them before you point anything valuable at them.

Updated 1 September 2026. Everything on this page is read from the running services; report a drift at github.com/aeronlabs.