Hoppa till huvudinnehåll
Ace Data Cloud X402 använder för närvarande två typer av scheme: exact och upto. De löser olika debiteringsproblem.

exact

exact innebär att priset för denna begäran kan fastställas innan den går in i mål-API:t. Beloppet som klienten signerar är det slutliga debiteringsbeloppet. Lämpligt för:
  • Bildgenerering med fast pris;
  • Skapande av videouppgifter med fast pris;
  • Sök- eller verktygs-API:er med fast pris;
  • Orderbetalning.
EVM exact använder USDC EIP-3009 TransferWithAuthorization:
Facilitator validerar signaturen och beloppet i /verify-fasen och skickar denna auktorisering till kedjan i /settle-fasen.

upto

upto innebär att klienten auktoriserar en maximal gräns, och Ace Data Cloud avräknar enligt faktisk användning efter att begäran har slutförts; den faktiska debiteringen får inte överstiga gränsen. Lämpligt för:
  • Chattkomplettering: slutpriset beror på prompt tokens och completion tokens;
  • Strömmande svar: den verkliga utdata-längden är känd först när den avslutas;
  • Framtida API:er med efterhandsmätning.
upto använder Permit2 PermitWitnessTransferFrom. Det klienten signerar är inte en fast överföring, utan en gränsauktorisering med witness:
permitted.amount är gränsen, och är inte nödvändigtvis den slutliga debiteringen. Gateway konverterar den faktiska användningen till amount och skickar den till Facilitator i /record-fasen. Facilitator tillåter endast avräkning när amount <= permitted.amount. Programkörningsresultatet för Base upto:
Förklaring:
  • Auktoriseringsgränsen som returneras i 402 är 95215 atomic USDC, och klienten signerar enligt denna gräns.
  • Efter det faktiska modellsvar avräknas endast 3 atomic USDC, och kedjetransaktionen kan redan kontrolleras på BaseScan.
  • Detta resultat visar den viktigaste skillnaden för upto: det signerade beloppet är en gräns, och settlement på kedjan kan vara mindre än gränsen.
  • Om den faktiska användningen överstiger gränsen ska Facilitator neka settlement, och klienten behöver auktorisera igen enligt en högre gräns.
upto erbjuds för närvarande endast på Base. När efterhandsmätning krävs, använd Base.

Varför Permit2 approve behövs

upto hämtar slutligen USDC från betalningsplånboken via Permit2 genom x402 proxy. Före första användningen behöver betalningsplånboken ge Permit2 en ERC-20 allowance en gång. Python CLI:
Programmässigt:
Efter att auktoriseringen har slutförts behöver varje begäran fortfarande signera ett nytt upto envelope, eftersom nonce, deadline, witness och beloppsgräns är olika.

Avräkning med nollbelopp

upto stöder situationer där det faktiska beloppet är 0. Om mål-API:t till exempel inte lyckas producera debiterbar användning kan Gateway skicka in amount = "0". Facilitator returnerar framgång, men skickar ingen kedjetransaktion. Detta kan undvika problemet med ”begäran lyckades inte men avgifter på kedjan debiteras ändå”.

Rekommendationer för val

Om du är osäker på vilket du ska välja, använd först SDK:ns standardbeteende; SDK:t väljer det matchande nätverkets payment requirement som servern returnerar.

Checklista för Base upto

Vid integration eller felsökning, bekräfta att följande parametrar kommer från samma 402-svar och håll dem konsekventa vid klientsignering: Vanliga fel och hanteringssätt: