Skip to main content
O Ace Data Cloud X402 atualmente realiza liquidação em torno de USDC, oferecendo suporte a dois tipos de redes: EVM e Solana. Os métodos de assinatura, endereços de ativos, comportamentos de gas e cenários aplicáveis diferem entre as redes, portanto, é necessário escolher a rede antes da integração.

​
Os Identificadores de Rede Usam CAIP-2

O accepts[].network do x402 v2 é um identificador CAIP-2, não uma abreviação como base ou skale. Ao corresponder redes, o cliente deve comparar pelas strings CAIP-2:

​
Matriz de Suporte

Atualmente, upto é fornecido apenas na Base. Os itens realmente disponíveis devem seguir o accepts retornado pela API. Você também pode consultar o Facilitator:
O retorno do Facilitator /supported:
Explicação dos resultados:
  • O exact de Base, SKALE e Solana é um caminho de pagamento de valor fixo.
  • Apenas a Base fornece o caminho de medição posterior upto, que depende da aprovação Permit2.
  • O extra.facilitatorAddress na entrada upto é o endereço que o cliente deve escrever no witness ao assinar e deve ser consistente com o valor retornado pelo servidor.

​
Base

A Base usa o contrato oficial de USDC:
No esquema exact, o cliente assina o EIP-712 TransferWithAuthorization. O conteúdo da assinatura inclui:
  • from: endereço da carteira pagadora
  • to: endereço recebedor do Ace Data Cloud
  • value: valor deste pagamento
  • validAfter / validBefore: janela de validade da assinatura
  • nonce: nonce aleatório de 32 bytes
Após verificar a assinatura, o Facilitator chamará transferWithAuthorization do USDC on-chain para concluir a transferência. A Base é a rede mais recomendada para integração formal, especialmente adequada para a medição posterior upto, pois os ecossistemas de Permit2, USDC e carteiras são mais maduros. Exemplo de resultado de verificação Base exact:
Explicação dos resultados:
  • A nova tentativa paga da API retorna o conteúdo do modelo ADC_BASE_E2E_OK.
  • A transação on-chain pode ser consultada no BaseScan, e o número do bloco é 46726299.
  • 95215 USDC atômicos correspondem a 0.095215 USDC, que é o valor real liquidado desta chamada de API.
Resultado da execução do programa de pagamento de pedido Base exact:
Explicação dos resultados:
  • O estado final do pedido na plataforma é Finished.
  • O pay_id do pedido grava o mesmo hash de transação Base.
  • 1200000 USDC atômicos correspondem a 1.2 USDC, que é o valor histórico efetivamente pago deste pedido de 10 Credits sob a política antiga; novos pedidos não recebem mais desconto adicional pelo método de pagamento X402, e o valor específico da assinatura deve seguir a resposta 402 desta vez.

​
SKALE

A SKALE usa USDC bridged, e o método de assinatura é semelhante ao da Base, também sendo EIP-3009. Ela é adequada para cenários de pagamento EVM com baixo custo de gas; as chamadas reais ainda devem seguir o accepts retornado pela API. O accepts 402 típico da SKALE incluirá:
Atualmente, a SKALE fornece apenas exact. Se você precisar de medição posterior, use Base upto. Exemplo de resultado de verificação SKALE exact:
Explicação dos resultados:
  • A nova tentativa de pagamento da API retorna o conteúdo do modelo ADC_SKALE_E2E_OK。
  • A transação já pode ser consultada no explorer da SKALE, e o número do bloco é 1969317。
  • O valor de liquidação deste pagamento exact é 0.095215 USDC。

​
Solana

Solana usa SPL USDC TransferChecked。O cliente constrói uma transação de transferência, assina e envia, e depois coloca a assinatura da transação ou a transação serializada no envelope PAYMENT-SIGNATURE。 Características do Solana：
  • Usa Solana wallet adapter ou base58 secret key；
  • O ativo é o mint de USDC da Solana；
  • Atualmente, suporta apenas exact；
  • O Facilitator valida o mint, destination, authority e amount da instrução de transferência。
Se for usado o modo de carteira fee payer, a carteira enviará a transação diretamente, e o Facilitator será responsável por confirmar a transação e retornar o resultado da liquidação。 Exemplo de resultado da validação exact do Solana：
Explicação dos resultados：
  • A nova tentativa de pagamento já retornou HTTP 200, e o modelo produziu ADC_SOLANA_E2E_OK。
  • Consultas de signature on-chain via RPC público podem encontrar limitação de taxa。
  • Como consultas via RPC público podem sofrer limitação de taxa, o Solana explorer não é incluído aqui。Quando for necessário reconciliar rigorosamente, use seu próprio Solana RPC ou os registros de liquidação do lado da plataforma para confirmar a assinatura da transação。

​
Como escolher

Independentemente da cadeia escolhida, não codifique o preço diretamente no cliente。O preço é determinado por accepts[].maxAmountRequired retornado pelo servidor。