API surface
@x402interop/client
createInteropClient(options)- upstreamx402Client+ HTTP helper pairwrapFetchWithInterop(fetch, options)- auto 402 →PAYMENT-SIGNATUREretryregisterInteropHandlers(registrar, options)- register interop scheme clients per (family × network)buildEvmPaymentPayload(params, binding)- EIP-712 signed EVM interop payloadsendEvmPayment(params)- broadcast EVM payment, returns txHash + payloaddecodePaymentRequired(response)- decode a 402 Payment Required responseenforceHardPriceCap,previewPaymentRequirements- spend controls
@x402interop/intents
mintQuote(request, client, options)- mint a 1Click quote mapped to x402 shapequoteToRequirements(request, quote, scheme)- turn a quote into a 402 requirement + extensionparseQuoteRequest(value)- validate a quote requestselectPaymentPath(input)- classify intodeposit_address/intents_balance/lightning_topupHttpOneClickClient- REST 1Click transportMockOneClickClient,SimulatorOneClickClient,ResilientOneClickClient,SdkOneClickClient- clients
Removed (legacy):
prepareQuote,mintAndPrepare,fetchWithLegacyFallback.
@x402interop/facilkit
createInteropFacilitator(options)- store, nonce ledger, status tracker, MCP, routesrouteFacilitator(method, path, body, headers)- route handlersupportedKinds()- scheme × network advertisement matrixverifyPayment(request, now, options),settlePayment(request, now, options)- verify + settle
@x402interop/servers
x402interop(options)- framework-agnostic seller middleware (402 or next)buildPaymentRequired(options)- build a vacant 402 bodypaymentRequiredFromRequirement(requirement, options)- wrap a minted requirementinteropAccept(options)- expand an accept selection into a vacant scheme × network matrixexpandRoutes(routes, powers)-$interop/$exact/$allroute sugar- Subpaths:
./express,./hono,./fastify,./next
@x402interop/core
PaymentRequirements,PaymentRequired,SupportedKind,SupportedResponse,Network,ChainFamily,X402_VERSION,SCHEME_IDS,NETWORK_CATALOGUEx402InteropExtension(quote)- build thex402interopextension
Apps
apps/facilitator- thin HTTP shell overfacilkit(MCP via/mcp)apps/marketplace- marketplace over the facilitator catalogue