{"openapi":"3.1.0","info":{"title":"ERPC x402 RPC (18 chains)","version":"1.3.0","description":"Stablecoin-gated JSON-RPC proxies plus an account-bound EURC credit top-up. POST /v1/solana-mainnet (Solana mainnet) and POST /v1/eth-mainnet (Ethereum mainnet) charge per JSON-RPC method via the x402 protocol. POST /v1/bitcoin-mainnet, /v1/polygon-mainnet, /v1/kaia-mainnet, /v1/bsc-mainnet, /v1/arbitrum-mainnet, /v1/optimism-mainnet, /v1/hyperliquid-mainnet, /v1/monad-mainnet, /v1/tron-mainnet, /v1/sui-mainnet, /v1/near-mainnet, /v1/arc-mainnet, /v1/robinhood-mainnet, /v1/soneium-mainnet, /v1/ava-mainnet and /v1/base-mainnet — the 16 other mainnet chains of the ERPC edge — charge per request method the same way, each forwarded to that chain's ERPC edge Worker over its x402 lane and priced from the chain's table (GET /pricing → <chain>.methods). Sui is sold as gRPC-web unary calls only (application/grpc-web+proto at /v1/sui-mainnet/sui.rpc.v2.<Service>/<Method>), not as JSON-RPC or GraphQL. The credit top-up sessions (/v1/credits/topup/sessions) take the account's own ERPC session as the Bearer from any caller, checked through the ERPC User API (the ERPC Dashboard calls them through the User API's /v3/user/credit-gasless-sessions): the account buys ERPC credits with EURC on Base (eip155:8453) without holding ETH, priced by the account VAT quote, receipt and credit grant issued by the ERPC receipt service. An ERPC API key is for the ERPC RPC endpoints only. Two payment rails are advertised in every 402 `accepts`: USDC on Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp) and USDC on Base (eip155:8453; EURC on Base when enabled). A rail the operator paused is listed under `howToPay.paused` instead. Ethereum L1 is never a settlement network — the Coinbase CDP facilitator cannot settle there — so the Ethereum RPC is paid for on Base or Solana. Every payment is verified and settled through the Coinbase CDP facilitator."},"servers":[{"url":"https://x402.erpc.global"}],"paths":{"/v1/credits/topup/sessions/{sessionId}/cancel":{"post":{"operationId":"cancelGaslessCreditSession","summary":"Cancel an undispatched purchase preparation","description":"Takes the account's ERPC session bearer from any caller, checked through the ERPC User API (Dashboard clients use user-api's POST /v3/user/credit-gasless-sessions/{sessionId}/cancel). Required JSON {} cancels only ready preparation. Returns the actual owned state if dispatch already won; it does not revoke any exposed authorization on-chain. No quote, payment, recovery or completion is invoked. No-store.","parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}},"responses":{"200":{"description":"Actual cancelled, expired, submitting, outcome_unknown, pending, granted or stuck state with original purchase"},"400":{"description":"Invalid body"},"401":{"description":"Unauthorized"},"404":{"description":"No owned session"},"429":{"description":"Ingress rate limit"},"503":{"description":"Unavailable; recover same session by GET"}}}},"/v1/credits/topup/sessions":{"post":{"operationId":"prepareGaslessCreditSession","summary":"Prepare an account-bound Base EURC purchase session","description":"Takes the account's ERPC session bearer from any caller and checks it through the ERPC User API; Dashboard clients reach it through user-api's POST /v3/user/credit-gasless-sessions. A UUID clientRequestId replays the immutable purchase; changed payer or amount conflicts. Ready contains EIP-3009 typed data and purchase, never quoteToken or internal requirements. Prepare failures include creationOutcome: not_started means this invocation did not dispatch creation, not absence of historical sessions; unknown requires recovery with the saved clientRequestId. Request body limit: 4 KiB. Responses are no-store.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["clientRequestId","amountCredits","payer"],"properties":{"clientRequestId":{"type":"string","format":"uuid"},"amountCredits":{"type":"integer","minimum":1,"maximum":10000,"description":"Net amount to buy, in whole EUR (excl. VAT): N buys N × 100 ERPC Credits (1 ERPC Credit = EUR 0.01 excl. VAT). VAT is added by the quote."},"payer":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}}}}},"responses":{"200":{"description":"Stored ready or replayed session with original purchase summary"},"400":{"description":"Invalid request or ineligible payer"},"401":{"description":"Unauthorized"},"409":{"description":"Conflicting request or expired quote"},"429":{"description":"Purchase limit"},"503":{"description":"Unavailable; no signable data"}}}},"/v1/credits/topup/sessions/{sessionId}/submit":{"post":{"operationId":"submitGaslessCreditSession","summary":"Dispatch one immutable EURC authorization","description":"Takes the account's ERPC session bearer from any caller, checked through the ERPC User API (Dashboard clients use user-api's POST /v3/user/credit-gasless-sessions/{sessionId}/submit). Canonical 65-byte ECDSA signature only. Durable claim permits one application settlement invocation. After dispatch, uncertainty is resumable by sessionId and never requests another payment. Expired unused sessions reject with quote_expired.","parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["signature"],"properties":{"signature":{"type":"string","pattern":"^0x[0-9a-fA-F]{130}$"}}}}}},"responses":{"200":{"description":"Granted purchase"},"202":{"description":"Submitting, unknown, or pending purchase; no typed data"},"400":{"description":"Invalid signature or request"},"401":{"description":"Unauthorized"},"404":{"description":"No session owned by this account"},"409":{"description":"Conflicting signature, changed/expired quote, or stuck purchase"},"503":{"description":"Unavailable; resume this session"}}}},"/v1/credits/topup/sessions/{sessionId}":{"get":{"operationId":"getGaslessCreditSession","summary":"Resume a durable Base EURC purchase","description":"Account-owned status. Takes the account's ERPC session bearer from any caller, checked through the ERPC User API (Dashboard clients use user-api's GET /v3/user/credit-gasless-sessions/{sessionId}). Returns stored purchase on every success. Unknown settlement scans one bounded safe nonce page; only the existing invoice verifier can grant credit. Empty evidence never proves unpaid. No-store.","parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Ready, submitting, outcome_unknown, pending, granted, stuck, or expired with immutable purchase"},"401":{"description":"Unauthorized"},"404":{"description":"No session owned by this account"},"503":{"description":"Status unavailable"}}}},"/v1/solana-mainnet":{"post":{"operationId":"solanaJsonRpc","summary":"Solana JSON-RPC (paid)","description":"Pay-per-request Solana JSON-RPC proxy. Accepts single or batch JSON-RPC 2.0 bodies. Pricing is the per-method table of the ERPC edge (GET /pricing → solana.methods lists it): standard JSON-RPC methods cost 42 tokens (getTokenLargestAccounts and getProgramAccountsV2 among them), getSignaturesForAddress 84, getTransaction 124, getBlock, getProgramAccounts and DAS methods 420, getMultipleAccounts 420 + 42 × N where N is the number of pubkeys in params[0] (1 when params[0] is missing, empty or not an array), and getSignatureStatuses 42 + 42 × N where N is the number of signatures in params[0] (0 when params[0] is not an array). Unknown methods default to 42 tokens. Calls the ERPC edge refuses as too broad (getLargestAccounts, token-program getTokenAccountsByDelegate, unfiltered getProgramAccounts on large programs, getTokenLargestAccounts on a very large mint, getMultipleAccounts with more than 100 pubkeys, getSignatureStatuses with more than 256 signatures, and a batch that mixes heavy and light methods) are answered with HTTP 200 and a JSON-RPC error, without a payment challenge and without a charge. A batch with more than 10 getTokenLargestAccounts calls is refused the same way by this endpoint (the ERPC edge has no such cap), with -32600 for every entry. A body with a method name the ERPC edge does not forward (one that is longer than 96 characters, contains a space, # or a character outside printable ASCII, or is ws_connection or ws_connection_seconds) is refused the same way, with -32600 for every entry. Methods this endpoint cannot serve (the ERPC gateway methods such as getTransactionsForAddress and jet*, getLeaderSlots, getValidatorsInformation and the Pyth price names) are not in /pricing and are answered the same way with JSON-RPC error -32601. A body can also be rejected with 400 invalid_request BEFORE any payment is requested when one of its calls lacks \"jsonrpc\": \"2.0\" or an id (a call without an id is a notification, which the Solana validator does not run), carries a field other than jsonrpc, method, params and id, has params that are neither an array nor null, or has an id that is -0, above 18446744073709551615, or not a string, null or a non-negative integer (a key written twice counts by its last value). A body with a call to getProgramAccounts, getProgramAccountsV2, getTokenLargestAccounts, getPriorityFeeEstimate, getAsset, getAssetBatch, getAssetProof, getAssetProofBatch, getAssetsByAuthority, getAssetsByCreator, getAssetsByGroup, getAssetsByOwner, getNftEditions, getSignaturesForAsset, getTokenAccounts, getTokensByDelegate, getTokensByOwner or searchAssets is not checked this way. Every payment is floored to a minimum charge of 1000 atomic USDC = $0.001 (the Coinbase CDP facilitator minimum settlement amount), so standard methods that would otherwise be 42 atomic ($0.000042) are charged $0.001. The first call returns 402 with an x402 payment challenge whose amount is max(summed token weight, 1000) times the base token price (1 token = $0.000001 = 1 atomic USDC, i.e. $1 per 1,000,000 tokens). The same body retried with X-Payment is settled in USDC on Solana mainnet and proxied to the upstream Solana RPC.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"solana","settlement_networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"]},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge. On the retry the client re-sends the same JSON-RPC body with this header carrying the signed payment for the challenged amount — a Solana USDC transfer, or an EIP-3009 transferWithAuthorization on Base when that rail is enabled — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/JsonRpcRequest"},{"type":"array","items":{"$ref":"#/components/schemas/JsonRpcRequest"},"minItems":1,"maxItems":100}]},"examples":{"getBalance":{"summary":"Single getBalance (42 canonical tokens, floored to $0.001)","value":{"jsonrpc":"2.0","id":1,"method":"getBalance","params":["11111111111111111111111111111111"]}},"batch":{"summary":"Batch (getSlot 42 + getBlockHeight 42 = 84 tokens, floored to $0.001)","value":[{"jsonrpc":"2.0","id":1,"method":"getSlot"},{"jsonrpc":"2.0","id":2,"method":"getBlockHeight"}]},"getMultipleAccounts":{"summary":"getMultipleAccounts (420 + 42 × 2 pubkeys = 504 tokens, floored to $0.001)","value":{"jsonrpc":"2.0","id":1,"method":"getMultipleAccounts","params":[["vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg","4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA"]]}}}}}},"responses":{"200":{"description":"Upstream JSON-RPC response. Includes X-Payment-Response header from the facilitator.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request. Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"Before any payment is requested, this endpoint refuses with error.code invalid_request a body that is not JSON, an empty batch, or a call that is not an object or has no non-empty string method. A body can also be refused with this code for a call that breaks the call rules in the description; a body with a call to getProgramAccounts or another method the description names there is not checked against them. An upstream that answers 400 itself is passed through after settlement with X-Payment-Response. Its body and Content-Type come from the upstream, or are an ERPC JSON-RPC error on a heavy method; this schema describes neither.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. The error.code is payment_required, payment_invalid, price_mismatch, settlement_failed (the facilitator reported an unsuccessful settle), or payment_amount_too_low (amount below the 1000-atomic / $0.001 facilitator minimum). Facilitator verify errors can return 402. A settle exception or observation timeout leaves the outcome unknown and returns 503 service_busy; the worker does not settle that payment again. `howToPay` tells a buyer holding none of the accepted assets where to obtain one.","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the JSON-RPC body: max(summed canonical weight, 1000-atomic minimum). Standard methods report 1000 after the floor. See x-pay-pricing."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When the settled receipt is available it is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"Batch size exceeds 100 calls."},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with X-Payment-Response. Its body and Content-Type come from the upstream, or are an ERPC JSON-RPC error on a heavy method; this schema describes neither.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with X-Payment-Response: that payment was charged and a retry is a new payment. Its body and Content-Type come from the upstream, or are an ERPC JSON-RPC error on a heavy method; this schema describes neither.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with X-Payment-Response. Its body and Content-Type come from the upstream, or are an ERPC JSON-RPC error on a heavy method; this schema describes neither.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/eth-mainnet":{"post":{"operationId":"ethereumJsonRpc","summary":"Ethereum mainnet JSON-RPC (paid)","description":"Pay-per-request Ethereum mainnet JSON-RPC proxy, geo-routed to the nearest ERPC Ethereum origin. Accepts single or batch JSON-RPC 2.0 bodies. Pricing uses a separate Ethereum table with the same token arithmetic as Solana: standard methods cost a flat 42 tokens (GET /pricing → ethereum.methods), eth_call / eth_estimateGas / eth_createAccessList / eth_getProof / txpool_contentFrom 420, eth_getLogs / eth_getFilterLogs / eth_getBlockReceipts / txpool_content / txpool_inspect 2400, eth_simulateV1 / eth_callMany 4200, and eth_getBlockByNumber / eth_getBlockByHash 42 with transaction hashes or 2400 with full transaction objects (params[1] === true). Batches are summed, then floored once to the 1000-atomic ($0.001) facilitator minimum. Methods outside GET /pricing → ethereum.methods — including the debug_* and trace_* namespaces and the WebSocket-only eth_subscribe / eth_unsubscribe — are rejected with 400 method_not_supported BEFORE any payment is requested. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and proxied upstream.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"ethereum-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same JSON-RPC body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/JsonRpcRequest"},{"type":"array","items":{"$ref":"#/components/schemas/JsonRpcRequest"},"minItems":1,"maxItems":100}]},"examples":{"blockNumber":{"summary":"Single eth_blockNumber (42 canonical tokens, floored to $0.001)","value":{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}},"getLogs":{"summary":"eth_getLogs (2400 tokens = $0.0024)","value":{"jsonrpc":"2.0","id":1,"method":"eth_getLogs","params":[{"fromBlock":"latest","toBlock":"latest"}]}},"fullBlock":{"summary":"eth_getBlockByNumber with full transactions (2400 tokens = $0.0024)","value":{"jsonrpc":"2.0","id":1,"method":"eth_getBlockByNumber","params":["latest",true]}}}}}},"responses":{"200":{"description":"Upstream JSON-RPC response. Includes X-Payment-Response header from the facilitator.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique methods in the body"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"Refused before any payment is requested: a body that is not JSON or not JSON-RPC 2.0 (error.code invalid_request: every call needs \"jsonrpc\": \"2.0\" and a non-empty method, params, if present, an array or an object, and an id, if present, a string, a number or null), or a method outside GET /pricing → ethereum.methods (error.code method_not_supported: debug_*, trace_*, the WebSocket-only eth_subscribe / eth_unsubscribe, and any other name). An upstream that answers 400 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MethodNotSupportedBody"}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique methods in the body"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the JSON-RPC body: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"Batch size exceeds 100 calls."},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/bitcoin-mainnet":{"post":{"operationId":"bitcoinMainnetRpc","summary":"Bitcoin mainnet RPC (paid)","description":"Pay-per-request Bitcoin mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0, single or batch: every call carries an id (no duplicate ids in a batch), a method matching ^[A-Za-z][A-Za-z0-9_]*$ and params as an array or an object; at most 100 calls per batch and 1 MiB per body, where \"jsonrpc\" may also be \"1.0\" or omitted, at this path only. Each call is priced at the weight of x402's table for Bitcoin (GET /pricing → bitcoin.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"bitcoin-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0","1.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0","1.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"getblockcount":{"summary":"Single getblockcount","value":{"jsonrpc":"2.0","id":1,"method":"getblockcount","params":[]}}}}}},"responses":{"200":{"description":"The Bitcoin lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → bitcoin.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → bitcoin.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → bitcoin.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/polygon-mainnet":{"post":{"operationId":"polygonMainnetRpc","summary":"Polygon mainnet RPC (paid)","description":"Pay-per-request Polygon mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0, single or batch: every call carries an id (no duplicate ids in a batch), a method matching ^[A-Za-z][A-Za-z0-9_]*$ and params as an array or an object; at most 100 calls per batch and 1 MiB per body, at this path only. Each call is priced at the weight of x402's table for Polygon (GET /pricing → polygon.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"polygon-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_blockNumber":{"summary":"Single eth_blockNumber","value":{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}}}}}},"responses":{"200":{"description":"The Polygon lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → polygon.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → polygon.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → polygon.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/kaia-mainnet":{"post":{"operationId":"kaiaMainnetRpc","summary":"Kaia mainnet RPC (paid)","description":"Pay-per-request Kaia mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0, single or batch: every call carries an id (no duplicate ids in a batch), a method matching ^[A-Za-z][A-Za-z0-9_]*$ and params as an array or an object; at most 100 calls per batch and 1 MiB per body, at this path only. Each call is priced at the weight of x402's table for Kaia (GET /pricing → kaia.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"kaia-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_blockNumber":{"summary":"Single eth_blockNumber","value":{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}}}}}},"responses":{"200":{"description":"The Kaia lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → kaia.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → kaia.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → kaia.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/bsc-mainnet":{"post":{"operationId":"bscMainnetRpc","summary":"BSC mainnet RPC (paid)","description":"Pay-per-request BSC mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0, single or batch: every call carries an id (no duplicate ids in a batch), a method matching ^[A-Za-z][A-Za-z0-9_]*$ and params as an array or an object; at most 100 calls per batch and 1 MiB per body, at this path only. Each call is priced at the weight of x402's table for BSC (GET /pricing → bsc.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"bsc-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_blockNumber":{"summary":"Single eth_blockNumber","value":{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}}}}}},"responses":{"200":{"description":"The BSC lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → bsc.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → bsc.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → bsc.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/arbitrum-mainnet":{"post":{"operationId":"arbitrumMainnetRpc","summary":"Arbitrum mainnet RPC (paid)","description":"Pay-per-request Arbitrum mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0, single or batch: every call carries an id (no duplicate ids in a batch), a method matching ^[A-Za-z][A-Za-z0-9_]*$ and params as an array or an object; at most 100 calls per batch and 1 MiB per body, at this path only. Each call is priced at the weight of x402's table for Arbitrum (GET /pricing → arbitrum.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"arbitrum-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_blockNumber":{"summary":"Single eth_blockNumber","value":{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}}}}}},"responses":{"200":{"description":"The Arbitrum lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → arbitrum.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → arbitrum.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → arbitrum.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/optimism-mainnet":{"post":{"operationId":"optimismMainnetRpc","summary":"Optimism mainnet RPC (paid)","description":"Pay-per-request Optimism mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0, single or batch: every call carries an id (no duplicate ids in a batch), a method matching ^[A-Za-z][A-Za-z0-9_]*$ and params as an array or an object; at most 100 calls per batch and 1 MiB per body, at this path only. Each call is priced at the weight of x402's table for Optimism (GET /pricing → optimism.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"optimism-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_blockNumber":{"summary":"Single eth_blockNumber","value":{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}}}}}},"responses":{"200":{"description":"The Optimism lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → optimism.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → optimism.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → optimism.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/hyperliquid-mainnet":{"post":{"operationId":"hyperliquidMainnetRpc","summary":"Hyperliquid mainnet RPC (paid)","description":"Pay-per-request Hyperliquid mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0, single or batch: every call carries an id (no duplicate ids in a batch), a method matching ^[A-Za-z][A-Za-z0-9_]*$ and params as an array or an object; at most 100 calls per batch and 1 MiB per body. This path is the HyperEVM endpoint /evm; /v1/hyperliquid-mainnet/evm and /v1/hyperliquid-mainnet/nanoreth are served too. Each call is priced at the weight of x402's table for Hyperliquid (GET /pricing → hyperliquid.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"hyperliquid-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_blockNumber":{"summary":"Single eth_blockNumber","value":{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}}}}}},"responses":{"200":{"description":"The Hyperliquid lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → hyperliquid.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → hyperliquid.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → hyperliquid.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/hyperliquid-mainnet/{subPath}":{"post":{"operationId":"hyperliquidMainnetRpcSubPath","summary":"Hyperliquid mainnet RPC below the root (paid)","description":"Pay-per-request Hyperliquid mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). {subPath} is evm (the same as the root) or nanoreth, each taking JSON-RPC 2.0, single or batch: every call carries an id (no duplicate ids in a batch), a method matching ^[A-Za-z][A-Za-z0-9_]*$ and params as an array or an object; at most 100 calls per batch and 1 MiB per body; any other sub-path is 400 invalid_request. Each call is priced at the weight of x402's table for Hyperliquid (GET /pricing → hyperliquid.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"hyperliquid-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}},{"name":"subPath","in":"path","required":true,"description":"The path below /v1/hyperliquid-mainnet, slashes included (e.g. evm).","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_blockNumber":{"summary":"Single eth_blockNumber","value":{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}}}}}},"responses":{"200":{"description":"The Hyperliquid lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → hyperliquid.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → hyperliquid.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → hyperliquid.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/monad-mainnet":{"post":{"operationId":"monadMainnetRpc","summary":"Monad mainnet RPC (paid)","description":"Pay-per-request Monad mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0, single or batch: every call carries an id (no duplicate ids in a batch), a method matching ^[A-Za-z][A-Za-z0-9_]*$ and params as an array or an object; at most 100 calls per batch and 1 MiB per body, at this path only. Each call is priced at the weight of x402's table for Monad (GET /pricing → monad.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"monad-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_blockNumber":{"summary":"Single eth_blockNumber","value":{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}}}}}},"responses":{"200":{"description":"The Monad lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → monad.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → monad.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → monad.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/tron-mainnet":{"post":{"operationId":"tronMainnetRpc","summary":"TRON mainnet RPC (paid)","description":"Pay-per-request TRON mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0, single or batch: every call carries an id (no duplicate ids in a batch), a method matching ^[A-Za-z][A-Za-z0-9_]*$ and params as an array or an object; at most 100 calls per batch and 1 MiB per body (the TRON JSON-RPC endpoint, also at /v1/tron-mainnet/jsonrpc). The REST API is at /v1/tron-mainnet/wallet/<method> and /v1/tron-mainnet/walletsolidity/<method>. Each call is priced at the weight of x402's table for TRON (GET /pricing → tron.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"tron-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_blockNumber":{"summary":"Single eth_blockNumber","value":{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}}}}}},"responses":{"200":{"description":"The TRON lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → tron.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → tron.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → tron.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/tron-mainnet/{subPath}":{"post":{"operationId":"tronMainnetRpcSubPath","summary":"TRON mainnet RPC below the root (paid)","description":"Pay-per-request TRON mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). {subPath} is jsonrpc (JSON-RPC, as at the root) or a REST route, wallet/<method> or walletsolidity/<method> in lower case, whose body is one JSON object (no batch) and whose price is the route's own; any other sub-path is 400 invalid_request. Each call is priced at the weight of x402's table for TRON (GET /pricing → tron.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"tron-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}},{"name":"subPath","in":"path","required":true,"description":"The path below /v1/tron-mainnet, slashes included (e.g. wallet/getnowblock).","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100},{"type":"object","description":"The body of a wallet/<method> or walletsolidity/<method> REST call: one JSON object, no batch."}]},"examples":{"getnowblock":{"summary":"REST wallet/getnowblock","value":{}}}}}},"responses":{"200":{"description":"The TRON lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → tron.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/JsonRpcResponse"},{"type":"object","description":"The answer of a wallet/<method> or walletsolidity/<method> REST call: one JSON object, as its lane sends it."}]}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → tron.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → tron.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/sui-mainnet":{"post":{"operationId":"suiMainnetRpc","summary":"Sui mainnet RPC (paid)","description":"Pay-per-request Sui mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Sui is sold as gRPC-web unary calls only, at its service paths below this one (/v1/sui-mainnet/{subPath}); this path is not itself a method: a gRPC-web call to it is 400 method_not_supported, and a body of another Content-Type (Sui JSON-RPC, GraphQL) 400 invalid_request, both before any payment. Each call is priced by its service path, lower-cased (sui.rpc.v2.LedgerService/GetObject as /sui.rpc.v2.ledgerservice/getobject), at the weight of x402's table for Sui (GET /pricing → sui.methods). A call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; one frame is one call (there is no batch). A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"sui-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"description":"The body is one uncompressed gRPC-web unary frame of the method's protobuf request (the binary format of Mysten's GrpcWebFetchTransport): a 0 flag byte, the message length as 4 bytes big-endian, then the message; at most 1 MiB.","content":{"application/grpc-web+proto":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"The Sui lane's answer as it is: one gRPC-web unary frame — the protobuf response, then one grpc-status: 0 trailer — as application/grpc-web+proto, with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"The call's service path, lower-cased: the name GET /pricing → sui.methods prices it by"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/grpc-web+proto":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"error.code invalid_request for a body that is not one gRPC-web unary frame or is of another Content-Type (Sui JSON-RPC and GraphQL are not sold); method_not_supported for a service path outside GET /pricing → sui.methods. No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"The call's service path, lower-cased: the name GET /pricing → sui.methods prices it by"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the call's service path: max(its canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A frame above the 1 MiB its lane takes: error.code invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/sui-mainnet/{subPath}":{"post":{"operationId":"suiMainnetRpcSubPath","summary":"Sui mainnet RPC below the root (paid)","description":"Pay-per-request Sui mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). {subPath} is a Sui gRPC-web service path, one of sui.rpc.v2.LedgerService/GetServiceInfo, sui.rpc.v2.LedgerService/GetCheckpoint, sui.rpc.v2.LedgerService/GetObject, sui.rpc.v2.LedgerService/GetTransaction, sui.rpc.v2.LedgerService/GetEpoch, sui.rpc.v2.MovePackageService/GetPackage, sui.rpc.v2.MovePackageService/GetDatatype, sui.rpc.v2.MovePackageService/GetFunction, sui.rpc.v2.MovePackageService/ListPackageVersions, sui.rpc.v2.NameService/LookupName, sui.rpc.v2.NameService/ReverseLookupName, sui.rpc.v2.SignatureVerificationService/VerifySignature, sui.rpc.v2.StateService/GetCoinInfo, sui.rpc.v2.StateService/GetBalance, sui.rpc.v2.StateService/ListBalances, sui.rpc.v2.StateService/ListDynamicFields, sui.rpc.v2.StateService/ListOwnedObjects, sui.rpc.v2.TransactionExecutionService/ExecuteTransaction, sui.rpc.v2.TransactionExecutionService/SimulateTransaction, and the body is one uncompressed gRPC-web unary frame of the method's protobuf request (the binary format of Mysten's GrpcWebFetchTransport): a 0 flag byte, the message length as 4 bytes big-endian, then the message; at most 1 MiB, sent with Content-Type application/grpc-web+proto (x-grpc-web is not needed: the lane adds it). Any other path is 400 method_not_supported; a body that is not one such frame, or is of another Content-Type (Sui JSON-RPC and GraphQL are not sold), is 400 invalid_request. Each call is priced by its service path, lower-cased (sui.rpc.v2.LedgerService/GetObject as /sui.rpc.v2.ledgerservice/getobject), at the weight of x402's table for Sui (GET /pricing → sui.methods). A call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; one frame is one call (there is no batch). A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"sui-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}},{"name":"subPath","in":"path","required":true,"description":"The path below /v1/sui-mainnet, slashes included (e.g. sui.rpc.v2.LedgerService/GetServiceInfo).","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"The body is one uncompressed gRPC-web unary frame of the method's protobuf request (the binary format of Mysten's GrpcWebFetchTransport): a 0 flag byte, the message length as 4 bytes big-endian, then the message; at most 1 MiB.","content":{"application/grpc-web+proto":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"The Sui lane's answer as it is: one gRPC-web unary frame — the protobuf response, then one grpc-status: 0 trailer — as application/grpc-web+proto, with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"The call's service path, lower-cased: the name GET /pricing → sui.methods prices it by"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/grpc-web+proto":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"error.code invalid_request for a body that is not one gRPC-web unary frame or is of another Content-Type (Sui JSON-RPC and GraphQL are not sold); method_not_supported for a service path outside GET /pricing → sui.methods. No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"The call's service path, lower-cased: the name GET /pricing → sui.methods prices it by"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the call's service path: max(its canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A frame above the 1 MiB its lane takes: error.code invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/near-mainnet":{"post":{"operationId":"nearMainnetRpc","summary":"NEAR mainnet RPC (paid)","description":"Pay-per-request NEAR mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0, single or batch: every call carries an id (no duplicate ids in a batch), a method matching ^[A-Za-z][A-Za-z0-9_]*$ and params as an array or an object; at most 100 calls per batch and 1 MiB per body, at this path only. query and EXPERIMENTAL_changes are priced by the name their selector derives (query-{view_account}, experimental_changes-{account_changes}, …) and every other EXPERIMENTAL_* method but EXPERIMENTAL_receipt_to_tx (priced by its own name) as experimental_*; a selector the lane does not serve is 400 invalid_request. Each call is priced at the weight of x402's table for NEAR (GET /pricing → near.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"near-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"status":{"summary":"Single status","value":{"jsonrpc":"2.0","id":1,"method":"status","params":[]}}}}}},"responses":{"200":{"description":"The NEAR lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → near.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → near.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → near.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/arc-mainnet":{"post":{"operationId":"arcMainnetRpc","summary":"Arc mainnet RPC (paid)","description":"Pay-per-request Arc mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0, single or batch: every call carries an id (no duplicate ids in a batch), a method matching ^[A-Za-z][A-Za-z0-9_]*$ and params as an array or an object; at most 100 calls per batch and 1 MiB per body, at this path only. Each call is priced at the weight of x402's table for Arc (GET /pricing → arc.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"arc-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_blockNumber":{"summary":"Single eth_blockNumber","value":{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}}}}}},"responses":{"200":{"description":"The Arc lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → arc.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → arc.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → arc.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/robinhood-mainnet":{"post":{"operationId":"robinhoodMainnetRpc","summary":"Robinhood mainnet RPC (paid)","description":"Pay-per-request Robinhood mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0, single or batch: every call carries an id (no duplicate ids in a batch), a method matching ^[A-Za-z][A-Za-z0-9_]*$ and params as an array or an object; at most 100 calls per batch and 1 MiB per body, at this path only. Each call is priced at the weight of x402's table for Robinhood (GET /pricing → robinhood.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"robinhood-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_blockNumber":{"summary":"Single eth_blockNumber","value":{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}}}}}},"responses":{"200":{"description":"The Robinhood lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → robinhood.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → robinhood.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → robinhood.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/soneium-mainnet":{"post":{"operationId":"soneiumMainnetRpc","summary":"Soneium mainnet RPC (paid)","description":"Pay-per-request Soneium mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0, single or batch: every call carries an id (no duplicate ids in a batch), a method matching ^[A-Za-z][A-Za-z0-9_]*$ and params as an array or an object; at most 100 calls per batch and 1 MiB per body, at this path only. Each call is priced at the weight of x402's table for Soneium (GET /pricing → soneium.methods). A single call that weighs less than the 1000-atomic ($0.001) facilitator minimum costs $0.001; a batch is summed, then floored once. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"soneium-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_blockNumber":{"summary":"Single eth_blockNumber","value":{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}}}}}},"responses":{"200":{"description":"The Soneium lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → soneium.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → soneium.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → soneium.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large; a body above the 1 MiB its lane takes: invalid_request. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/ava-mainnet":{"post":{"operationId":"avaMainnetRpc","summary":"Avalanche mainnet RPC (paid)","description":"Pay-per-request Avalanche mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0 (\"jsonrpc\": \"2.0\", params an array or an object), routed by the method name to its Avalanche node API: a batch only of C-Chain EVM methods, at most 100 calls; the index.* methods only at their /v1/ava-mainnet/ext/index/* path; the WebSocket-only eth_subscribe and eth_unsubscribe are not offered. The /ext/* paths are served too. eth_* methods are priced at the Ethereum table's weights (an eth_* name it does not list, such as eth_getAssetBalance, at 42) and every other namespace (avax, avm, platform, info, index, proposervm, net, web3, txpool, debug) at a flat 42 tokens (GET /pricing → ava.methods); a batch is summed, then floored once to the 1000-atomic ($0.001) facilitator minimum. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"ava-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","minLength":1},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","minLength":1},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_chainId":{"summary":"Single eth_chainId","value":{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}}}}}},"responses":{"200":{"description":"The Avalanche lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → ava.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → ava.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → ava.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/ava-mainnet/{subPath}":{"post":{"operationId":"avaMainnetRpcSubPath","summary":"Avalanche mainnet RPC below the root (paid)","description":"Pay-per-request Avalanche mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). {subPath} is one of the Avalanche node API paths ext/bc/C/rpc, ext/bc/C/avax, ext/bc/X, ext/vm/avm, ext/bc/P, ext/bc/P/proposervm, ext/info, ext/index/X/tx, ext/index/X/block, ext/index/P/block, ext/index/C/block: every call's namespace must be one that path serves (otherwise 400 invalid_request), a batch is accepted on ext/bc/C/rpc only, a path off the list is 404, and ext/bc/C/ws (the WebSocket endpoint, not sold) is 426. eth_* methods are priced at the Ethereum table's weights (an eth_* name it does not list, such as eth_getAssetBalance, at 42) and every other namespace (avax, avm, platform, info, index, proposervm, net, web3, txpool, debug) at a flat 42 tokens (GET /pricing → ava.methods); a batch is summed, then floored once to the 1000-atomic ($0.001) facilitator minimum. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"ava-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}},{"name":"subPath","in":"path","required":true,"description":"The path below /v1/ava-mainnet, slashes included (e.g. ext/bc/C/rpc).","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","minLength":1},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","minLength":1},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_chainId":{"summary":"Single eth_chainId","value":{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}}}}}},"responses":{"200":{"description":"The Avalanche lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → ava.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → ava.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → ava.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"404":{"description":"A path off the Avalanche /ext/* list (error.code invalid_request), before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"426":{"description":"ext/bc/C/ws, the WebSocket endpoint, which is not sold (error.code invalid_request), before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/v1/base-mainnet":{"post":{"operationId":"baseMainnetRpc","summary":"Base mainnet RPC (paid)","description":"Pay-per-request Base mainnet RPC served by the ERPC edge (no api-key; the payment is the charge). Accepts JSON-RPC 2.0 (\"jsonrpc\": \"2.0\", params an array or an object), single or batch of at most 100 calls, at this path only (a path below it is 404). Calls are priced with the Ethereum table of /v1/eth-mainnet (GET /pricing → base.methods); a batch is summed, then floored once to the 1000-atomic ($0.001) facilitator minimum. A body the lane would refuse is answered 400 invalid_request and a method outside the table 400 method_not_supported, both BEFORE any payment is requested, as is 500 configuration_error while the route has no upstream. The 402 challenge advertises every enabled rail (Solana USDC, Base USDC, Base EURC when enabled); the same body retried with X-Payment is settled on the rail the payer chose and forwarded once to the lane, with no replay and a 30 s timeout. The lane's answer reaches the buyer as it is, a failure envelope included, with X-Payment-Response.","x-pay-pricing":{"model":"per_method_weight","base_token_price_usd":0.000001,"min_charge_atomic":1000,"min_charge_usd":0.001,"currency":"USDC","network":"base","settlement_networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"rpc_chain":"base-mainnet"},"parameters":[{"name":"X-Payment","in":"header","required":false,"description":"x402 payment payload (base64-encoded). Omitted on the first call, which returns 402 with an x402 challenge listing every accepted rail. On the retry the client re-sends the same body with this header carrying the signed payment for the challenged amount — an EIP-3009 transferWithAuthorization on Base (USDC or EURC) or a Solana USDC transfer — and the worker verifies and settles it before proxying upstream. The legacy header name Payment-Signature is also accepted as a fallback. Each settled payment has one forwarding permission. A replay returns 409 duplicate_payment with its stored receipt when verification passes or a read-only lookup after a verification rejection finds it settled.","schema":{"type":"string"}},{"name":"X-ERPC-X402-Attribution-Token","in":"header","required":false,"description":"Optional short-lived account attribution token on a paid retry. It must match the verified payer and payment network. Without it, the payment is anonymous; invalid tokens are rejected before settlement.","schema":{"type":"string","maxLength":4096}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","minLength":1},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},{"type":"array","items":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","minLength":1},"params":{"oneOf":[{"type":"array"},{"type":"object"}]}}},"minItems":1,"maxItems":100}]},"examples":{"eth_blockNumber":{"summary":"Single eth_blockNumber","value":{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}}}}}},"responses":{"200":{"description":"The Base lane's answer as it is (status, body and Content-Type), with X-Payment-Response, X-Request-Id and the pricing headers.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt for the X-Payment submitted on this request (includes the settlement transaction hash and network). Also mirrored as the Payment-Response header."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → base.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged (floored) token weight"},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Charged price in USD"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"400":{"description":"A body the lane would refuse (error.code invalid_request), or a method outside GET /pricing → base.methods (method_not_supported). No payment is requested in this case.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","method_not_supported"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"402":{"description":"Payment Required. Returned (a) before payment with x402 challenge headers, and (b) when a submitted payment is invalid/rejected by the facilitator. `accepts` lists one PaymentRequirements entry per enabled rail: Solana USDC (asset = USDC mint), Base USDC and — when enabled — Base EURC (asset = ERC-20 contract address, extra.name / extra.version = EIP-712 domain for EIP-3009). error.code is payment_required, payment_invalid, price_mismatch, settlement_failed, or payment_amount_too_low. `howToPay` tells a buyer holding none of the accepted assets where to obtain one (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana via CCTP).","headers":{"X-Payment-Required":{"schema":{"type":"string"},"description":"x402 challenge (base64) describing every accepted scheme/network/asset/amount/recipient"},"Payment-Required":{"schema":{"type":"string"},"description":"Human-readable challenge mirror"},"X-Rpc-Methods":{"schema":{"type":"string"},"description":"Comma-separated unique names the request is priced by (GET /pricing → base.methods)"},"X-Rpc-Weight":{"schema":{"type":"integer"},"description":"Charged token weight of the request: max(summed canonical weight, 1000-atomic minimum)."},"X-Rpc-Price-Usd":{"schema":{"type":"string"},"description":"Computed (floored) price in USD for this request; minimum $0.001"},"X-Rpc-Rails-Degraded":{"schema":{"type":"string"},"description":"Present when an advertised rail could not be built this time (comma-separated <network>/<asset>); the remaining rails in accepts are still payable."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"409":{"description":"Duplicate payment. A durable shard retains the payment identity and grants at most one upstream execution. When available, its receipt is returned in the payment response headers. On verification rejection the worker performs a read-only settled-receipt lookup; unknown or absent payments retain the verification refusal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicatePaymentBody"}}}},"413":{"description":"A batch above 100 calls: error.code batch_too_large. Before any payment.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["batch_too_large"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"500":{"description":"error.code configuration_error, before any payment: this route cannot serve requests right now. No payment is requested.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["configuration_error"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}},"502":{"description":"error.code upstream_error: the payment settled and the upstream call failed with no response, so X-Payment-Response is present. An upstream that answers 502 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}},"503":{"description":"error.code payment_unavailable: no payment rail could be offered or a verified payer was unavailable; no settlement was dispatched, and X-Payment-Response is absent. Retry-After is supplied when applicable. error.code service_busy: concurrency or durable capacity is unavailable, or settlement is pending or its outcome is unknown. An unknown outcome may have settled; the worker does not resettle it. An upstream that answers 503 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response: that payment was charged and a retry is a new payment.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for concurrency or rail unavailability when the worker supplies a retry interval; an upstream 503 carries it only if the upstream sent it."},"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableBody"}}}},"504":{"description":"error.code upstream_timeout: the payment settled and the upstream call timed out, so X-Payment-Response is present. An upstream that answers 504 itself is passed through after settlement with its own body and Content-Type, which this schema does not describe, and with X-Payment-Response.","headers":{"X-Payment-Response":{"schema":{"type":"string"},"description":"Base64-encoded x402 settlement receipt. Present on a settled response or settled duplicate; absent when settlement is pending or its outcome is unknown."},"Payment-Response":{"schema":{"type":"string"},"description":"Same value as X-Payment-Response."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayErrorBody"}}}}}}},"/health":{"get":{"operationId":"health","summary":"Public health probe (free)","responses":{"200":{"description":"Health status","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"version":{"type":"string"},"network":{"type":"string","description":"Solana settlement network (solana | solana-devnet)"},"region":{"type":"string","description":"Cloudflare data center that answered this request (the same code as in the cf-ray header)."},"evmNetwork":{"type":"string","description":"EVM settlement network (base | base-sepolia)"},"evmRailEnabled":{"type":"boolean"},"rails":{"type":"array","description":"Enabled payment rails","items":{"$ref":"#/components/schemas/PaymentRail"}},"pausedRails":{"type":"array","description":"Configured rails the operator has switched off (not in rails / accepts).","items":{"$ref":"#/components/schemas/PausedRail"}},"howToPay":{"$ref":"#/components/schemas/HowToPay"},"endpoints":{"type":"array","items":{"type":"string"}},"ethStatus":{"type":"string","enum":["ready","unconfigured"],"description":"Whether POST /v1/eth-mainnet takes a paid request now, by the rule of /.well-known/x402 → endpoints[].status: unconfigured answers 500 configuration_error before any payment."},"lanes":{"type":"array","description":"One row per /v1/<chain>-mainnet route of the edge chains (endpoints keeps the two routes that predate them).","items":{"type":"object","properties":{"chain":{"type":"string","enum":["bitcoin","polygon","kaia","bsc","arbitrum","optimism","hyperliquid","monad","tron","sui","near","arc","robinhood","soneium","ava","base"]},"endpoint":{"type":"string"},"status":{"type":"string","enum":["ready","unconfigured"],"description":"As /.well-known/x402 → endpoints[].status: unconfigured answers 500 configuration_error before any payment."}}}},"topup":{"type":"object","description":"Credit top-up rail (the /v1/credits/topup/sessions routes).","properties":{"enabled":{"type":"boolean","description":"False while the top-up routes refuse new sessions before any payment."},"maxCreditsPerTx":{"type":"integer"},"maxPerAccountPerHour":{"type":"integer"}}}}}}}}}}},"/pricing":{"get":{"operationId":"pricing","summary":"Public weight + USD price table (free)","responses":{"200":{"description":"Per-method weight and price","content":{"application/json":{"schema":{"type":"object","properties":{"tokenPriceUsd":{"type":"number"},"minChargeAtomic":{"type":"integer","description":"Minimum charge per payment in atomic USDC (CDP facilitator floor); 1000 = $0.001"},"minChargeUsd":{"type":"number","description":"Minimum charge in USD ($0.001)"},"defaultUnknownMethodWeight":{"type":"integer","description":"Charged (floored) weight for unknown methods"},"defaultUnknownMethodRawWeight":{"type":"integer","description":"Canonical pre-floor weight for unknown methods (42)"},"defaultUnknownMethodPriceUsd":{"type":"number"},"solana":{"type":"object","description":"Solana table (/v1/solana-mainnet); same entries as top-level methods","properties":{"endpoint":{"type":"string"},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"ethereum":{"type":"object","description":"Ethereum table (/v1/eth-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"standardMethodWeight":{"type":"integer"},"standardMethodRawWeight":{"type":"integer"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"bitcoin":{"type":"object","description":"Bitcoin table (/v1/bitcoin-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["edge-fixed-http"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"polygon":{"type":"object","description":"Polygon table (/v1/polygon-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["edge-fixed-http"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"kaia":{"type":"object","description":"Kaia table (/v1/kaia-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["edge-fixed-http"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"bsc":{"type":"object","description":"BSC table (/v1/bsc-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["edge-fixed-http"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"arbitrum":{"type":"object","description":"Arbitrum table (/v1/arbitrum-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["edge-fixed-http"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"optimism":{"type":"object","description":"Optimism table (/v1/optimism-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["edge-fixed-http"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"hyperliquid":{"type":"object","description":"Hyperliquid table (/v1/hyperliquid-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["edge-fixed-http"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"monad":{"type":"object","description":"Monad table (/v1/monad-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["edge-fixed-http"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"tron":{"type":"object","description":"TRON table (/v1/tron-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["edge-fixed-http"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"sui":{"type":"object","description":"Sui table (/v1/sui-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["edge-fixed-http"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"near":{"type":"object","description":"NEAR table (/v1/near-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["edge-fixed-http"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"arc":{"type":"object","description":"Arc table (/v1/arc-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["edge-fixed-http"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"robinhood":{"type":"object","description":"Robinhood table (/v1/robinhood-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["edge-fixed-http"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"soneium":{"type":"object","description":"Soneium table (/v1/soneium-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["edge-fixed-http"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"ava":{"type":"object","description":"Avalanche table (/v1/ava-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["ava-method-table"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"base":{"type":"object","description":"Base table (/v1/base-mainnet). Methods outside it are rejected with 400 method_not_supported.","properties":{"endpoint":{"type":"string"},"unknownMethodPolicy":{"type":"string","enum":["reject_400_method_not_supported"]},"pricingSource":{"type":"string","enum":["ethereum-method-weights"]},"methods":{"type":"array","items":{"$ref":"#/components/schemas/PricingTableEntry"}}}},"methods":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string"},"weight":{"type":"integer","description":"Charged token weight after the minimum-charge floor"},"rawWeight":{"type":"integer","description":"Canonical token weight before the floor"},"floored":{"type":"boolean","description":"True when the floor raised this method above its canonical weight"},"priceUsd":{"type":"number"},"price":{"type":"string"},"dynamic":{"type":"boolean","description":"True when the weight scales with request params (getMultipleAccounts per pubkey, getSignatureStatuses per signature); the row prices one call for one pubkey or one signature"},"note":{"type":"string"}}}}}}}}}}}},"/.well-known/x402":{"get":{"operationId":"wellKnownX402","summary":"x402 scheme and network metadata (free)","responses":{"200":{"description":"x402 capabilities","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"facilitator":{"type":"string"},"accepts":{"type":"array","description":"One entry per (endpoint × enabled rail)","items":{"type":"object","properties":{"scheme":{"type":"string"},"network":{"type":"string"},"asset":{"type":"string"},"assetAddress":{"type":"string"},"endpoint":{"type":"string"},"methods":{"type":"array","items":{"type":"string"}}}}},"endpoints":{"type":"array","items":{"type":"object","properties":{"endpoint":{"type":"string"},"chain":{"type":"string","enum":["solana","ethereum","bitcoin","polygon","kaia","bsc","arbitrum","optimism","hyperliquid","monad","tron","sui","near","arc","robinhood","soneium","ava","base"]},"methods":{"type":"array","items":{"type":"string"}},"accepts":{"type":"array","items":{"$ref":"#/components/schemas/PaymentRail"}},"status":{"type":"string","enum":["ready","unconfigured"],"description":"unconfigured = the endpoint answers 500 configuration_error before payment until its upstream is configured and at least one payment rail is enabled"}}}},"pausedRails":{"type":"array","description":"Configured rails the operator has switched off (not in accepts).","items":{"$ref":"#/components/schemas/PausedRail"}},"howToPay":{"$ref":"#/components/schemas/HowToPay"}}}}}}}}}},"components":{"schemas":{"JsonRpcRequest":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"method":{"type":"string"},"params":{}}},"JsonRpcResponse":{"type":"object","properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"integer"},{"type":"null"}]},"result":{},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{}}}}},"PaymentRail":{"type":"object","description":"A (network, asset, scheme) a buyer may settle with.","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string","description":"CAIP-2 network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | eip155:8453 | eip155:84532"},"asset":{"type":"string","enum":["USDC","EURC"]},"assetAddress":{"type":"string","description":"EVM rails only: ERC-20 contract address"}}},"PaymentRequirements":{"type":"object","description":"x402 PaymentRequirements (one per rail in `accepts`). For Solana, asset is the USDC mint and extra carries the facilitator feePayer. For Base, asset is the USDC/EURC ERC-20 address and extra.name / extra.version is the EIP-712 domain the EIP-3009 transferWithAuthorization must be signed against. extra.erpc echoes the priced methods.","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"asset":{"type":"string"},"amount":{"type":"string","description":"Atomic units (6 decimals for USDC / EURC)"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","properties":{"name":{"type":"string","description":"EVM: EIP-712 domain name (e.g. \"USD Coin\", \"EURC\")"},"version":{"type":"string","description":"EVM: EIP-712 domain version (\"2\")"},"feePayer":{"type":"string","description":"Solana: facilitator fee payer"},"erpc":{"type":"object","properties":{"methods":{"type":"array","items":{"type":"string"}},"weight":{"type":"integer"},"priceUsd":{"type":"number","description":"USD-denominated price (1 token = $0.000001)"},"tokenPriceUsd":{"type":"number"},"settlement":{"type":"object","description":"EVM rails only: what is actually settled. On a EURC rail the same atomic amount is charged at par with USDC (no FX), which `note` states.","properties":{"asset":{"type":"string","enum":["USDC","EURC"]},"amountAtomic":{"type":"integer"},"decimals":{"type":"integer"},"note":{"type":"string"}}}}}}}}},"PricingTableEntry":{"type":"object","properties":{"method":{"type":"string"},"weight":{"type":"integer","description":"Charged token weight after the minimum-charge floor"},"rawWeight":{"type":"integer","description":"Canonical token weight before the floor"},"floored":{"type":"boolean"},"priceUsd":{"type":"number"},"price":{"type":"string"},"dynamic":{"type":"boolean"},"note":{"type":"string"}}},"MethodNotSupportedBody":{"type":"object","description":"Returned at HTTP 400 when a method is outside GET /pricing → ethereum.methods (the WebSocket-only eth_subscribe / eth_unsubscribe included).","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["method_not_supported","invalid_request"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}},"PaymentRequiredBody":{"type":"object","properties":{"x402Version":{"type":"integer"},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"}}},"accepts":{"type":"array","description":"One PaymentRequirements per enabled rail (Solana USDC, Base USDC, Base EURC when enabled)","items":{"$ref":"#/components/schemas/PaymentRequirements"}},"error":{"type":"object","properties":{"code":{"type":"string","enum":["payment_required","payment_invalid","price_mismatch","settlement_failed","payment_amount_too_low"]},"message":{"type":"string"},"request_id":{"type":"string"}}},"pricing":{"type":"object","description":"Computed pricing for the submitted request.","properties":{"weight":{"type":"integer","description":"Charged (floored) token weight"},"rawWeight":{"type":"integer","description":"Canonical pre-floor token weight"},"floored":{"type":"boolean"},"minChargeAtomic":{"type":"integer","description":"1000 ($0.001)"},"priceUsd":{"type":"number"},"price":{"type":"string"}}},"howToPay":{"$ref":"#/components/schemas/HowToPay"}}},"PausedRail":{"type":"object","description":"A rail ERPC can settle on but has paused. It is not in `accepts` and will not settle until it is resumed.","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string"},"asset":{"type":"string","enum":["USDC","EURC"]},"reason":{"type":"string","enum":["paused by operator"]}}},"HowToPay":{"type":"object","description":"Buyer guidance derived from the enabled rails and, on a 402, narrowed to the rails that request could offer: which assets settle on this response, which are paused, and the shortest ways to obtain an accepted asset (swap USDC→EURC on Base, convert EUR to EURC, bridge USDC from Solana with Circle CCTP). Venues are Base mainnet facts listed for convenience; ERPC does not operate them.","properties":{"summary":{"type":"string","description":"One sentence an agent can act on."},"accepted":{"type":"array","items":{"type":"object","properties":{"network":{"type":"string"},"asset":{"type":"string","enum":["USDC","EURC"]},"assetAddress":{"type":"string","description":"EVM rails only: ERC-20 contract address"},"decimals":{"type":"integer","enum":[6]}}}},"paused":{"type":"array","items":{"type":"object","properties":{"network":{"type":"string"},"asset":{"type":"string"},"reason":{"type":"string"}}}},"getAsset":{"type":"array","description":"Most direct route first.","items":{"type":"object","properties":{"route":{"type":"string","enum":["swap-on-base","buy-with-eur","bridge-from-solana"]},"description":{"type":"string"},"venue":{"type":"string"},"url":{"type":"string"},"pool":{"type":"string","description":"Pool contract on Base mainnet (swap routes only), for reference. Quote through the venue router with a slippage cap; do not trade against the pool directly."}}}},"pricing":{"type":"string"}}},"ServiceUnavailableBody":{"type":"object","description":"Returned at HTTP 503 before any payment step: no payment rail could be offered, or the worker is at its concurrency limit.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["payment_unavailable","service_busy"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}},"GatewayErrorBody":{"type":"object","description":"Returned at HTTP 502 or 504 when the upstream call failed or timed out after settlement.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["settlement_failed","upstream_error","upstream_timeout"]},"message":{"type":"string"},"request_id":{"type":"string"}}},"pricing":{"type":"object","description":"Computed pricing for the submitted request. Present on settlement_failed only.","properties":{"weight":{"type":"integer","description":"Charged (floored) token weight"},"rawWeight":{"type":"integer","description":"Canonical pre-floor token weight"},"floored":{"type":"boolean"},"minChargeAtomic":{"type":"integer","description":"1000 ($0.001)"},"priceUsd":{"type":"number"},"price":{"type":"string"}}}}},"DuplicatePaymentBody":{"type":"object","description":"Returned at HTTP 409 when a replay reaches the durable shard or a read-only lookup after verification rejection finds its settled receipt.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["duplicate_payment"]},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}}}