docs: warn that public facilitator returns 500 (not 402) when used with Base Mainnet#206
Draft
osr21 wants to merge 1 commit into
Draft
docs: warn that public facilitator returns 500 (not 402) when used with Base Mainnet#206osr21 wants to merge 1 commit into
osr21 wants to merge 1 commit into
Conversation
The public x402.org/facilitator only supports Base Sepolia (eip155:84532). Using it with Base Mainnet (eip155:8453) makes the middleware propagate a "Route Configuration Errors" response as a 500 Internal Server Error instead of returning 402 Payment Required. Add a <Warning> callout explaining this and pointing to the mainnet section.
🟡 Heimdall Review Status
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a
<Warning>callout to the "Add Payment Middleware" section of the Quickstart for Sellers guide, immediately below the facilitator URL bullet.Why
The public facilitator
https://x402.org/facilitatoronly supports testnet networks (Base Sepoliaeip155:84532, Solana Devnet). When developers configure the middleware with Base Mainnet (eip155:8453) — a natural step when moving to production — the middleware crashes with a generic500 Internal Server Errorrather than returning402 Payment Required. There is no indication in the error or current docs that the issue is the facilitator configuration.Observed while building BasePay, an open-source USDC payments dApp on Base Mainnet using
@x402/express.Error seen in server logs:
Change
Single doc edit: one
<Warning>block inserted at the facilitator URL bullet indocs/getting-started/quickstart-for-sellers.mdx. No code changes.