퀵노드

2026년 2월 17일 — 읽는 데 11분 소요

Quicknode는 이제 x402 요청당 결제(pay-per-request) 방식을 지원하여, 개발자와 AI 에이전트가 130개 이상의 네트워크에 걸쳐 있는 블록체인 엔드포인트에 지갑 인증을 통해 즉시 접근할 수 있게 되었습니다. 여기에는 RPC, WebSocket, REST 및 gRPC 인터페이스가 포함됩니다. Base, Solana 또는 Polygon에서 USDC로 결제하면 몇 분 안에 호출을 시작할 수 있습니다.

x402는 Quicknode의 기존 요금제를 보완하는 추가형 액세스 방식입니다. 프로덕션 워크로드를 운영하는 팀은 SLA, 전담 지원, 크레딧 기반 과금 등이 포함된 Quicknode의 표준 요금제의 혜택을 누릴 수 있습니다. x402는 가볍고 허가 없이 이용할 수 있는 액세스가 우선시되는 사용 사례에 새로운 옵션을 제공합니다.

이 글에서는 x402가 무엇인지, Quicknode와 어떻게 연동되는지, 이를 활용해 무엇을 만들 수 있는지, 그리고 시작하는 방법에 대해 다룹니다.

x402란 무엇인가요?

x402는 코인베이스(Coinbase)가 개발한 개방형 결제 프로토콜로, HTTP에 네이티브 결제 기능을 도입합니다. 이 프로토콜은 오랫동안 예약되어 있던 HTTP 402 “결제 필요(Payment Required)” 상태 코드를 부활시켜, 이를 인터넷을 위한 실용적인 결제 계층으로 전환합니다.

이 개념은 간단합니다. 클라이언트가 x402를 지원하는 엔드포인트에 결제 없이 요청을 보내면, 서버는 402 상태 코드를 반환하며 결제 안내(가격, 허용되는 토큰, 네트워크, 지갑 주소)를 포함합니다. 클라이언트는 USDC 결제 승인서에 서명하여 요청 헤더에 첨부한 후 다시 시도합니다. 서버는 중개자를 통해 결제를 검증하고, 온체인에서 결제를 처리한 뒤 요청된 데이터를 반환합니다.

이는 특히 AI 에이전트에게 큰 의미가 있습니다. 기존의 결제 시스템은 사람이 직접 가입 절차를 진행하고, 인증 정보를 관리하며, 청구 주기를 처리해야 합니다. x402는 이러한 모든 과정을 없애줍니다. 지갑을 보유한 에이전트는 사람의 개입 없이도 API 서비스를 자율적으로 탐색하고, 요금을 지불하며, 서비스를 이용할 수 있습니다.

Quicknode가 x402를 지원하는 이유

Quicknode는 80개 이상의 체인과 130개 이상의 네트워크에 걸쳐 개발자와 기업에 블록체인 인프라를 제공합니다. 이 인프라를 이용하려면 일반적으로 계정을 생성하고 API 키를 관리해야 하는데, 이는 실제 운영용 애플리케이션을 구축하는 팀에게는 적합한 방식입니다.

x402는 AI 에이전트, 신속한 프로토타이핑을 수행하는 사용자, 계획을 확정하기 전에 테스트를 진행하고자 하는 개발자 등 점점 늘어나는 사용자층을 위한 보완적인 접근 경로를 제공합니다. Quicknode 엔드포인트에서 x402를 활성화하면, 지갑을 보유한 누구나(또는 무엇이든) 다음을 수행할 수 있습니다:

• 130개 이상의 블록체인 네트워크에 걸쳐 RPC, WebSocket, REST 및 gRPC 엔드포인트에 액세스하세요

• 드로다운 크레딧 모델을 활용한 USDC 기반 요청당 결제 방식입니다. 잔액을 한 번만 충전하면, 각 요청 시 크레딧에서 자동으로 차감되므로 호출당 결제 지연 시간이 발생하지 않습니다.

• EVM 및 Solana 지갑을 모두 지원하는 지갑 기반 인증(Sign-In with X / SIWx)을 통해 인증합니다.

• devnet USDC를 사용하여 최대 10,000건의 무료 요청으로 시작해 보세요

