Los identificadores de red usan CAIP-2
Elaccepts[].network de x402 v2 es un identificador CAIP-2, no abreviaturas como base o skale. Al coincidir redes, el cliente debe comparar mediante cadenas CAIP-2:
Matriz de soporte
upto actualmente solo se proporciona en Base. Los elementos realmente disponibles están sujetos a los accepts devueltos por la API. También puedes consultar el Facilitator:
/supported:
- Los
exactde Base, SKALE y Solana son rutas de pago de importe fijo. - Solo Base proporciona la ruta de medición posterior
upto, que depende de la aprobación de Permit2. - El
extra.facilitatorAddressde la entradauptoes la dirección que debe escribirse en el witness al firmar en el cliente, y debe coincidir con el valor devuelto por el servidor.
Base
Base utiliza el contrato oficial de USDC:exact, el cliente firma EIP-712 TransferWithAuthorization. El contenido de la firma incluye:
from: dirección de la wallet pagadorato: dirección receptora de Ace Data Cloudvalue: importe de este pagovalidAfter/validBefore: ventana de validez de la firmanonce: nonce aleatorio de 32 bytes
transferWithAuthorization de USDC on-chain para completar la transferencia.
Base es la red de integración formal más recomendada, especialmente adecuada para la medición posterior upto, ya que el ecosistema de Permit2, USDC y wallets es más maduro.
Ejemplo de resultado de verificación de Base exact:
- El reintento pagado de la API devuelve el contenido del modelo
ADC_BASE_E2E_OK. - La transacción on-chain ya puede consultarse en BaseScan, y el número de bloque es
46726299. 95215atomic USDC corresponde a0.095215USDC, que es el importe de liquidación real de esta llamada a la API.
exact:
- El estado final del pedido de la plataforma es
Finished. - El
pay_iddel pedido se escribe en el mismo hash de transacción de Base. 1200000atomic USDC corresponde a1.2USDC, que es el importe histórico realmente pagado por este pedido de 10 Credits bajo la política anterior; los nuevos pedidos ya no disfrutan adicionalmente del descuento por el método de pago X402, y el importe específico de la firma está sujeto a la respuesta 402 de esta ocasión.
SKALE
SKALE utiliza USDC bridged, y el método de firma es similar al de Base, también EIP-3009. Es adecuado para escenarios de pago EVM de bajo coste de gas; las llamadas reales siguen estando sujetas a losaccepts devueltos por la API.
Los accepts 402 típicos de SKALE incluirán:
exact. Si necesitas medición posterior, utiliza Base upto.
Ejemplo de resultado de verificación de SKALE exact:
- API paid retry returns model content
ADC_SKALE_E2E_OK. - The transaction is searchable in the SKALE explorer, and the block number is
1969317. - The settlement amount for this
exactpayment is0.095215USDC.
Solana
Solana uses SPL USDCTransferChecked. The client constructs a transfer transaction, signs and submits it, then places the transaction signature or serialized transaction into the PAYMENT-SIGNATURE envelope.
Solana characteristics:
- Uses a Solana wallet adapter or base58 secret key;
- The asset is the Solana USDC mint;
- Currently only supports
exact; - The Facilitator verifies the mint, destination, authority, and amount of the transfer instruction.
exact verification result:
- The paid retry has returned HTTP 200, and the model output is
ADC_SOLANA_E2E_OK. - Rate limiting may be encountered when querying the on-chain signature through a public RPC.
- Because public RPC queries may be rate-limited, the Solana explorer is not included here. When strict reconciliation is required, please use your own Solana RPC or platform-side settlement records to confirm the transaction signature.
How to choose
Regardless of which chain you choose, do not hardcode prices in the client. Prices are determined by
accepts[].maxAmountRequired returned by the server.
Added EVM networks
Code support has been provided for fixed-amount native USDC payments on the following networks, which will be enabled one by one by network. Availability is determined by the order or the API-returnedaccepts; this does not mean that all networks have been enabled in production.
These networks only support
exact, and the token precision is 6. Do not use bridged USDC with the same name.
When using the official TypeScript/Python X402 Client, you can pass the alias or CAIP-2 identifier from the table.
The client constructs the signature using the target chain ID; the wallet must support the target network.
The official support table for the Phantom extension wallet lists Arbitrum and Polygon; Optimism and Avalanche
are currently not listed in that table, and you can use Rabby or MetaMask that supports the target chain. EVM addresses can be the same across different chains,
but balances are independent from each other, and Solana addresses do not apply to EVM USDC.
See the Phantom wallet support table.
New network gradual rollout entry
New chain entries are hidden by default. When accessing the console or Studio, you can use?features=x402-arbitrum
to enable the corresponding chain, with multiple flags separated by commas. To disable a single chain, use ?features=-x402-arbitrum,
and to clear local overrides, use ?features=none. Switches are stored separately for each domain.
Order quotes and payment retries use the same switch, while the server performs independent validation; existing payment records can still be viewed.
Enabling only the page flag will not enable chains that have not yet been configured; the specific payable networks are still determined by real-time accepts.
