Skip to main content
ARouter는 HTTP 네이티브 결제를 위한 개방형 표준인 x402 결제 프로토콜을 지원합니다. 암호화폐 지갑을 가진 AI Agent는 계정 등록이나 Dashboard 로그인 없이 인증, 크레딧 결제, LLM 요청을 모두 실행할 수 있습니다.

세 가지 진입점

ARouter는 Agent가 시작할 수 있는 세 가지 방법을 제공합니다. API Key 사용자와 지갑 사용자는 이제 별도의 장기 경로를 따릅니다:
표준 x402 모드는 모든 x402 호환 도구에서 작동합니다 — @x402/fetch, awal, MCP 지갑, Chrome 확장 프로그램. ARouter SDK가 필요하지 않습니다.

작동 방식

표준 x402 (모든 x402 클라이언트)

가장 단순한 진입점. USDC를 보유한 모든 지갑으로 즉시 LLM 요청 가능:
  1. API Key 없이 요청 전송 — 게이트웨이가 결제 옵션과 함께 HTTP 402를 반환합니다.
  2. x402 클라이언트가 USDC 결제에 서명 (EIP-3009를 통한 가스리스).
  3. PAYMENT-SIGNATURE 헤더를 포함하여 재시도.
  4. 게이트웨이가 검증, 결제, 계정 생성 후 응답을 반환합니다.
  5. 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는 자금을 보유하지 않습니다.