Netzwerkkennungen verwenden CAIP-2
accepts[].network von x402 v2 ist eine CAIP-2-Kennung und keine Kurzbezeichnung wie base oder solana. Clients müssen Netzwerke durch Vergleich von CAIP-2-Strings abgleichen:
Unterstützungsmatrix
upto wird derzeit nur auf Base angeboten. Die tatsächlich verfügbaren Einträge richten sich nach den von der API zurückgegebenen accepts. Du kannst auch den Facilitator prüfen:
/supported:
exactauf Base und Solana ist ein Zahlungspfad mit festem Betrag.- Nur Base bietet den nachgelagerten Abrechnungspfad
upto, der von einer Permit2-Approve abhängt. extra.facilitatorAddressim Eintraguptoist die Adresse, die der Client beim Signieren in den Witness schreiben muss, und muss mit dem vom Server zurückgegebenen Wert übereinstimmen.
Base
Base verwendet den offiziellen USDC-Vertrag:exact signiert der Client EIP-712 TransferWithAuthorization. Der Signaturinhalt umfasst:
from: Adresse der zahlenden Walletto: Empfangsadresse von Ace Data Cloudvalue: Zahlungsbetrag dieser TransaktionvalidAfter/validBefore: Gültigkeitszeitfenster der Signaturnonce: zufälliger Nonce mit 32 Byte
transferWithAuthorization von USDC auf, um die Übertragung abzuschließen.
Base ist das am meisten empfohlene Netzwerk für die offizielle Integration, insbesondere für die nachgelagerte Abrechnung mit upto, da das Ökosystem für Permit2, USDC und Wallets ausgereifter ist.
Beispiel für ein Base-exact-Verifizierungsergebnis:
- Der kostenpflichtige API-Wiederholungsversuch gibt den Modellinhalt
ADC_BASE_E2E_OKzurück. - Die On-Chain-Transaktion ist bereits auf BaseScan abrufbar; die Blocknummer lautet
46726299. 95215atomic USDC entsprechen0.095215USDC und sind der tatsächlich abgerechnete Betrag dieses API-Aufrufs.
exact:
- Der endgültige Status der Plattformbestellung ist
Finished. - Die
pay_idder Bestellung wird mit demselben Base-Transaktionshash geschrieben. 1200000atomic USDC entsprechen1.2USDC und sind der historische tatsächlich gezahlte Betrag dieser 10-Credits-Bestellung gemäß der alten Richtlinie; neue Bestellungen erhalten keinen zusätzlichen Rabatt mehr für die Zahlungsmethode X402, der konkrete Signaturbetrag richtet sich nach der 402-Antwort dieses Vorgangs.
Solana
Solana verwendet SPL USDCTransferChecked. Der Client erstellt eine Übertragungstransaktion, signiert und übermittelt sie und legt anschließend die Transaktionssignatur oder die serialisierte Transaktion in das PAYMENT-SIGNATURE-Envelope.
Merkmale von Solana:
- Verwendung von Solana Wallet Adapter oder einem base58 Secret Key;
- das Asset ist der Solana-USDC-Mint;
- derzeit wird nur
exactunterstützt; - der Facilitator prüft Mint, Destination, Authority und Amount der Transfer Instruction.
exact-Verifizierungsergebnis:
- Der kostenpflichtige Wiederholungsversuch hat bereits HTTP 200 zurückgegeben, und das Modell gibt
ADC_SOLANA_E2E_OKaus. - Bei der Abfrage der On-Chain-Signatur über einen öffentlichen RPC kann es zu Rate Limits kommen.
- Da Abfragen über öffentliche RPCs Rate Limits unterliegen können, wird hier kein Solana Explorer angegeben. Wenn eine strikte Abstimmung erforderlich ist, verwende einen eigenen Solana RPC oder bestätige die Transaktionssignatur über die Settlement-Aufzeichnungen der Plattform.
Auswahlhilfe
Unabhängig davon, welche Chain ausgewählt wird, dürfen Preise nicht im Client fest codiert werden. Der Preis wird durch
accepts[].maxAmountRequired bestimmt, das vom Server zurückgegeben wird.
Neue EVM-Netzwerke
Die Unterstützung für Zahlungen mit nativem USDC in festen Beträgen auf den folgenden Netzwerken wurde im Code bereitgestellt und wird Netzwerk für Netzwerk freigeschaltet. Ob sie verfügbar sind, richtet sich nach den von der Bestellung oder API zurückgegebenenaccepts; dies bedeutet nicht, dass alle Netzwerke bereits in der Produktion aktiviert sind.
Diese Netzwerke unterstützen nur
exact, die Währungspräzision beträgt 6. Verwenden Sie nicht den gleichnamigen gebrückten USDC.
Bei Verwendung des offiziellen TypeScript/Python-X402-Clients können Sie die Kurzbezeichnung oder die CAIP-2-Kennung aus der Tabelle übergeben.
Der Client verwendet die Ziel-Chain-ID zum Erstellen der Signatur; die Wallet muss das Zielnetzwerk unterstützen.
Die offizielle Unterstützungstabelle der Phantom-Erweiterungs-Wallet führt Arbitrum und Polygon auf; Optimism, Avalanche
sind derzeit nicht in dieser Tabelle aufgeführt, es können Rabby oder MetaMask verwendet werden, die das Zielnetzwerk unterstützen. EVM-Adressen können auf verschiedenen Chains identisch sein,
aber die Guthaben sind voneinander unabhängig, Solana-Adressen sind nicht für EVM-USDC geeignet.
Siehe Phantom-Wallet-Unterstützungstabelle.
Graustufen-Zugang für neue Netzwerke
Der Zugang für neue Chains ist standardmäßig ausgeblendet. Beim Aufrufen der Konsole oder von Studio können Sie mit?features=x402-arbitrum
die entsprechende Chain aktivieren, mehrere Flags werden durch Kommas getrennt. Zum Deaktivieren einer einzelnen Chain verwenden Sie ?features=-x402-arbitrum,
zum Löschen lokaler Überschreibungen verwenden Sie ?features=none. Die Schalter werden für jede Domain separat gespeichert.
Bestellangebote und Zahlungswiederholungen verwenden denselben Schalter, der Server führt eine unabhängige Validierung durch; vorhandene Zahlungsaufzeichnungen können weiterhin angezeigt werden.
Das Aktivieren nur des Seiten-Flags aktiviert keine noch nicht konfigurierte Chain, die tatsächlich zahlbaren Netzwerke richten sich weiterhin nach den Echtzeit-accepts.
