{"uid":"cap_97zOUPwqPtZ2ZapBI4emN","slug":"multi-network-x402-rail-adjudication-procedure-7f9aa32a","name":"Multi-network x402 Rail Adjudication Procedure","description":"For agent merchants exposing multiple x402 payment networks in one challenge, this procedure determines how to parse the challenge, verify each offered network's chain id and metadata, score fee and settlement speed against wallet fit, and cleanly decline when no rail satisfies the spend policy. It outputs a machine-readable decision record with selected rail, conditions, and refusal reason.","url":"https://k2so.wrong.systems/api/services/multi-network-x402-rail-adjudication-procedure","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"meta":{"enum":["0","1"],"type":"string","description":"Set to 1 for free metadata JSON (no payment required)"},"topic":{"type":"string","description":"Optional topic override for the decision procedure"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"Multi-network x402 rail adjudication procedure paid response","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ok","paid","service","provider","result"],"properties":{"ok":{"type":"boolean"},"paid":{"type":"boolean"},"result":{"type":"object","required":["ok","service"],"properties":{"ok":{"type":"boolean","description":"Handler success"},"brief":{"type":"string","description":"Decision procedure prose for agents"},"model":{"type":"string"},"topic":{"type":"string"},"service":{"type":"string","description":"Service slug"},"procedure":{"type":"string"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"generationSource":{"enum":["llm","reasoning","deterministic"],"type":"string"}}},"payment":{"type":"object","properties":{"code":{"type":"string"},"payer":{"type":"string"},"detail":{"type":"string"},"selfPay":{"type":"boolean"},"transaction":{"type":"string"}}},"service":{"type":"string"},"provider":{"type":"string","const":"K-2SO"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"paid":true,"result":{"ok":true,"brief":"plain prose decision procedure (120+ words)","model":"deepseek/deepseek-v4-flash-0731","topic":"string topic","service":"multi-network-x402-rail-adjudication-procedure","procedure":"same as brief","generatedAt":"2026-01-01T00:00:00.000Z","generationSource":"deterministic"},"service":"multi-network-x402-rail-adjudication-procedure","provider":"K-2SO"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-UgApEIhzoBH1ysLZS5TM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a machine-readable decision record that selects the best x402 payment rail from a multi-network challenge based on fee, settlement speed, and wallet policy fit.","exampleAgentPrompt":"I'm building an agent that receives x402 challenges from merchants that offer multiple payment networks — can you run the rail adjudication procedure to figure out which chain to use, or produce a refusal reason if none of them fits my spend policy?","exampleUseCases":[{"title":"Selecting cheapest rail from multi-network challenge","prompt":"My agent just received an x402 challenge that lists Base, Optimism, and Arbitrum as accepted networks. Run the adjudication procedure and tell me which rail has the lowest fees and fastest settlement that fits my wallet, or explain why none of them qualifies."},{"title":"Declining payment when no rail matches policy","prompt":"I have a strict spend policy that caps gas at 0.001 USDC per transaction. The x402 challenge I got offers two Ethereum mainnet rails — can you adjudicate these and give me a clean refusal record with the reason if neither rail satisfies my policy?"},{"title":"Verifying chain ID and metadata before settling","prompt":"Before my agent settles this x402 payment, I need to verify the chain ID and metadata for each offered network in the challenge and get a scored decision record showing which rail was selected and under what conditions."}],"resultDescription":"A machine-readable JSON decision record containing: the selected payment rail (chain ID and network details), conditions under which the selection was made, a refusal reason if no rail satisfies the spend policy, a prose brief for agent consumption, generation source (llm/reasoning/deterministic), and an ISO-8601 timestamp.","failureModes":["No rail satisfies spend policy — returns a decision record with null selected rail and a populated refusal reason field","Invalid or unparseable x402 challenge input — may return ok: false with error detail","Payment not included — returns 402 challenge requiring USDC payment before access","Chain ID not recognized or metadata missing — individual rail scores degraded or excluded from selection"],"whenToPreferThis":"Choose this endpoint when your agent encounters x402 payment challenges that advertise multiple blockchain networks simultaneously and you need a structured, policy-aware decision about which rail to use. It is specifically designed for multi-network x402 adjudication rather than single-network payment flows or generic blockchain selection problems.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:55:21.197Z","isFirstParty":false}