결제 네트워크는 쿼리 대상인 엔드포인트와 분리되어 있습니다. 즉, Base에서 USDC로 결제하고 Solana에 쿼리를 보내거나, Solana USDC로 결제하고 Ethereum에 쿼리를 보내거나, Polygon USDC로 결제할 수도 있습니다. 결제를 진행하는 체인과 쿼리를 보내는 체인이 반드시 일치할 필요는 없습니다.

x402 vs 표준 Quicknode 요금제

x402는 추가 옵션입니다. 이 옵션은 Quicknode의 표준 요금제를 대체하지 않습니다. 프로덕션 워크로드를 운영하는 팀은 계속해서 표준 SLA 요금제, 전용 지원 서비스 및 더 높은 사용 한도를 이용해야 합니다.

지원되는 결제 네트워크

Quicknode의 x402 구현은 현재 다음 플랫폼에서 USDC 결제를 지원합니다:

• 베이스 (메인넷 및 세폴리아 테스트넷)

• 솔라나 (메인넷 및 개발자 네트워크)

• Polygon (메인넷 및 Amoy 테스트넷)

추가 결제 네트워크가 활발히 추가되고 있습니다. x402 프로토콜은 설계상 체인에 구애받지 않으므로, 새로운 중개자가 서비스에 참여함에 따라 지원 범위를 확대하는 것은 간단합니다.

테스트를 위해 개발자들은 Base Sepolia, Solana 개발자 네트워크 또는 Polygon Amoy의 devnet USDC를 사용하여 Quicknode의 모든 운영용 엔드포인트에 대해 최대 10,000건의 무료 요청을 이용할 수 있습니다.

작동 원리: 기술적 흐름

에이전트나 개발자가 Quicknode에 x402를 지원하는 요청을 보낼 때 내부적으로 다음과 같은 과정이 진행됩니다:

1. 초기 요청: 클라이언트가 결제 헤더를 포함하지 않은 HTTP 요청을 Quicknode x402 엔드포인트로 전송합니다.

2. 402 응답: 서버는 HTTP 402 응답과 함께 결제 세부 정보가 포함된 PAYMENT-REQUIRED 헤더를 반환합니다. 이 헤더에는 요청당 가격, 허용되는 토큰(USDC), 지원되는 네트워크(Base, Solana, Polygon), 그리고 결제 대상 지갑 주소가 포함됩니다.

3. 지갑 인증: 클라이언트는 SIWx(Sign-In with X)를 사용하여 인증합니다. Quicknode의 구현 방식은 SIWx를 활용해 JWT 토큰을 발급하며, 요청마다 발생하는 서명 검증 오버헤드(호출당 10~20ms가 추가됨)를 피함으로써 성능을 최적화합니다.

4. 지불 승인: 클라이언트는 EIP-3009(EVM용) 또는 이에 상응하는 Solana 서명 방식을 사용하여 USDC 이체 승인서에 서명합니다. 이는 클라이언트에게 가스 비용이 발생하지 않는 작업입니다.

5. 결제와 함께 재시도: 클라이언트는 X-PAYMENT 헤더에 서명된 결제 정보를 포함하여 원래 요청을 다시 시도합니다.

6. 검증 및 정산: 진행자는 서명된 승인서를 검증하고, 온체인에서 USDC 이체를 정산한 뒤 결제를 확인합니다.

7. 응답: Quicknode는 요청된 데이터를 반환합니다.

x402 클라이언트 라이브러리는 2단계부터 6단계까지를 자동으로 처리합니다. 개발자의 관점에서 보면, 이 코드는 표준 HTTP 요청처럼 보입니다.

만들 수 있는 것들

자율적인 블록체인 접근 권한을 가진 AI 에이전트

가장 직접적인 활용 사례는 AI 에이전트가 미리 설정된 API 키 없이도 블록체인 데이터와 상호작용할 수 있도록 하는 것입니다. 에이전트는 다음과 같은 작업을 수행할 수 있습니다:

• 체인 간 토큰 가격 및 포트폴리오 잔액 조회

• 지갑 활동 및 거래 내역 모니터링

• DeFi 프로토콜에 대한 블록체인 읽기 작업 실행

• 분석을 위해 과거 블록 데이터에 접근하기

