Skip to main content
Ace Data Cloud X402 actualmente se centra en la liquidación con 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 entre redes, 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 una abreviatura como base o skale. El cliente debe comparar las redes 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 Permit2 approve.
  • La extra.facilitatorAddress en la entrada upto es la dirección que el cliente debe escribir en el witness al firmar, 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 billetera 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, 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 Permit2, USDC y el ecosistema de billeteras son más maduros. 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 se puede consultar en BaseScan y el número de bloque es 46726299.
  • 95215 USDC atómico 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 para el pago de pedido Base exact:
Explicación de los resultados:
  • El estado final del pedido de la plataforma es Finished.
  • El pay_id del pedido registra el mismo hash de transacción de Base.
  • 1200000 USDC atómico corresponde a 1.2 USDC, que es el importe histórico realmente pagado de este pedido de 10 Credits bajo la política anterior; los nuevos pedidos ya no disfrutan adicionalmente del descuento del método de pago X402, y el importe específico de la firma está sujeto a la respuesta 402 de esta vez.

​
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 con bajo costo de gas; las llamadas reales siguen estando sujetas a los accepts devueltos por la API. Los accepts típicos de 402 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:
  • El reintento pagado de la API devuelve el contenido del modelo ADC_SKALE_E2E_OK。
  • La transacción ya puede consultarse en el explorer de SKALE, el número de bloque es 1969317。
  • El importe de liquidación de este pago exact es 0.095215 USDC。

​
Solana

Solana utiliza SPL USDC TransferChecked。El cliente construirá una transacción de transferencia, la firmará y enviará, y después colocará la firma de la transacción o la transacción serializada en el envelope PAYMENT-SIGNATURE。 Características de Solana：
  • utiliza Solana wallet adapter o base58 secret key；
  • el activo es Solana USDC mint；
  • actualmente solo admite exact；
  • Facilitator validará el mint, destination, authority y amount de la instrucción de transferencia。
Si se utiliza el modo de wallet fee payer, la wallet enviará directamente la transacción, y Facilitator será responsable de confirmar la transacción y devolver el resultado de settlement。 Ejemplo del resultado de validación de Solana exact：
Explicación de los resultados：
  • el reintento pagado ya devolvió HTTP 200, y la salida del modelo es ADC_SOLANA_E2E_OK。
  • al consultar la signature en cadena mediante RPC público, es posible encontrar limitación de tasa。
  • debido a que las consultas RPC públicas pueden tener limitación de tasa, aquí no se incluye Solana explorer。Cuando se requiera una conciliación estricta, utilice su propio Solana RPC o los registros de settlement del lado de la plataforma para confirmar la firma de la transacción。

​
Cómo elegir

Independientemente de la cadena que elija, no codifique el precio de forma fija en el cliente。El precio lo determina accepts[].maxAmountRequired devuelto por el servidor。