Skip to main content
Ace Data Cloud X402 rechnet derzeit über USDC ab und unterstützt zwei Arten von Chains: EVM und Solana. Die Signaturmethoden, Asset-Adressen, das Gas-Verhalten und die Anwendungsszenarien unterscheiden sich je nach Netzwerk, daher muss das Netzwerk vor der Integration ausgewählt werden.

​
Netzwerkkennungen verwenden CAIP-2

accepts[].network von x402 v2 ist eine CAIP-2-Kennung und keine Kurzbezeichnung wie base oder skale. Clients müssen Netzwerke anhand von CAIP-2-Strings vergleichen:

​
Unterstützungsmatrix

upto wird derzeit nur auf Base angeboten. Die tatsächlich verfügbaren Einträge richten sich nach dem von der API zurückgegebenen accepts. Du kannst auch den Facilitator prüfen:
Die Rückgabe von Facilitator /supported:
Erläuterung der Ergebnisse:
  • exact für Base, SKALE und Solana ist ein Zahlungspfad mit festem Betrag.
  • Nur Base bietet den nachgelagerten Abrechnungspfad upto, der auf Permit2 approve angewiesen ist.
  • extra.facilitatorAddress im Eintrag upto ist die Adresse, die der Client bei der Signatur in den witness schreiben muss, und muss mit dem vom Server zurückgegebenen Wert übereinstimmen.

​
Base

Base verwendet den offiziellen USDC-Vertrag:
Im exact-Schema signiert der Client EIP-712 TransferWithAuthorization. Der Signaturinhalt umfasst:
  • from: Adresse der zahlenden Wallet
  • to: Empfangsadresse von Ace Data Cloud
  • value: Zahlungsbetrag dieser Transaktion
  • validAfter / validBefore: Gültigkeitszeitfenster der Signatur
  • nonce: zufälliger 32-Byte-nonce
Nach der Validierung der Signatur ruft der Facilitator on-chain transferWithAuthorization von USDC auf, um die Übertragung abzuschließen. Base ist das am stärksten empfohlene Netzwerk für die produktive Integration und besonders für die nachgelagerte Abrechnung mit upto geeignet, da das Ökosystem für Permit2, USDC und Wallets ausgereifter ist. Beispiel für ein Base-exact-Validierungsergebnis:
Erläuterung der Ergebnisse:
  • Der API-paid-retry gibt den Modellinhalt ADC_BASE_E2E_OK zurück.
  • Die On-Chain-Transaktion ist auf BaseScan abrufbar, die Blocknummer lautet 46726299.
  • 95215 atomic USDC entsprechen 0.095215 USDC und sind der tatsächlich abgerechnete Betrag dieses API-Aufrufs.
Programmausgabe für die Bestellungzahlung mit Base exact:
Erläuterung der Ergebnisse:
  • Der endgültige Status der Plattformbestellung lautet Finished.
  • Die pay_id der Bestellung wird in denselben Base-Transaktionshash geschrieben.
  • 1200000 atomic USDC entsprechen 1.2 USDC und sind der historische tatsächlich gezahlte Betrag dieser Bestellung über 10 Credits nach der alten Richtlinie; neue Bestellungen erhalten keinen zusätzlichen Rabatt mehr für die Zahlungsmethode X402, der konkrete Signaturbetrag richtet sich nach der jeweiligen 402-Antwort.

​
SKALE

SKALE verwendet bridged USDC, und die Signaturmethode ähnelt Base, nämlich ebenfalls EIP-3009. Es eignet sich für EVM-Zahlungsszenarien mit niedrigen Gas-Kosten; die tatsächlichen Aufrufe richten sich weiterhin nach dem von der API zurückgegebenen accepts. Das typische 402-accepts von SKALE enthält:
SKALE bietet derzeit nur exact. Wenn du eine nachgelagerte Abrechnung benötigst, verwende Base upto. Beispiel für ein SKALE-exact-Validierungsergebnis:
Erläuterung der Ergebnisse:
  • API paid retry gibt Modellinhalt ADC_SKALE_E2E_OK zurück.
  • Die Transaktion ist im SKALE explorer auffindbar, die Blocknummer ist 1969317.
  • Der Abrechnungsbetrag dieser exact-Zahlung beträgt 0.095215 USDC.

​
Solana

Solana verwendet SPL USDC TransferChecked. Der Client erstellt eine Überweisungstransaktion, signiert und übermittelt sie und legt anschließend die Transaktionssignatur oder die serialisierte Transaktion in den PAYMENT-SIGNATURE envelope. Merkmale von Solana:
  • Verwendung von Solana wallet adapter oder base58 secret key;
  • Das Asset ist Solana USDC mint;
  • Derzeit wird nur exact unterstützt;
  • Der Facilitator prüft mint, destination, authority und amount der transfer instruction.
Wenn der Wallet-fee-payer-Modus verwendet wird, übermittelt das Wallet die Transaktion direkt, und der Facilitator ist für die Bestätigung der Transaktion und die Rückgabe des settlement-Ergebnisses verantwortlich. Beispiel für ein Solana-exact-Validierungsergebnis:
Ergebnisbeschreibung:
  • Der paid retry hat bereits HTTP 200 zurückgegeben, und das Modell gibt ADC_SOLANA_E2E_OK aus.
  • Bei der Abfrage der On-Chain-Signatur über öffentliches RPC kann es zu Rate Limiting kommen.
  • Da öffentliche RPC-Abfragen rate-limitiert sein können, wird hier kein Solana explorer angegeben. Wenn eine strikte Abstimmung erforderlich ist, verwenden Sie bitte Ihr eigenes Solana RPC oder bestätigen Sie die Transaktionssignatur über die Settlement-Aufzeichnungen der Plattformseite.

​
Auswahlhilfe

Unabhängig davon, welche Chain Sie wählen, kodieren Sie Preise nicht fest im Client. Der Preis wird durch accepts[].maxAmountRequired bestimmt, das vom Server zurückgegeben wird.