The x402 facilitator for Robinhood Chain

New here? Launch a paid agent: pick a template, mint its identity, and sell in about 5 minutes.

npm i @tollxyz/x402-seller, then one line in a Next.js, Hono, Bun or Workers handler. It answers 402 with your price, sends the payment here, and runs your handler once it is settled:

import { paywall } from "@tollxyz/x402-seller";

export const GET = paywall(
  { payTo: "0xYourAgentWallet", price: "0.05", agentId: 12345 },
  async (req) => Response.json({ ok: true }),
);

Options: appCode names your app in every settlement’s calldata (ERC-8021), bazaar describes the endpoint so it is listed in discovery once a payment settles.

export const GET = paywall(
  {
    payTo: "0xYourAgentWallet", price: "0.05", agentId: 12345,
    appCode: "your_app",                 // ERC-8021 builder code: settlements name your app on chain
    bazaar: {                            // listed in discovery once a payment settles
      description: "tomorrow's forecast for a city",
      input: { city: "Dubai" },
      inputSchema: { type: "object", properties: { city: { type: "string" } }, required: ["city"] },
      output: { example: { forecast: "sunny" } },
    },
  },
  async (req) => Response.json({ forecast: "sunny" }),
);

npx degit t0ll-xyz/toll-plugins/templates/x402-starter my-api

Or point any x402 server at this facilitator. No account, no API key:

https://x402.t0ll.xyz

Your payment requirement names USDG and its signing domain explicitly (most x402 libraries have no default for chain 4663), and, to get the payee check, your ERC-8004 identity:

{
  "scheme": "exact",
  "network": "eip155:4663",
  "asset": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
  "amount": "50000",
  "payTo": "0xYourWallet",
  "maxTimeoutSeconds": 300,
  "extra": {
    "name": "Global Dollar",
    "version": "1",
    "erc8004": {
      "registry": "eip155:4663:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
      "agentId": "<your agent id>"
    }
  }
}

Any x402 client pays a seller that settles here: the payer signs, the seller sends it to this facilitator, and we send the transaction. Before an agent signs, check_tx reads the payment from the payer’s side: whether payTo is the seller’s registered agent wallet, the price against what the seller usually asks, and how long the signature lasts. What it reads.

import { wrapFetchWithPayment } from "x402-fetch";
import { guardX402Fetch } from "@tollxyz/guard";

// every 402 goes to Toll's check_tx before the client signs it; a BLOCK never reaches the payer
const pay = wrapFetchWithPayment(guardX402Fetch(fetch, { agentId: 12345 }), account);
const res = await pay("https://seller.example/api/forecast?city=Dubai");

Pay up to a maximum (upto): the payer signs a maximum, and the seller may charge any amount up to it. check_tx names that maximum in USDG; a guard spend cap (perCall, perEndpoint) counts the 402’s amount. Over MCP the tool is check_tx (Use Toll in your AI); in code, @tollxyz/guard.

• x402 Register: every x402 seller on Robinhood Chain, and whether its payTo is its registered agent wallet.
• What “payTo verified” means, and what it does not.
• Live numbers: payers, failed payments, payee check outcomes, escrow and batch-settlement totals.
• Escrow holds & refunds, in one feed with the settlements.
• Batch settlement: every deposit, claim and refund, with what each claim paid.
• Settled by verified sellers.
• Look up a receipt by its id or transaction.
• How it works, feature by feature, and the limits.
• Endpoints: verify, settle, supported, receipt, stats, discovery.
• x402 on Robinhood Chain: x402 payments over 30 days, by seller and by facilitator, refreshed hourly.