메인 콘텐츠로 건너뛰기
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는 자금을 보유하지 않습니다.