@acedatacloud/x402-client se encarga de firmar el encabezado de solicitud PAYMENT-SIGNATURE al encontrar 402 Payment Required.
Direcciones de código fuente y paquetes:
- Repositorio del SDK: https://github.com/AceDataCloud/SDK
- Repositorio de X402 Client: https://github.com/AceDataCloud/X402Client
- SDK npm: https://www.npmjs.com/package/@acedatacloud/sdk
- X402 Client npm: https://www.npmjs.com/package/@acedatacloud/x402-client
Instalar dependencias
@solana/web3.js:
- Tanto
@acedatacloud/sdkcomo@acedatacloud/x402-clientse pueden instalar desde npm e importar mediante Node.js. ethersse utiliza para la firma de typed data de EVM, y@solana/web3.jsse utiliza para la construcción de transacciones de Solana.
Ejemplo de Base
En el navegador se puede usar directamentewindow.ethereum. En Node.js se puede envolver ethers.Wallet con un provider de estilo EIP-1193.
Ejemplo de wallet de navegador
Al usar MetaMask, Coinbase Wallet o WalletConnect en una aplicación frontend, normalmente se pasa directamente el provider EIP-1193:Ejemplo de Solana
Solana utiliza SPL USDCTransferChecked. El wallet adapter pasado debe exponer publicKey y signAndSendTransaction.
exact, no admite upto. Si la API devuelve varios accepts, el handler seleccionará el elemento con network = 'solana'.
La ruta de Solana se ha verificado en la misma API pública, donde el reintento de pago puede devolver HTTP 200 y ADC_SOLANA_E2E_OK. Las consultas RPC públicas pueden estar limitadas por tasa, por lo que este artículo no escribe el hash de tx de Solana; cuando se necesite conciliación en cadena, utiliza tu propio RPC de Solana o confirma mediante los registros de la consola.
Elegir exact o upto
El handler actual de TypeScript elegirá el primer payment requirement de la red coincidente devuelto por el servidor. La API de Ace Data Cloud normalmente coloca el exact de la misma red antes de upto, por lo que si explícitamente deseas usar medición posterior, debes pasar preferScheme: 'upto'.
Ejemplo:
upto para esa red, el handler volverá automáticamente al primer requirement disponible de esa red, normalmente exact.
upto requiere una autorización única de Permit2. Actualmente, upto solo se proporciona en Base, por lo que solo se necesita realizar una autorización para Base USDC:
upto ha completado la verificación de API pública: HTTP 402 -> HTTP 200, la tx de settlement posterior es 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036. La salida completa se encuentra en la explicación del esquema de facturación.
Qué hace el SDK
El transport de@acedatacloud/sdk ejecutará una vez el payment handler al recibir 402:
@acedatacloud/x402-client hará lo siguiente:
- Selecciona el payment requirement de la red objetivo de
ctx.accepts. - Construye una firma EVM EIP-712 o una transacción de transferencia Solana según la red.
- Serializa el envelope como Base64.
- Devuelve
{ headers: { 'PAYMENT-SIGNATURE': '<base64>' } }. - El SDK reintenta automáticamente con el cuerpo de solicitud original.

