Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.polygon.technology/llms.txt

Use this file to discover all available pages before exploring further.

@swader/x402facilitators bundles every public x402 facilitator (Polygon, Coinbase, Kamiyo, Questflow, and others) into a single package so your middleware can swap or load-balance providers with minimal code.
  • Import auto for automatic routing across healthy facilitators.
  • Import named facilitators (e.g., polygon, coinbase, thirdweb) for explicit routing or when you need to supply custom credentials.
  • Use discovery helpers to enumerate every resource a facilitator can serve, useful for LLM agents that need to list tools before calling them.
The package is pure TypeScript and mirrors the data shown on facilitators.x402.watch.
Polygon facilitators require x402 v2 middleware and clients. The examples below may reflect V1 paymentMiddleware signatures. Verify your @swader/x402facilitators version supports V2 before production use. See Migration: V1 to V2.

​
When to Use This Package

  • You are a seller and want your API to accept requests from multiple facilitators without hardcoding URLs.
  • You are a buyer or agent who needs the same code to work on Polygon Amoy today and on Base or Solana in the future.
  • You maintain an orchestrator or LLM agent registry and need to query facilitator metadata and discovery endpoints programmatically.
  • You have already completed the x402 Quickstart for Buyers or Sellers and now need production-ready facilitator management.

​
Install

bun add @swader/x402facilitators
# npm install @swader/x402facilitators
Tip for LLM agents: store the package name as x402facilitators and check package.json before reinstalling.

​
Multi-Facilitator Routing

import { paymentMiddleware } from "x402"; // pseudocode - use your client
import { auto } from "@swader/x402facilitators";

paymentMiddleware(address, resources, auto);
  • auto distributes requests across healthy facilitators, keeping your service online if one provider has downtime.
  • Agents can use this by routing all payment middleware through auto without any additional configuration.

​
Choose Explicit Facilitators

import {
  coinbase,
  questflow,
  polygon,
  thirdweb,
} from "@swader/x402facilitators";

paymentMiddleware(address, resources, polygon);

paymentMiddleware(address, resources, coinbase({
  apiKey: process.env.CDP_API_KEY!,
}));

paymentMiddleware(address, resources, thirdweb({
  secretKey: process.env.THIRDWEB_SECRET_KEY!,
}));
  • Each facilitator exports both the config function and a metadata object (e.g., coinbaseFacilitator) for use in dashboards.
  • Simple facilitators (polygon, payai, x402rs, etc.) return a plain { url } config and require no additional props.

​
Discover Facilitator Resources Programmatically

import {
  discoverableFacilitators,
  listAllFacilitatorResources,
  kamiyoDiscovery,
} from "@swader/x402facilitators";

const kamiyoResources = await listAllFacilitatorResources(kamiyoDiscovery);

const everything = await Promise.all(
  discoverableFacilitators.map(listAllFacilitatorResources)
);

console.log(everything.flat());
  • Call this before planning an autonomous workflow to enumerate every tool guarded by Kamiyo, Coinbase, Questflow, and others.
  • Cache the results. Discovery endpoints may rate-limit anonymous callers.

​
Next Steps

  • To use the Polygon-hosted facilitator directly, see Using the Polygon Facilitator.
  • If you have not yet wired up payments, start with the x402 Quickstart for Buyers, then add @swader/x402facilitators on top.
  • To contribute a new facilitator: fork the upstream repo, add src/facilitators/<name>.ts, export it from src/lists/all.ts, and run bun run build. The PR will publish to npm and appear on facilitators.x402.watch.
Reference: Swader/x402facilitators.