x402

x402 lets a client pay for an HTTP request with a signed stablecoin payment. The server responds 402 with payment requirements, the client retries with a payment payload, and a facilitator verifies and settles it.

import { x402 } from "@tollstile/x402";

createTollstile({
  rails: [
    x402({
      payTo: process.env.X402_PAY_TO,
      network: "base",
      facilitator: process.env.X402_FACILITATOR_URL,
    }),
  ],
});

Schemes

upto uses the authorization flow with upTo() prices and payment.fulfill({ amount }). See Charge for usage.

What Tollstile adds

• The server's price, asset, network, and recipient are checked against config — never taken from the payload.
• Proofs are recorded in the ledger and accepted once.
• Settlement and failures follow the lifecycle, including unknown and reconciliation.
• The same route can also accept MPP.