Skip to content
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions skills/agentic-payments/x402.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ x402 is permissionless — anyone can run a facilitator, and the protocol itself

- **OZ Channels** (`https://channels.openzeppelin.com/x402/testnet`, `https://channels.openzeppelin.com/x402`) — testnet and mainnet, API key required on both. Stellar's docs list it as the *Build on Stellar Relayer* with the OpenZeppelin x402 plugin. **This guide configures it**, and it is the mainnet facilitator those docs name.
- **The x402.org facilitator** (`https://x402.org/facilitator`, also `@x402/core`'s `DEFAULT_FACILITATOR_URL`) — testnet only, no API key. Stellar's docs call it the Coinbase x402 facilitator. Its `/supported` response advertises `stellar:testnet` with sponsored fees and carries no `stellar:pubnet` entry.
- **AgentSmith Facilitator** (`https://testnet.agentsmith.xyz/facilitator`, `https://mainnet.agentsmith.xyz/facilitator`) — testnet and mainnet, no API key required on testnet; mainnet requires a Resource Server API key. Sponsors XLM fees on both networks. Supports `exact` and `upto` schemes. Source: [github.com/57blocks/agentsmith](https://github.com/57blocks/agentsmith).
- **Your own** — run a facilitator, or facilitate in process. The [self-facilitation example](https://github.com/x402-foundation/x402/tree/main/examples/typescript/servers/self-facilitation) shows the shape, an `x402Facilitator` from `@x402/core/facilitator` wired into `x402ResourceServer`, but it registers the EVM scheme on Base Sepolia. On Stellar you register `ExactStellarScheme` from `@x402/stellar/exact/facilitator`, built with the `FacilitatorStellarSigner` it settles from (`createEd25519Signer` on that account's `S...` key). That account submits the transaction and pays the XLM fees, so there is no third party and no external fee sponsor.

`GET <facilitator-url>/supported` is the authoritative check for whether an operator serves your network. The full lists live on [x402's facilitators page](https://docs.x402.org/dev-tools/facilitators) and in the [x402 Facilitators section](https://developers.stellar.org/docs/build/agentic-payments/x402#x402-facilitators) of Stellar's docs.
Expand Down