이 모든 과정이 사람이 먼저 계정을 만들 필요 없이 이루어집니다.

AI 기반 인프라 관리를 위한 MCP 서버

Quicknode의 공식 MCP 서버 (@quicknode/mcp)는 Claude나 Cursor와 같은 AI 어시스턴트에 블록체인 인프라 관리 기능을 직접 통합합니다. MCP 서버를 통해 AI 어시스턴트는 여러 네트워크에 걸쳐 Quicknode 엔드포인트를 설정 및 구성하고, 사용량과 요금을 모니터링하며, 자연어를 통해 인프라를 관리할 수 있습니다. 이는 x402와 잘 어울립니다. MCP 서버를 사용하여 Quicknode 인프라를 프로비저닝하고 관리하며, x402를 통해 지갑 인증 방식의 경량 엔드포인트 액세스를 이용할 수 있습니다.

npx를 통해 설치하기:

npx -y @quicknode/mcp

npm에서 해당 패키지를 확인해 보세요: npmjs.com/package/@quicknode/mcp

AI 코딩 에이전트를 위한 블록체인 기술

Quicknode는 또한 AI 코딩 에이전트에게 Quicknode의 전체 제품군에 대한 정확하고 최신 정보를 제공하는 경량 참조 패키지인 ‘Blockchain Skills’를 제공합니다. 단 한 번의 명령어로 Claude Code, Cursor, Codex, Windsurf 또는 스킬 호환이 가능한 모든 에이전트에 이를 추가할 수 있습니다:

npx skills quicknode-labs/blockchain-skills 추가

약 240개의 토큰으로, 컨텍스트 창을 불필요하게 부풀리지 않으면서도 에이전트에게 올바른 엔드포인트, 정확한 매개변수, 그리고 최신 모범 사례를 제공합니다. github.com/quicknode-labs/blockchain-skills에서 완전한 오픈 소스로 공개되어 있습니다. skills.sh/quicknode-labs/blockchain-skills의 스킬 레지스트리에서 확인해 보세요 .

요청당 과금 방식의 개발 및 프로토타이핑

여러 체인에서 아이디어를 테스트하고자 하는 개발자는 x402를 통해 별도의 요금제 가입 없이도 Quicknode가 지원하는 모든 네트워크에 접속할 수 있습니다. 프로토타입을 구축하고, 실제로 수행한 RPC 호출에 대해 USDC로 몇 센트만 지불한 뒤 다음 단계로 넘어가면 됩니다.

Quicknode의 Admin API는 계정 및 인프라 구성에 대한 포괄적인 프로그래밍 방식의 제어 기능을 제공하여, 에이전트와 개발자가 간단한 REST 호출을 통해 엔드포인트를 생성하고, 보안을 관리하며, 사용량을 모니터링할 수 있도록 합니다.

x402가 포함된 HyperCore CLI

Quicknode의 오픈소스 HyperCore CLI 도구 역시 x402 요청당 과금 방식의 액세스를 지원합니다. 개발자들은 Quicknode 계정이 없어도 지갑을 통해 요청당 요금을 지불함으로써, 터미널에서 직접 Hyperliquid 데이터 세트(거래, 주문, 체결, TWAP, 호가장 업데이트, 이벤트, 블록)를 스트리밍하고 백필할 수 있습니다.

전역적으로 설치하려면:

npm install -g @quicknode/hypercore-cli

CLI는 WebSocket 및 gRPC를 통한 실시간 스트리밍, 간격 복구 기능이 포함된 자동 재연결, 이력 데이터 보충, 그리고 JSON, CSV 또는 SQLite로의 출력 기능을 지원합니다.

콘텐츠 및 API 수익화

개발자들은 x402 기반 서비스를 이용할 뿐만 아니라, Quicknode의 오픈소스 툴을 활용하여 자체적인 x402 기반 API를 구축할 수도 있습니다:

• x402-rails: Rails 애플리케이션에 x402 페이월을 추가하기 위한 Ruby 젬

• x402-payments: 서명된 결제 헤더를 생성하기 위한 Ruby gem

• qn-x402-예제: EVM 및 Solana 결제 흐름에 대한 구현 예시

@quicknode/x402 및 @quicknode/x402-solana npm 패키지

