Les identifiants réseau utilisent CAIP-2
Le champaccepts[].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 :
/supported :
- Les
exactde 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.facilitatorAddressdans l’entréeuptoest 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 :exact, le client signe EIP-712 TransferWithAuthorization. Le contenu de la signature comprend :
from: adresse du portefeuille payeurto: adresse de réception d’Ace Data Cloudvalue: montant de ce paiementvalidAfter/validBefore: fenêtre de validité de la signaturenonce: nonce aléatoire de 32 octets
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 :
- 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. 95215USDC atomiques correspondent à0.095215USDC, qui est le montant réel réglé pour cet appel API.
exact :
- L’état final de la commande sur la plateforme est
Finished. - Le
pay_idde la commande enregistre le même hash de transaction Base. 1200000USDC atomiques correspondent à1.2USDC, 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 USDCTransferChecked. 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
exactest actuellement pris en charge ; - le Facilitator vérifie le mint, la destination, l’authority et le amount de la transfer instruction.
exact :
- 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.
