Saltar al contenido principal
Ace Data Cloud X402 actualmente se centra en la liquidación en USDC y admite dos tipos de cadenas: EVM y Solana. Los métodos de firma, las direcciones de activos, el comportamiento del gas y los escenarios aplicables difieren según la red, por lo que es necesario elegir la red antes de la integración.

Los identificadores de red usan CAIP-2

El accepts[].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:
La respuesta de Facilitator /supported:
Explicación de los resultados:
  • Los exact de 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.facilitatorAddress de la entrada upto es 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:
En el esquema exact, el cliente firma EIP-712 TransferWithAuthorization. El contenido de la firma incluye:
  • from: dirección de la wallet pagadora
  • to: dirección receptora de Ace Data Cloud
  • value: importe de este pago
  • validAfter / validBefore: ventana de validez de la firma
  • nonce: nonce aleatorio de 32 bytes
Después de verificar la firma, el Facilitator llamará a 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:
Explicación de los resultados:
  • 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.
  • 95215 atomic USDC corresponde a 0.095215 USDC, que es el importe de liquidación real de esta llamada a la API.
Resultado de ejecución del programa de pago de pedidos Base exact:
Explicación de los resultados:
  • El estado final del pedido de la plataforma es Finished.
  • El pay_id del pedido se escribe en el mismo hash de transacción de Base.
  • 1200000 atomic USDC corresponde a 1.2 USDC, 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 los accepts devueltos por la API. Los accepts 402 típicos de SKALE incluirán:
SKALE actualmente solo proporciona exact. Si necesitas medición posterior, utiliza Base upto. Ejemplo de resultado de verificación de SKALE exact:
Explicación de los resultados:
  • 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 exact payment is 0.095215 USDC.

Solana

Solana uses SPL USDC TransferChecked. 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.
If using wallet fee payer mode, the wallet directly submits the transaction, and the Facilitator is responsible for confirming the transaction and returning the settlement result. Example of Solana exact verification result:
Result description:
  • 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-returned accepts; 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.