Passer au contenu principal
Ace Data Cloud X402 est actuellement centré sur le règlement en USDC et prend en charge deux types de chaînes : EVM et Solana. Les méthodes de signature, les adresses d’actifs, le comportement du gas et les cas d’usage applicables diffèrent selon les réseaux ; vous devez donc choisir le réseau avant l’intégration.

Les identifiants réseau utilisent CAIP-2

Le champ accepts[].network de x402 v2 est un identifiant CAIP-2, et non une abréviation telle que base ou solana. Lorsqu’un client fait correspondre un réseau, il doit comparer selon la chaîne CAIP-2 :

Matrice de prise en charge

upto est actuellement fourni uniquement sur Base. Les éléments réellement disponibles dépendent des accepts renvoyés par l’API. Vous pouvez également consulter le Facilitator :
La réponse de Facilitator /supported :
Explication des résultats :
  • Les exact de Base et Solana sont des parcours de paiement à montant fixe.
  • Seule Base fournit le parcours de comptage différé upto, qui dépend de l’approbation Permit2.
  • L’élément extra.facilitatorAddress dans l’entrée upto est l’adresse à écrire dans le witness lors de la signature côté client ; elle doit être identique à la valeur renvoyée par le serveur.

Base

Base utilise le contrat USDC officiel :
Dans le schéma exact, le client signe EIP-712 TransferWithAuthorization. Le contenu de la signature comprend :
  • from : adresse du portefeuille payeur
  • to : adresse de réception d’Ace Data Cloud
  • value : montant de ce paiement
  • validAfter / validBefore : fenêtre de validité de la signature
  • nonce : nonce aléatoire de 32 octets
Après avoir vérifié la signature, le Facilitator appellera transferWithAuthorization de l’USDC on-chain pour effectuer le transfert. Base est le réseau de production le plus recommandé pour l’intégration, particulièrement adapté au comptage différé upto, car les écosystèmes Permit2, USDC et des portefeuilles y sont plus matures. Exemple de résultat de vérification Base exact :
Explication des résultats :
  • Le paid retry de l’API renvoie le contenu du modèle ADC_BASE_E2E_OK.
  • La transaction on-chain est consultable sur BaseScan, et le numéro du bloc est 46726299.
  • 95215 USDC atomiques correspondent à 0.095215 USDC, qui est le montant réel réglé pour cet appel API.
Résultat d’exécution du programme pour le paiement de commande Base exact :
Explication des résultats :
  • L’état final de la commande sur la plateforme est Finished.
  • Le pay_id de la commande enregistre le même hash de transaction Base.
  • 1200000 USDC atomiques correspondent à 1.2 USDC, qui est le montant historique effectivement payé pour cette commande de 10 Credits selon l’ancienne politique ; les nouvelles commandes ne bénéficient plus d’une remise supplémentaire pour le mode de paiement X402, et le montant de signature spécifique dépend de la réponse 402 actuelle.

Solana

Solana utilise SPL USDC TransferChecked. Le client construit une transaction de transfert, la signe et la soumet, puis place la signature de transaction ou la transaction sérialisée dans l’enveloppe PAYMENT-SIGNATURE. Caractéristiques de Solana :
  • utilisation de Solana wallet adapter ou d’une clé secrète base58 ;
  • l’actif est le mint Solana USDC ;
  • seul exact est actuellement pris en charge ;
  • le Facilitator vérifie le mint, la destination, l’authority et le amount de la transfer instruction.
Si le mode fee payer du portefeuille est utilisé, le portefeuille soumet directement la transaction, et le Facilitator est responsable de confirmer la transaction et de renvoyer le résultat du règlement. Exemple de résultat de vérification Solana exact :
Explication des résultats :
  • Le paid retry a déjà renvoyé HTTP 200, et le modèle a produit ADC_SOLANA_E2E_OK.
  • Des limites de débit peuvent être rencontrées lors de l’interrogation de la signature on-chain via un RPC public.
  • Comme les requêtes RPC publiques peuvent être limitées en débit, aucun explorer Solana n’est indiqué ici. Lorsqu’un rapprochement strict est nécessaire, veuillez utiliser votre propre RPC Solana ou les enregistrements de règlement côté plateforme pour confirmer la signature de transaction.

Comment choisir

Quelle que soit la chaîne choisie, ne codez pas les prix en dur dans le client. Le prix est déterminé par accepts[].maxAmountRequired renvoyé par le serveur.

Ajouter un réseau EVM

以下网络的原生 USDC 固定金额支付已提供代码支持,按网络逐一开放。 是否可用以订单或 API 返回的 accepts 为准;不代表所有网络已在生产启用。 Ces réseaux ne prennent en charge que exact, avec une précision de devise de 6. N’utilisez pas d’USDC ponté portant le même nom. Lors de l’utilisation du Client X402 officiel TypeScript/Python, vous pouvez transmettre l’alias du tableau ou l’identifiant CAIP-2. Le client utilise l’ID de la chaîne cible pour construire la signature ; le portefeuille doit prendre en charge le réseau cible. Le tableau officiel de prise en charge du portefeuille d’extension Phantom répertorie Arbitrum et Polygon ; Optimism, Avalanche ne sont actuellement pas inclus dans ce tableau ; vous pouvez utiliser Rabby ou MetaMask prenant en charge la chaîne cible. Les adresses EVM peuvent être identiques sur différentes chaînes, mais les soldes sont indépendants les uns des autres, et les adresses Solana ne s’appliquent pas à l’USDC EVM. Voir le tableau de prise en charge du portefeuille Phantom.

Point d’entrée de déploiement progressif des nouveaux réseaux

Les points d’entrée des nouvelles chaînes sont masqués par défaut. Lors de l’accès à la console ou à Studio, vous pouvez utiliser ?features=x402-arbitrum pour activer la chaîne correspondante, plusieurs flags étant séparés par des virgules. Pour désactiver une seule chaîne, utilisez ?features=-x402-arbitrum, et pour effacer le remplacement local, utilisez ?features=none. Les interrupteurs sont enregistrés séparément pour chaque domaine. Les devis de commande et les tentatives de paiement utilisent le même interrupteur, le serveur effectuant une validation indépendante ; les enregistrements de paiement existants restent consultables. L’activation du seul flag de page n’activera pas une chaîne qui n’est pas encore configurée, et les réseaux effectivement payables restent déterminés par les accepts en temps réel.