# ADK-TS x402: 온체인 암호화폐 결제를 지원하는 AI 에이전트 By [IQ.Wiki Blog (KR)](https://paragraph.com/@iq-wiki-blog-kr) · 2025-10-03 --- ADK-TS와 Coinbase의 x402 프로토콜을 활용해 암호화폐를 벌고 소비하는 AI 에이전트를 구축하세요. 사용량 기반 결제 API와 자율적인 에이전트 경제를 가능하게 합니다. ADK-TS x x402 프로토콜 ------------------ AI 에이전트는 점점 더 똑똑하고 빠르며 유용해지고 있습니다. 하지만 여전히 어려움을 겪는 부분이 있습니다: 바로 **결제**입니다.에이전트가 API 호출 비용을 어떻게 지불할 수 있을까요? 개발자가 번거로운 결제 시스템을 만들지 않고 어떻게 에이전트 서비스에 요금을 청구할 수 있을까요? 이 간극을 메우기 위해 [Coinbase가 만든 **x402 결제 프로토콜**이](https://www.coinbase.com/developer-platform/products/x402?ref=blog.iqai.com) 존재합니다. 그리고 우리의 [**ADK-TS(Agent Development Kit for TypeScript)**](https://adk.iqai.com/?ref=blog.iqai.com) 스타터 템플릿을 통해, 개발자가 네이티브 암호화폐 결제를 지원하는 AI 에이전트를 구축할 수 있음을 보여줍니다 — 사용량 기반 결제를 현실화하는 방법입니다. * * * x402 결제 프로토콜이란? --------------- x402 프로토콜은 Coinbase가 제안한 오픈 스탠다드로, [HTTP 402 Payment Required를](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/402?ref=blog.iqai.com) 현대 웹에 맞게 활용할 수 있도록 합니다. 흐름은 간단합니다: 1. 유료 리소스를 요청하면, 서버는 **402 Payment Required** 응답을 보내며 지불해야 할 금액, 토큰 종류(예: USDC), 그리고 지불 주소를 알려줍니다. 2. 클라이언트는 온체인 결제를 진행하고, 지불 증명이 담긴 **X-PAYMENT 헤더**와 함께 요청을 재시도합니다. 3. 서버는 결제를 검증한 뒤 콘텐츠 또는 API 접근을 허용합니다. 이로써 암호화폐 마이크로페이먼트를 기반으로 한 보편적인 인터넷 결제 시스템이 가능해집니다. 신용카드와 달리 **센트 단위 이하 금액**, **즉시 결제**, **전 세계 접근성**을 제공합니다. ![](https://storage.googleapis.com/papyrus_images/8cf21bf2b18426711925710ea94dd20504dc882e19fc6534c3c7970b42b28177.png) * * * ADK-TS란? (Agent Development Kit for TypeScript) ----------------------------------------------- [ADK-TS는](https://github.com/IQAICOM/adk-ts?ref=blog.iqai.com) AI 에이전트 구축을 위한 TypeScript 프레임워크로, 단순한 챗봇부터 복잡한 멀티 에이전트 시스템까지 안전하고 견고한 개발을 지원합니다. * 여러 AI 모델(OpenAI, Claude, Gemini 등) 기본 지원 * 메모리, 스트리밍, 세션 관리 기능 내장 * 외부 서비스/API와의 매끄러운 통합 지원 즉, 단순히 에이전트를 코딩하는 것이 아니라 **엔터프라이즈급 AI 시스템**을 빠르고 깔끔하게 구축할 수 있습니다. * * * IQ AI란? ------- IQ AI는 [에이전트 토큰화 플랫폼(ATP, Agent Tokenization Platform)을](https://iqai.com/?ref=blog.iqai.com) 구축하고 있습니다. 여기서 개발자는 에이전트를 발행하고, 프리미엄 기능을 노출하며, 심지어 에이전트 간 자체적으로 거래까지 가능하게 할 수 있습니다. 이를 위해서는 에이전트가 매끄럽게 **요금을 청구하고 결제**할 수 있어야 합니다. 그래서 ADK-TS에 x402 결제 프로토콜을 통합해, **자율적이고 수익화된 AI 에이전트**를 만들 수 있도록 기반을 마련했습니다. * * * ADK-TS와 x402의 결합 ---------------- 이 둘을 결합하면, 에이전트는 자동으로 **온체인 결제**를 통해 요금을 청구하고 지불할 수 있습니다. 스타터 템플릿은 이를 세 가지 핵심 요소로 보여줍니다: * **서버**: x402 결제 프록시 역할, 무료/유료 API 라우트 정의 및 결제 검증 * **에이전트**: 무료 도구로 기본 작업 수행, 유료 도구로 프리미엄 기능 제공 * **클라이언트**: axios 미들웨어 + 지갑 통합 → 결제 요청 처리, 온체인 USDC 지불, 증명 포함 재시도 사용 경험은 매우 매끄럽습니다: 1. 에이전트가 무료 정보(예: API 가격)를 제공합니다. 2. 유료 기능 요청 시, 가격과 결제 동의를 명확히 안내합니다. 3. 승인 후 자동 결제가 진행되고 결과가 반환됩니다. 즉, **API 키도, 구독도 필요 없습니다.** 오직 암호화폐로 건별 결제만. * * * 구조 심층 분석: 에이전트 템플릿 아키텍처 ----------------------- ![](https://storage.googleapis.com/papyrus_images/b085c82e0bdfb9604233c2981ea13894877d8947944426dcdbcbfa25539054ce.png) ADK-TS x402 템플릿은 두 부분으로 구성됩니다: * **서버 컴포넌트**: IQ AI API에 연결된 x402 결제 프록시. 무료/유료 라우트 정의 + 가격 조회 API 제공. * **에이전트 컴포넌트**: 무료 및 유료 기능을 제공하는 TypeScript 기반 에이전트. 항상 **GET\_PRICES** 도구를 통해 가격 투명성 제공. 핵심 로직은 세 파일에 분산되어 있습니다: * `server/src/index.ts`: 가격 맵 및 결제 미들웨어 정의 * `agent/src/agents/IQ-x402/tools.ts`: axios + x402로 무료/유료 기능 구현 * `agent/src/agents/IQ-x402/agent.ts`: 사용자와 상호작용, 가격 안내, 결제 동의 요청 * * * 테스트 및 체험 -------- 템플릿 실행 시, 브라우저 UI(adk-web)에서 에이전트와 직접 상호작용할 수 있습니다. * 무료 액션(가격 조회)은 즉시 실행 → 투명성 제공 * 유료 액션(API 통계 조회 등) → x402 결제 플로우 작동: 1. 서버가 402 응답 반환 2. 지갑이 Base Sepolia 테스트넷 USDC 결제 승인 요청 3. 승인 후, 에이전트가 요청을 재시도해 결과 제공 💡 팁: 테스트 전 Base Sepolia faucet에서 테스트용 USDC와 ETH를 받아두세요. ![](https://storage.googleapis.com/papyrus_images/e63400139c295c868ea7b67b42e02c53a0eaa82d893c6652a1ec9e59576c409b.png) * * * ADK-TS + x402의 진정한 가치 --------------------- ADK-TS는 **지능**을, x402는 **경제성**을 담당합니다. * ADK-TS: 메모리, 워크플로우, 멀티에이전트 오케스트레이션 * x402: 온체인 마이크로페이먼트 함께라면, 에이전트는 스스로 **지불, 수익화, 경제 활동**을 수행하는 완전한 디지털 경제 주체가 됩니다. 예시: * API 사용량 기반 결제 (구독 불필요) * 에이전트끼리 서비스/데이터 거래 * 광고 없이 데이터/인사이트를 직접 수익화 * * * 지갑 결제 흐름 (x402) --------------- * 유저가 유료 기능 요청 → 서버가 402 반환 * 지갑 팝업: "USDC $0.05 결제하시겠습니까?" * 승인 시 자동 결제 → X-PAYMENT 헤더 포함 재요청 → 서버 검증 후 결과 반환 즉, 암호화폐 마이크로페이먼트가 **커피 결제만큼 간단해지는 경험**을 제공합니다. * * * 왜 중요한가? ------- 이 템플릿은 단순한 PoC가 아닙니다. * **구독 모델에서 건별 결제 모델**로의 전환 * **에이전트 마켓플레이스** 구축 가능성 * **탈중앙화 자율 경제** 기반 마련 AI가 단순히 똑똑할 뿐 아니라, **경제적 자율성**까지 가지게 되는 미래를 열어갑니다. * * * 지금 시작하기 ------- 템플릿은 Base Sepolia 테스트넷에서 실행되며, 무료로 실험할 수 있습니다. * 무료/유료 API 라우트가 있는 서버 * ADK-TS 기반 에이전트 (무료/유료 기능 포함) * 자동 결제를 지원하는 지갑 통합 클라이언트 레포 클론 후 `pnpm run dev`로 실행해보세요. * * * 결론: AI + 암호화폐 결제 = 미래 --------------------- 인터넷은 수십 년 동안 표준화된 사용량 기반 결제를 기다려왔습니다. Coinbase의 x402가 그 표준을 제공합니다. ADK-TS는 이를 AI 에이전트에 매끄럽게 통합합니다. 그리고 IQ AI는 이러한 **수익화된 에이전트**가 성장할 생태계를 구축하고 있습니다. 이것은 시작에 불과합니다. **사용량 기반 자율형 AI**의 미래는 이제 여러분의 손에 있습니다. * * * 리소스 --- * [**IQ AI x402 Agent Template**](https://github.com/IQAIcom/iqai-x402-agent?ref=blog.iqai.com) – ADK-TS + x402 스타터 프로젝트 * [**IQ AI Agent Tokenization Platform**](https://iqai.com/?ref=blog.iqai.com) – AI 에이전트 발행, 거래, 수익화 플랫폼 * [**ADK-TS GitHub Repository**](https://github.com/IQAIcom/adk-ts?ref=blog.iqai.com) – AI 에이전트 개발용 TypeScript SDK * [**ADK-TS Documentation**](https://adk.iqai.com/?ref=blog.iqai.com) – 가이드, API 레퍼런스, 예시 * [**x402 Official Website**](https://x402.org/?ref=blog.iqai.com) – x402 공식 사이트 및 업데이트 * [**x402 GitHub Repository (Coinbase)**](https://github.com/coinbase/x402?ref=blog.iqai.com) – Coinbase가 유지하는 오픈소스 구현 --- *Originally published on [IQ.Wiki Blog (KR)](https://paragraph.com/@iq-wiki-blog-kr/adk-ts-x402-ai)*