Identyfikatory sieci używają CAIP-2
accepts[].network w x402 v2 jest identyfikatorem CAIP-2, a nie skróconą nazwą taką jak base czy solana. Podczas dopasowywania sieci klient musi porównywać ciągi CAIP-2:
Macierz wsparcia
upto jest obecnie dostępne tylko na Base. Rzeczywiście dostępne pozycje zależą od accepts zwracanego przez API. Możesz także sprawdzić Facilitator:
/supported:
exactna Base i Solana jest ścieżką płatności o stałej kwocie.- Tylko Base oferuje ścieżkę rozliczania po użyciu
upto, zależną od approve Permit2. extra.facilitatorAddressw pozycjiuptojest adresem, który klient musi wpisać do witness podczas podpisywania, i musi być zgodny z wartością zwróconą przez serwer.
Base
Base używa oficjalnego kontraktu USDC:exact klient podpisuje EIP-712 TransferWithAuthorization. Treść podpisu obejmuje:
from: adres portfela płatnikato: adres odbiorcy Ace Data Cloudvalue: kwota bieżącej płatnościvalidAfter/validBefore: okno czasowe ważności podpisunonce: 32-bajtowy losowy nonce
transferWithAuthorization USDC, aby ukończyć transfer.
Base jest najbardziej zalecaną siecią do formalnej integracji, szczególnie odpowiednią dla rozliczania po użyciu upto, ponieważ ekosystem Permit2, USDC i portfeli jest bardziej dojrzały.
Przykład wyniku weryfikacji Base exact:
- Ponowienie API po płatności zwraca treść modelu
ADC_BASE_E2E_OK. - Transakcję on-chain można sprawdzić na BaseScan, numer bloku to
46726299. 95215atomic USDC odpowiada0.095215USDC i jest rzeczywistą kwotą rozliczenia tego wywołania API.
exact:
- Końcowy status zamówienia na platformie to
Finished. pay_idzamówienia zapisuje ten sam hash transakcji Base.1200000atomic USDC odpowiada1.2USDC i jest historyczną faktycznie zapłaconą kwotą tego zamówienia 10 Credits zgodnie ze starą polityką; nowe zamówienia nie otrzymują już dodatkowej zniżki za metodę płatności X402, a konkretna kwota podpisu zależy od bieżącej odpowiedzi 402.
Solana
Solana używa SPL USDCTransferChecked. Klient konstruuje transakcję transferu, podpisuje ją i przesyła, a następnie umieszcza podpis transakcji lub zserializowaną transakcję w envelope PAYMENT-SIGNATURE.
Cechy Solana:
- Używa Solana wallet adapter lub base58 secret key;
- Aktywem jest Solana USDC mint;
- Obecnie obsługuje tylko
exact; - Facilitator zweryfikuje mint, destination, authority i amount instrukcji transferu.
exact:
- Ponowienie po płatności zwróciło już HTTP 200, a model zwrócił
ADC_SOLANA_E2E_OK. - Podczas sprawdzania signature on-chain przez publiczne RPC można napotkać ograniczenie liczby żądań.
- Ponieważ publiczne zapytania RPC mogą być ograniczane, nie podajemy tutaj Solana explorer. Gdy wymagane jest ścisłe uzgodnienie, użyj własnego Solana RPC lub rekordów rozliczeniowych po stronie platformy, aby potwierdzić podpis transakcji.
Jak wybrać
Niezależnie od wybranego łańcucha, nie koduj na sztywno cen po stronie klienta. Cena jest określana przez
accepts[].maxAmountRequired zwracane przez serwer.
Dodawanie nowych sieci EVM
Obsługa kodowa płatności natywnym USDC o stałej kwocie w poniższych sieciach została udostępniona i jest włączana kolejno dla każdej sieci. O dostępności decydujeaccepts zwracane przez zamówienie lub API; nie oznacza to, że wszystkie sieci zostały włączone na produkcji.
Te sieci obsługują wyłącznie
exact, a precyzja waluty wynosi 6. Nie używaj mostkowanego USDC o tej samej nazwie.
Podczas używania oficjalnego klienta TypeScript/Python X402 można przekazać skrót z tabeli lub identyfikator CAIP-2.
Klient używa docelowego ID łańcucha do skonstruowania podpisu; portfel musi obsługiwać docelową sieć.
Oficjalna tabela obsługi portfela rozszerzenia Phantom wymienia Arbitrum i Polygon; Optimism, Avalanche
obecnie nie są wymienione w tej tabeli, można użyć Rabby lub MetaMask obsługujących docelowy łańcuch. Adresy EVM mogą być takie same w różnych łańcuchach,
ale salda są niezależne od siebie, a adresy Solana nie mają zastosowania do EVM USDC.
Zobacz tabelę obsługi portfela Phantom.
Wejście stopniowego wdrażania nowej sieci
Wejście dla nowego łańcucha jest domyślnie ukryte. Podczas odwiedzania konsoli lub Studio można użyć?features=x402-arbitrum,
aby włączyć odpowiedni łańcuch; wiele flag należy rozdzielać przecinkami. Aby wyłączyć pojedynczy łańcuch, użyj ?features=-x402-arbitrum,
a aby wyczyścić lokalne nadpisania, użyj ?features=none. Przełączniki są zapisywane osobno dla każdej domeny.
Wyceny zamówień i ponowienia płatności używają tego samego przełącznika, a serwer przeprowadza niezależną walidację; istniejące zapisy płatności nadal można wyświetlać.
Samo włączenie flagi strony nie aktywuje łańcucha, który nie został jeszcze skonfigurowany; konkretne sieci, w których można płacić, nadal zależą od bieżącego accepts.
