@acedatacloud/x402-client é responsável por assinar o cabeçalho de solicitação PAYMENT-SIGNATURE ao encontrar 402 Payment Required.
Endereços do código-fonte e dos pacotes:
- Repositório do SDK: https://github.com/AceDataCloud/SDK
- Repositório do X402 Client: https://github.com/AceDataCloud/X402Client
- npm SDK: https://www.npmjs.com/package/@acedatacloud/sdk
- npm X402 Client: https://www.npmjs.com/package/@acedatacloud/x402-client
Instalar dependências
@solana/web3.js:
@acedatacloud/sdke@acedatacloud/x402-clientpodem ambos ser instalados pelo npm e importados pelo Node.js.ethersé usado para assinatura de typed data EVM, e@solana/web3.jsé usado para construção de transações Solana.
Exemplo Base
No navegador, é possível usarwindow.ethereum diretamente. No Node.js, é possível envolver ethers.Wallet em um provider no estilo EIP-1193.
Exemplo de carteira no navegador
Ao usar MetaMask, Coinbase Wallet ou WalletConnect em aplicações frontend, normalmente o provider EIP-1193 é passado diretamente:Exemplo Solana
Solana usa SPL USDCTransferChecked. O adaptador de carteira passado precisa expor publicKey e signAndSendTransaction.
exact, e não suporta upto. Se a API retornar vários accepts, o handler escolherá aquele com network = 'solana'.
O caminho Solana foi verificado na mesma API pública, onde a nova tentativa paga pode retornar HTTP 200 e ADC_SOLANA_E2E_OK. Consultas RPC públicas podem sofrer limitação de taxa, por isso este texto não inclui o hash da tx Solana; quando for necessário conciliar on-chain, use seu próprio RPC Solana ou confirme pelos registros do console.
Escolher exact ou upto
O handler TypeScript atual escolherá o primeiro payment requirement da rede correspondente retornado pelo servidor. As APIs do Ace Data Cloud normalmente colocam o exact da mesma rede antes de upto, portanto, se você deseja explicitamente usar medição posterior, precisa passar preferScheme: 'upto'.
Exemplo:
upto para essa rede, o handler voltará automaticamente para o primeiro requirement disponível dessa rede, normalmente exact.
upto requer uma autorização Permit2 única. Atualmente, upto é fornecido apenas na Base, portanto, basta fazer uma autorização para o USDC da Base:
upto da Base concluiu a verificação da API pública: HTTP 402 -> HTTP 200, e a tx de settlement posterior é 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036. A saída completa está na explicação do plano de cobrança.
O que o SDK faz
O transport de@acedatacloud/sdk executará um payment handler uma vez ao receber 402:
@acedatacloud/x402-client irá:
- Selecionar o payment requirement da rede de destino em
ctx.accepts. - Construir uma assinatura EVM EIP-712 ou uma transaction de transferência Solana de acordo com a rede.
- Serializar o envelope em Base64.
- Retornar
{ headers: { 'PAYMENT-SIGNATURE': '<base64>' } }. - O SDK tenta novamente automaticamente com o corpo da solicitação original.

