네트워크 식별자는 CAIP-2 사용
x402 v2의accepts[].network는 base, solana와 같은 약칭이 아니라 CAIP-2 식별자입니다. 클라이언트는 네트워크를 매칭할 때 반드시 CAIP-2 문자열로 비교해야 합니다:
지원 매트릭스
upto는 현재 Base에서만 제공됩니다. 실제 사용 가능 항목은 API가 반환하는 accepts를 기준으로 합니다. Facilitator도 확인할 수 있습니다:
/supported의 반환:
- Base와 Solana의
exact는 고정 금액 결제 경로입니다. - Base만
upto후불 계량 경로를 제공하며, Permit2 approve에 의존합니다. upto항목의extra.facilitatorAddress는 클라이언트가 서명 시 witness에 기록해야 하는 주소이며, 서버가 반환한 값과 반드시 일치해야 합니다.
Base
Base는 공식 USDC 컨트랙트를 사용합니다:exact 방식에서 클라이언트는 EIP-712 TransferWithAuthorization에 서명합니다. 서명 내용에는 다음이 포함됩니다:
from: 결제 지갑 주소to: Ace Data Cloud 수금 주소value: 이번 결제 금액validAfter/validBefore: 서명 유효 시간 창nonce: 32바이트 랜덤 nonce
transferWithAuthorization을 호출하여 전송을 완료합니다.
Base는 가장 권장되는 정식 연동 네트워크이며, 특히 Permit2, USDC 및 지갑 생태계가 더 성숙했기 때문에 upto 후불 계량에 적합합니다.
Base exact 검증 결과 예시:
- API paid retry가 모델 내용
ADC_BASE_E2E_OK를 반환합니다. - 온체인 거래는 이미 BaseScan에서 조회할 수 있으며, 블록 번호는
46726299입니다. 95215atomic USDC는0.095215USDC에 해당하며, 이번 API 호출의 실제 결제 금액입니다.
exact의 프로그램 실행 결과:
- 플랫폼 주문의 최종 상태는
Finished입니다. - 주문의
pay_id는 동일한 Base 거래 해시에 기록됩니다. 1200000atomic USDC는1.2USDC에 해당하며, 이전 정책에서 이 10 Credits 주문의 과거 실제 결제 금액입니다. 새 주문은 더 이상 X402 결제 방식 할인을 추가로 받지 않으며, 구체적인 서명 금액은 이번 402 응답을 기준으로 합니다.
Solana
Solana는 SPL USDCTransferChecked를 사용합니다. 클라이언트는 전송 거래를 구성하고 서명 및 제출한 뒤, 거래 서명 또는 직렬화된 거래를 PAYMENT-SIGNATURE envelope에 넣습니다.
Solana의 특징:
- Solana wallet adapter 또는 base58 secret key 사용;
- 자산은 Solana USDC mint;
- 현재
exact만 지원; - Facilitator는 transfer instruction의 mint, destination, authority 및 amount를 검증합니다.
exact 검증 결과 예시:
- paid retry가 이미 HTTP 200을 반환했고, 모델은
ADC_SOLANA_E2E_OK를 출력했습니다. - 공개 RPC로 온체인 signature를 조회할 때 속도 제한이 발생할 수 있습니다.
- 공개 RPC 조회는 속도 제한이 발생할 수 있으므로, 여기에는 Solana explorer를 작성하지 않습니다. 엄격한 대사가 필요한 경우 자체 Solana RPC 또는 플랫폼 측 결제 기록을 사용하여 거래 서명을 확인하십시오.
선택 방법
어떤 체인을 선택하든 클라이언트에 가격을 하드코딩하지 마십시오. 가격은 서버가 반환하는
accepts[].maxAmountRequired로 결정됩니다.
새 EVM 네트워크 추가
다음 네트워크의 네이티브 USDC 고정 금액 결제는 코드 지원이 제공되었으며, 네트워크별로 순차적으로 공개됩니다. 사용 가능 여부는 주문 또는 API가 반환하는accepts를 기준으로 하며, 모든 네트워크가 프로덕션에서 활성화되었음을 의미하지는 않습니다.
이 네트워크는
exact만 지원하며, 토큰 정밀도는 6입니다. 같은 이름의 브리지 USDC를 사용하지 마세요.
공식 TypeScript/Python X402 Client를 사용할 때 표에 있는 약칭 또는 CAIP-2 식별자를 전달할 수 있습니다.
클라이언트는 대상 체인 ID를 사용하여 서명을 구성하며, 지갑은 대상 네트워크를 지원해야 합니다.
Phantom 확장 지갑의 공식 지원 표에는 Arbitrum과 Polygon이 나열되어 있으며, Optimism, Avalanche는
현재 이 표에 포함되어 있지 않으므로 대상 체인을 지원하는 Rabby 또는 MetaMask를 사용할 수 있습니다. EVM 주소는 서로 다른 체인에서 동일할 수 있지만,
잔액은 서로 독립적이며 Solana 주소는 EVM USDC에 적용되지 않습니다.
Phantom 지갑 지원 표를 참조하세요.
새 네트워크 카나리 진입점
새 체인 진입점은 기본적으로 숨겨져 있습니다. 콘솔 또는 Studio에 접속할 때?features=x402-arbitrum을 사용하여
해당 체인을 활성화할 수 있으며, 여러 flag는 쉼표로 구분합니다. 단일 체인을 비활성화하려면 ?features=-x402-arbitrum을 사용하고,
로컬 오버라이드를 지우려면 ?features=none을 사용하세요. 스위치는 각 도메인별로 별도로 저장됩니다.
주문 견적 및 결제 재시도에는 동일한 스위치가 사용되며, 서버는 독립적으로 검증합니다. 기존 결제 기록은 계속 확인할 수 있습니다.
페이지 flag만 활성화해도 아직 구성되지 않은 체인이 활성화되지는 않으며, 실제 결제 가능한 네트워크는 여전히 실시간 accepts를 기준으로 합니다.