그 @quicknode/x402 npm 패키지는 Quicknode의 x402 게이트웨이와 연동하는 데 권장되는 방법입니다. 이 패키지는 SIWX 지갑 인증, JWT 세션 관리, x402 결제 처리 등 전체 인증 및 결제 흐름을 하나의 설치 과정으로 통합합니다.

이전에는 Quicknode에서 x402와 연동하려면 SIWX 서명, JWT 토큰 수명 주기, 결제 헤더 생성을 수동으로 처리해야 했습니다. 이 패키지는 이러한 모든 과정을 추상화합니다. 에이전트와 개발자는 패키지를 설치하고 지갑을 연결하기만 하면, 단 몇 분 만에 인증된 유료 요청을 시작할 수 있습니다.

npm i @quicknode/x402

이 패키지는 EVM 및 Solana 지갑을 모두 지원하며, 지원되는 모든 결제 네트워크(Base, Solana, Polygon)에서 작동합니다.

@quicknode/x402 npm에서: npmjs.com/package/@quicknode/x402

출처: github.com/quicknode-labs/quicknode-x402

솔라나 사용자 여러분께: the @quicknode/x402-solana npm 래핑 @quicknode-x402 그리고 다음을 사용할 수 있는 기능을 추가하며 솔라나 키트 Quicknode의 RPC 서비스를 즉시 이용할 수 있습니다.

@quicknode/x402-solana npm에서: npmjs.com/package/@quicknode/x402-solana

출처: github.com/quicknode-labs/x402-solana

관리자 API

Quicknode의 Admin API는 개발자와 에이전트가 엔드포인트 생성 및 보안 구성부터 사용량 모니터링 및 팀 관리에 이르기까지, 계정 및 인프라 운영 전반에 대해 표준 REST 호출을 통해 완전한 프로그래밍 방식의 제어권을 행사할 수 있도록 지원합니다. x402 및 MCP 서버와 결합되면, 에이전트는 블록체인 데이터를 조회할 뿐만 아니라 이에 필요한 인프라를 프로비저닝하고 관리할 수도 있습니다.

시작하기

필수 조건

• 암호화폐 지갑(EVM 호환 지갑 또는 솔라나 지갑)

• Base, Polygon 또는 Solana상의 USDC (또는 무료 테스트용 devnet USDC)

• Node.js 18 이상 및 @quicknode/x402 패키지 (npm i @quicknode/x402)

Devnet USDC 빠른 시작 가이드 (무료)

테스트를 위해 devnet USDC를 사용하여 최대 10,000건의 무료 요청을 수행할 수 있습니다:

1. Circle USDC 페이크트에서 Base Sepolia USDC를 받으세요

2. 아니면 솔라나 페이크트에서 솔라나 개발자 네트워크(devnet)용 USDC를 받아보세요

3. 아니면 Circle USDC 페이크트에서 Polygon Amoy USDC를 받아보세요

4. ‘시작하기’ 가이드를 따르세요

제작 준비

실제 USDC를 사용한 프로덕션 환경에서는:

1. Base, Solana 또는 Polygon에서 USDC로 지갑에 자금을 충전하세요

2. @quicknode/x402 패키지를 설치하세요 (npm i @quicknode/x402)

3. 요청은 Quicknode x402 엔드포인트로 보내주십시오.

요청당 지불 금액이 미미하기 때문에, 대량의 에이전트 작업 부하와 개발 테스트 모두에 적합합니다.

오픈 소스와 생태계

Quicknode는 자사 엔드포인트에서 결제를 가능하게 하는 것을 넘어 x402 생태계에 막대한 투자를 해왔습니다:

• x402 Explorer: x402 결제 흐름을 테스트하기 위한 샘플 앱

• x402 동영상 유료화 데모: x402를 사용하여 동영상 콘텐츠에 유료 접속 제한을 적용하는 방법을 보여주는 예시

• x402 Rails 통합: Ruby on Rails API에 x402를 추가하는 가이드

• x402 페이월 가이드: x402 구현에 대한 포괄적인 안내서

• llms.txt: LLM 및 에이전트 검색 가능성을 위한 기계 가독형 문서. 프로토콜 자체는 오픈 소스이며, github.com/coinbase/x402에서 Coinbase가 관리하고 있습니다.

