> ## 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.

# Using x402facilitators package

> How to use the @swader/x402facilitators package to add multi-facilitator routing to x402 middleware.

`@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](https://facilitators.x402.watch).

## 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](./quickstart-buyers.mdx) or Sellers and now need
  production-ready facilitator management.

## Install

```bash theme={null}
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

```ts theme={null}
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

```ts theme={null}
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

```ts theme={null}
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](./using-polygon-facilitator.mdx).
* If you have not yet wired up payments, start with the
  [x402 Quickstart for Buyers](./quickstart-buyers.mdx), 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](https://facilitators.x402.watch).

Reference: [`Swader/x402facilitators`](https://github.com/Swader/x402facilitators/).