crawl_failed | the last crawl of this origin did not succeed, so nothing is routed to it | Serve your manifest, OpenAPI document or llms.txt at a public URL that answers with a parseable body. The next successful crawl restores routing; re-registering below crawls you now. |
|---|
no_supported_route | the seller advertises no chain this host holds a spending wallet for | Advertise at least one chain the router pays on, alongside any others you support. The verdict at /api/index?seller=<your host> lists the chains it reads. |
|---|
price_unknown | no seller price is known for this route, and the router never spends against an unknown price | Answer a bare unpaid request to every paid route with its 402, before you validate input. A route that needs a query parameter or a body still has to return its 402 to the crawler's empty probe, or no price can be read and the router never spends against an unknown one. |
|---|
network_unknown | the crawl learned no payment network (the paid route answered something other than a 402 to the unpaid probe), so the router cannot tell which chain to pay on | Same fix: the paid route answered the probe with something other than a 402, so no chain was learned. |
|---|
usdc_domain_mismatch | the seller's USDC accept on this chain advertises an EIP-712 domain name that is not the token's own (Base USDC signs under "USD Coin"; Monad, Celo and Sei USDC under "USDC"), so a stock x402 buyer - this router included - signs an authorization the facilitator refuses and nothing settles; the seller has to fix the accept before anyone can pay it | Advertise the token's own EIP-712 name in the accept's extra ("USD Coin" for Base USDC). Until then no stock buyer can pay you, ours included. |
|---|
gateway_rail_unsupported | the seller's accept on this chain is signed under Circle Gateway's EIP-712 domain (extra.name "GatewayWalletBatched", extra.verifyingContract the GatewayWallet), not under the token's own, and settles through a batch facilitator - a deliberate, working rail that this router's stock x402 signer cannot produce a credential for; nothing for the seller to fix, and it becomes eligible the day the router speaks the rail | Nothing to fix: your batched rail works for buyers that speak it. To be routable today as well, add a second accept on the same chain signed under the token's own EIP-712 domain. |
|---|
payment_method_unsupported | the seller's accept on this chain asks the buyer to send a transfer and prove it afterwards (extra.paymentMethod such as "direct-transfer"), which no stock x402 buyer does - this router signs an authorization for the facilitator to settle - so no buyer of ours can pay the route | Offer the standard exact scheme, where the buyer signs a USDC authorization and the facilitator settles it. A 402 that asks the buyer to send a transfer and prove it afterwards cannot be paid by a stock x402 buyer, ours included. |
|---|
url_template | the route is an unsubstituted path template; the router never spends against it | Serve concrete paths; the router never buys a templated path such as /items/{id}. |
|---|
settlement_required | on Base the router pays sellers with on-chain settlement history above the floor from enough distinct payers; a seller below it is tried only under the small unproven ceiling when its verdict carries unprovenTier | If the verdict also carries unprovenTier: true, there is nothing to fix: you are callable now in the unproven lane, and payments from real outside buyers move you up. |
|---|
settlement_self_funded | on Base the router counts only settlement the seller did not fund itself: a payment made with USDC that the wallet it pays had sent the payer earlier is the seller's own money coming home and does not count, and without those payments this seller's history is below the floor; payments made with the payers' own money still count | Payments made with USDC your own paid wallet sent the payer are netted out. Only buyers' own money counts. |
|---|
delivery_failing | the last time this router paid this seller on this chain the call did not deliver (a 5xx answer carrying no settle receipt, or no answer at all before the timeout), so it is skipped until that memo expires or a call to it succeeds. Settlement history is evidence about the past; this is what happened the last time someone actually paid | The router's last paid call to you did not deliver. It retries once that memo expires; fix the failing route first. |