El identificador de red utiliza CAIP-2
Elaccepts[].network de x402 v2 es un identificador CAIP-2, no una abreviatura como base o solana. El cliente debe comparar según la cadena CAIP-2 al hacer coincidir redes:
Matriz de soporte
upto actualmente solo se proporciona en Base. Los elementos realmente disponibles se rigen por los accepts devueltos por la API. También puedes consultar el Facilitator:
/supported:
- Los
exactde Base 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.facilitatorAddressen la entradauptoes 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: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 tiempo de validez de la firmanonce: nonce aleatorio de 32 bytes
transferWithAuthorization de USDC on-chain para completar la transferencia.
Base es la red más recomendada para la integración formal, especialmente adecuada para la medición posterior upto, porque los ecosistemas de Permit2, USDC y wallets son más maduros.
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 se puede consultar en BaseScan, y el número de bloque es
46726299. 95215atomic USDC corresponde a0.095215USDC, que es el importe real liquidado para esta llamada de API.
exact:
- El estado final del pedido en la plataforma es
Finished. - El
pay_iddel pedido escribe 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 pedidos nuevos ya no disfrutan de un descuento adicional por el método de pago X402, y el importe específico de la firma se rige por la respuesta 402 de esta vez.
Solana
Solana utiliza SPL USDCTransferChecked. El cliente construye una transacción de transferencia, la firma y la envía, y luego coloca 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 una clave secreta base58;
- El activo es Solana USDC mint;
- Actualmente solo admite
exact; - El Facilitator verificará el mint, destination, authority y amount de la instrucción de transferencia.
exact:
- El reintento pagado ya devolvió HTTP 200, y el modelo generó
ADC_SOLANA_E2E_OK. - Al consultar la signature on-chain mediante RPC público, es posible encontrar limitación de tasa.
- Debido a que las consultas mediante RPC público pueden tener limitación de tasa, aquí no se escribe el explorer de Solana. Cuando se requiera una conciliación estricta, utiliza tu propio RPC de Solana o los registros de settlement de la plataforma para confirmar la firma de la transacción.
Cómo elegir
Independientemente de la cadena que elijas, no codifiques los precios de forma fija en el cliente. El precio lo determina
accepts[].maxAmountRequired devuelto por el servidor.
Añadir redes EVM
El soporte de código para pagos de importe fijo en USDC nativo en las siguientes redes se ha proporcionado, y se habilita red por red. La disponibilidad se determina por losaccepts devueltos por el pedido o la API; no representa que todas las redes estén habilitadas en producción.
Estas redes solo admiten
exact, y la precisión de la moneda es 6. No utilices USDC puenteado con el mismo nombre.
Al utilizar el X402 Client oficial de TypeScript/Python, puedes pasar la abreviatura de la tabla o el identificador CAIP-2.
El cliente utiliza el ID de la cadena de destino para construir la firma; la billetera debe admitir la red de destino.
La tabla oficial de soporte de la billetera de extensión Phantom incluye Arbitrum y Polygon; Optimism y Avalanche
actualmente no están incluidos en esta tabla, se puede utilizar Rabby o MetaMask que admita la cadena de destino. Las direcciones EVM pueden ser iguales en diferentes cadenas,
pero los saldos son independientes entre sí, y las direcciones de Solana no son aplicables a USDC de EVM.
Consulta la tabla de soporte de la billetera Phantom.
Entrada de despliegue gradual de nuevas redes
La entrada para nuevas cadenas está oculta de forma predeterminada. Al acceder a la consola o Studio, puedes utilizar?features=x402-arbitrum
para habilitar la cadena correspondiente, y separar varios flags con comas. Para deshabilitar una sola cadena, utiliza ?features=-x402-arbitrum,
y para eliminar las anulaciones locales, utiliza ?features=none. Los interruptores se guardan por separado para cada dominio.
La cotización del pedido y los reintentos de pago utilizan el mismo interruptor, el servidor realizará una validación independiente; los registros de pago existentes aún pueden consultarse.
Habilitar únicamente el flag de la página no habilitará cadenas que aún no estén configuradas; las redes específicas que pueden pagarse siguen determinándose por los accepts en tiempo real.
