세 가지 진입점
ARouter는 Agent가 시작할 수 있는 세 가지 방법을 제공합니다. API Key 사용자와 지갑 사용자는 이제 별도의 장기 경로를 따릅니다:표준 x402 모드는 모든 x402 호환 도구에서 작동합니다 —
@x402/fetch, awal, MCP 지갑, Chrome 확장 프로그램.
ARouter SDK가 필요하지 않습니다.작동 방식
표준 x402 (모든 x402 클라이언트)
가장 단순한 진입점. USDC를 보유한 모든 지갑으로 즉시 LLM 요청 가능:- API Key 없이 요청 전송 — 게이트웨이가 결제 옵션과 함께 HTTP 402를 반환합니다.
- x402 클라이언트가 USDC 결제에 서명 (EIP-3009를 통한 가스리스).
PAYMENT-SIGNATURE헤더를 포함하여 재시도.- 게이트웨이가 검증, 결제, 계정 생성 후 응답을 반환합니다.
PAYMENT-RESPONSE헤더에 향후 지갑 인증 요청을 위한jwt확장 필드가 포함됩니다.
SIWx 인증 (지갑 로그인)
먼저 결제하지 않고 지갑 소유권을 증명하여 지갑 JWT를 획득: SIWx는 CAIP-122 표준을 따릅니다 — QuickNode 및 기타 x402 지원 서비스와 동일한 프로토콜.API Key 사용자
기존 API Key 사용자는 표준 ARouter API Key 플로우를 계속 사용합니다:지원 네트워크
지갑 호환성
모든 지갑 사용 가능 — 개인 키 내보내기 불필요:SDK 사용법
표준 x402 (ARouter SDK 불필요)
Coinbase의 공식@x402/fetch를 직접 사용합니다:
SIWx 인증 (지갑 JWT 획득)
Node.js SDK
Go SDK
ARouter SDK + 자동 결제 (고빈도 사용 권장)
Go SDK — EVM (Base)
WithX402CoinbasePayment은 JWT 캐싱을 통한 지갑 x402 결제를 설정합니다:
- 최초 성공 결제 시
PAYMENT-RESPONSE내에 지갑 JWT 반환 - 이후 요청은
Bearer <jwt>사용 401은 SIWx 재인증 트리거402는 x402 결제 트리거
Go SDK — Solana
Node.js SDK — EVM (Base)
Node.js SDK — 듀얼 체인 (EVM + Solana)
CLI 도구용 GET 엔드포인트
POST 본문을 전송할 수 없는 x402 CLI 도구(awal 등)용:
결제 헤더
크레딧 작동 방식
- x402 결제는 크레딧으로 테넌트 잔액에 입금됩니다 — Stripe 및 Helio 결제와 동일한 풀 사용.
- 모든 x402 트랜잭션은 청구 페이지의 트랜잭션 내역에
x402_topup참조 유형으로 표시됩니다. - 잔액이 충전된 후 게이트웨이는 평소와 같이 요청별로 크레딧을 차감합니다.
- 지갑 사용자는 테넌트 단위로 청구되고, 지갑 JWT로 인증되며, 원시 API Key를 노출하지 않고 SIWx를 통해 재인증할 수 있습니다.
보안
- 표준 x402 프로토콜: Coinbase의 공식 x402 SDK를 사용하여 검증 및 결제를 수행합니다.
- Facilitator 검증: 결제는 x402 Facilitator를 통해 암호학적으로 검증된 후 크레딧이 부여됩니다.
- 가스리스 결제: EIP-3009 (TransferWithAuthorization) — 사용자가 서명하고 Facilitator가 온체인에 제출합니다.
- 금액 상한: 예상치 못한 대규모 청구를 방지하기 위해 단일 결제에 상한 적용.
- 멱등성: 각 결제 페이로드에는 고유한 nonce가 있습니다 — 동일한 서명은 재사용 불가.
- SIWx 표준: 인증은 CAIP-122를 따르며 EIP-4361 (EVM) 및 SIWS (Solana) 메시지 형식을 지원합니다.
- 감사 추적: 모든 x402 충전은 Stripe/Helio 결제와 함께 트랜잭션 내역에 기록됩니다.
- 비수탁: USDC는 수신 지갑으로 직접 전송됩니다. Facilitator는 자금을 보유하지 않습니다.