• @quicknode/x402 package:

자주 묻는 질문

Quicknode에서 x402란 무엇인가요?

Quicknode의 x402는 USDC를 사용하여 지갑 인증을 거친 후 요청당 결제 방식으로 Quicknode 엔드포인트(RPC, WebSocket, REST 및 gRPC)에 접근할 수 있게 해주는 알파 단계 기능입니다. 이 기능은 HTTP 402 ‘결제 필요(Payment Required)’ 표준을 사용하며, Coinbase의 공개 x402 프로토콜을 기반으로 구축되었습니다.

x402는 Quicknode 계정이나 요금제를 대체하나요?

x402 요금제는 추가형 요금제입니다. 이 요금제는 Quicknode의 표준 요금제와 병행하여 사용할 수 있는 보완적인 액세스 경로를 제공합니다. 프로덕션 워크로드를 운영하는 팀은 SLA, 전용 지원 및 더 높은 사용 한도를 위해 계속해서 표준 요금제를 사용해야 합니다. x402 요금제는 AI 에이전트, 신속한 프로토타이핑 및 허가 없이 이용 가능한 액세스를 위해 설계되었습니다.

x402를 사용하려면 Quicknode 계정이 필요한가요?

No. x402 접속은 지갑 인증 방식으로 이루어집니다. Quicknode 계정이나 API 키가 아닌, 암호화폐 지갑과 USDC가 필요합니다.

어떤 결제 네트워크를 지원하나요?

현재 Base(메인넷 및 Sepolia 테스트넷), Solana(메인넷 및 개발넷), Polygon(메인넷 및 Amoy 테스트넷)에서 USDC 결제가 지원됩니다. 추가 결제 네트워크가 계속 추가되고 있습니다. 결제 네트워크는 쿼리하는 체인과 일치할 필요가 없습니다.

AI 에이전트가 x402를 자율적으로 사용할 수 있나요?

네. x402는 자율 에이전트 액세스를 위해 설계되었습니다. 자금이 충전된 지갑을 보유한 에이전트는 사람의 개입 없이도 Quicknode 엔드포인트를 검색하고, 인증하며, 요금을 지불하고, 서비스를 이용할 수 있습니다.

x402는 실제 운영 환경에 적용할 수 있는 상태인가요?

Quicknode의 x402는 현재 알파 단계에 있습니다. 기능은 정상적으로 작동하며 사용이 가능하지만, 표준 Quicknode 요금제와 동일한 SLA 보장은 제공되지 않습니다. 가동 시간 보장 및 전용 지원이 필요한 프로덕션 워크로드의 경우, 표준 Quicknode 요금제를 사용하시기 바랍니다.

요청 한 건당 비용은 얼마인가요?

요청당 과금 방식의 요금은 최소한이며 USDC로 책정됩니다. 개발자는 devnet USDC를 사용하여 무료로 테스트할 수 있으며, 이를 통해 프로덕션 RPC 엔드포인트에 대해 최대 10,000건의 무료 요청을 이용할 수 있습니다.

인증에 어떤 지갑이 지원되나요?

EVM 호환 지갑 또는 솔라나 지갑이라면 무엇이든 가능합니다. 인증에는 SIWx(Sign-In with X)가 사용되며, 이는 EVM 및 솔라나 지갑 서명을 모두 지원합니다.

기술 요약

자료

• 안내: x402 결제를 통해 Quicknode 엔드포인트에 접속하기

• 예시: github.com/quicknode-labs/qn-guide-examples

• 동영상 안내: Quicknode에서 x402를 시작하는 방법

• x402 프로토콜 설명: x402 결제 프로토콜이란 무엇인가요?

• 샘플 앱: Quicknode 샘플 앱 라이브러리

• HyperCore CLI: npmjs.com/package/@quicknode/hypercore-cli

• llms.txt: x402.quicknode.com/llms.txt

• x402 Ecosystem:

Quicknode는 80개 이상의 체인과 130개 이상의 네트워크를 아우르며 개발자와 기업에 블록체인 인프라를 제공합니다. 표준 요금제로 시작하거나, x402 요청당 과금 방식의 액세스 기능을 통해 즉시 엔드포인트에 접속해 보세요.