/ Especificación x402 v2
Referencia del protocolo.
Protocolo x402 v2 completo: headers de request/response, esquemas JSON, estructuras EIP-712, redes soportadas y direcciones de contratos.
1. El cliente envía la request inicial
Una request HTTP estándar a un recurso protegido. No necesitas headers especiales en el primer intento.
2. El servidor devuelve 402 + payment-required
La respuesta incluye un header payment-required: un objeto JSON en Base64 que especifica versión x402, métodos de pago aceptados, importes, dirección del receptor e ID del recurso.
3. El cliente firma el pago
La wallet parsea los requisitos, elige EIP-3009 o Permit2, construye los datos tipados EIP-712 y firma con tu clave privada.
4. El cliente reintenta con payment-signature
La request original se reenvía con un header payment-signature que contiene el payload de autorización firmado (JSON en Base64).
5. El servidor verifica y entrega
El servidor decodifica la firma, envía la meta-tx (EIP-3009) o la tx de liquidación (Permit2) on-chain, confirma el recibo y devuelve el recurso con un header payment-response.
Esquema del header payment-required
{
"x402Version": 2,
"accepts": [
{
"scheme": "eip3009",
"network": "base",
"token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"maxAmountRequired": "100000",
"resource": "/api/inference",
"description": "GPU inference — 1 request",
"mimeType": "application/json",
"payTo": "0x...facilitator",
"extra": {}
}
]
}Redes soportadas
x402 v2 liquida en USDC en estas redes EVM:
| Chain | Chain ID | USDC address |
|---|---|---|
| Ethereum | 1 | 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 |
| Polygon | 137 | 0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359 |
| Base | 8453 | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
| Arbitrum | 42161 | 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 |
| Optimism | 10 | 0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85 |
| BSC | 56 | 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d |
Datos tipados EIP-712
Ambos métodos de firma usan datos estructurados EIP-712 para seguridad y legibilidad. La wallet te muestra campos legibles antes de firmar.
EIP-3009 types
TransferWithAuthorization(
address from,
address to,
uint256 value,
uint256 validAfter,
uint256 validBefore,
bytes32 nonce
)Permit2 types
PermitWitnessTransferFrom(
TokenPermissions permitted,
address spender,
uint256 nonce,
uint256 deadline,
X402Witness witness
)
TokenPermissions(
address token,
uint256 amount
)Última actualización: