跳至主要內容

如何透過x402 存取Quicknode

更新於
Aug 14, 2026
塞爾根·烏伊薩爾 個人簡介
塞爾根·烏伊薩爾
全部
x402
付款
AI
Agents
RPC
基礎設施
影片

閱讀時間 13 分鐘

概覽​

Quicknode基礎設施為所有受支援的區塊鏈網路處理數十億次請求。透過Quicknode x402 任何擁有錢包的客戶端皆可透過基於x402 三大支付模式——按請求付費、納米支付及信用額度提領——來使用該基礎設施。支援使用受支援的穩定幣進行支付。無需帳戶、API 金鑰或訂閱服務。

這為開發人員和AIagents使用區塊鏈基礎架構開闢了新的可能性。無需endpoint 配置endpoint ，您只需連接錢包，即可立即透過 JSON-RPC、REST、gRPC 及 WebSocket 協定進行呼叫。

本指南將帶您了解Quicknode x402 Quicknode 如何Quicknode 、適用對象為何，以及如何發出第一個x402 RPC 請求。

免費方案

每個錢包在Quicknode各代理支付介面中，每月均可享有1,000,000 API 積分的共享免費額度，包括 x402 及MPP。標準 RPC 請求每次消耗1 個 API 積分，而 SQL Explorer 則會消耗查詢所使用的 API 積分。


Alpha 版本

Quicknode x402 目前Quicknode Alpha 測試階段。此服務旨在供實驗與早期採用。雖然其底層基礎架構與驅動Quicknode 平台的生產級系統相同，但x402 層是全新的且仍在持續演進中。隨著產品日趨成熟，預期 API 可能會有所變更、速率限制可能調整，且功能將持續優化。

Agentic Payments

Quicknode 用於代理式支付的MPP（機器支付協定）。MPP 使用 IETF 支付驗證標頭，並提供基於費用與會話的存取模式。請參閱《代理式支付概覽》以獲取並列比較。


  • 比較這三種付款模式（按請求付費、奈米支付、信用額度提款），並根據您的使用情境選擇最適合的一種
  • 執行使用「信用額度提領」功能的 JSON-RPC 範例，以查看Base 上的完整認證與付款流程
  • 探索涵蓋 JSON-RPC、REST、gRPC 及 WebSocket 的多協議範例
訂閱我們的 YouTube 頻道，觀看更多影片！

您需要準備的物品​


  • Node.js（v20 或更高版本）和 npm
  • 對區塊鏈概念有基本了解

就是這樣。您不需要Quicknode 或 API 金鑰。該 x402 該套件會自動處理身份驗證、支付簽名及協商（具體細節取決於您選擇的支付模式）。針對本指南中的信用提款範例，您需要一個在Base 上持有testnet 的錢包。您可以從 圓形水龍頭.

為什麼x402 Quicknode x402​

x402 在既有方案之外使用Quicknode 基礎設施的新方式。x402 三種存取模式：按請求付費、奈米支付以及信用額度提領。它專為那些相較於傳統帳戶設定，以錢包為基礎的隨需存取模式更為合適的使用情境而設計：


  • 需要在不需人工介入的情況下進行身分驗證和付款 agents 工智慧agents 自主機器人。agent 擁有一個存有受支援穩定幣的錢包，即可開始執行呼叫。
  • 開發者正在打造agent工具，讓最終使用者無需擁有自己的帳戶，即可與Quicknode 進行互動。
  • 使用頻率較低的開發者，希望偶爾存取跨多條鏈的高品質端點，但無需綁定特定方案。
  • 重視隱私且偏好透過錢包存取，而非註冊帳戶的使用者。
  • 實驗與原型開發，讓開發人員能在不需耗費設定時間的情況下，快速跨網路進行測試。

關鍵差異在於：現有方案是針對可預測計費的持續使用情境所優化；而x402 針對隨需存取情境所優化，其中每項請求皆會個別計費。

運作原理​

Quicknode x402 Quicknode 三種付款模式。這三種模式均採用 x402 客戶；該 付款模式 此選項用於控制哪一個處於活躍狀態：

  • 按請求付費 (paymentModel: '按請求計費'): 無需驗證。每個請求均包含由客戶端自動處理的付款簽名。
  • 微支付 (paymentModel: 'nanopayment'): 無需驗證。透過 Circle Gateway. 需向 Gateway 錢包合約進行一次性的 USDC 存款；Gateway API 會等待 鏈專屬區塊確認次數 在更新餘額之前。支付鏈僅限於特定 EVM 測試網（Base 、Polygon 、Arc Testnet）。
  • 信貸提款 (paymentModel: 'credit-drawdown', 預設值)：透過 SIWX 進行一次身份驗證，購買信用點數包，並按每次請求消耗信用點數。此設定為gRPC 和 WebSocket 傳輸方式的必填項目。

無論您使用哪種支付模式或支付鏈，皆可查詢Quicknode 所支援的任何網路。有關各模式的協定可用性，請參閱「多協定支援」一節。

下圖顯示了本指南範例所採用的信用 flow。對於「按請求付費」及「納米支付」，步驟 1 和 2 將被跳過：每個請求皆直接包含付款簽名，無需事先進行驗證。


信貸提款：逐步指南​

該 x402 當您設定後，此套件flow 處理整個信用額度提領flow preAuth: true. 您無需手動執行這些步驟。以下是背後運作的原理：

1. 透過 SIWX 進行驗證

客戶端使用其錢包簽署一則「透過 X 登入」（SIWX）訊息。此舉可證明該錢包地址的所有權，同時不會洩露任何私鑰。代理伺服器會回傳一個 JWT 憑證（有效期為一小時），客戶端將此憑證包含於後續的請求中。

2. 首次請求返回 402 狀態碼

當您進行第一次呼叫（或任何信用點數為零的呼叫）時，代理伺服器會回應如下： HTTP 402 需付款. 此回覆包含依據以下規定所訂定的付款要求： x402 規格，並註明付款金額及網路。

3. 支付與收取學分

客戶簽署穩定幣付款授權（EVM 採用 EIPSolana 採用 SPL 轉帳），並附上付款標頭重新發送請求。x402 將在鏈上結算該筆付款，而代理則會將請求包存入您的帳戶。

4. 消耗點數

從那時起，每次請求都會扣除一個信用點。當餘額降至零時，下一次請求會觸發另一個 402 錯誤，此循環便會重複。代理伺服器背後的基础架構，正是驅動所有Quicknode 同一套生產系統。

付款方式​

型號成本免費方案最適合
按請求付費每次請求 $0.001每個錢包每月可共享 1,000,000 API 積分簡單的整合，低交易量
微支付每次請求 $0.0001每個錢包每月可共享 1,000,000 API 積分大規模檢測，成本低於一美分
信貸提款Testnet：1,000 點數需 1 美元。Mainnet：1,000,000 點數需 10 美元每個錢包每月可共享 1,000,000 API 積分持續使用、gRPC、WebSocket

每個錢包在x402 MPP 之間會獲得一個共享的免費層級儲存桶。RPC 請求每次消耗 1 個 API 信用點，而 SQL Explorer 則會消耗查詢所使用的 API 信用點。當每月 1,000,000 個 API 信用點用罄後，付費使用將繼續按照適用於各模型的費率計費。

有關支援的支付網路完整清單，以及各支付網路所支援的型號，請參閱x402 文件中的「支援的支付網路」表格。

透過x402支援的網路​

無論您使用哪種支付模式或支付網路，皆可查詢Quicknode 所支援的任何區塊鏈網路，包括Ethereum（Ethereum、Base、Solana、Arbitrum、Polygon、Aptos、Flow 以及更多其他網路。

有關支援的區塊鏈完整清單，請參閱Quicknode「支援的區塊鏈」頁面。

多協定支援​

Quicknode x402 Quicknode 多種通訊協定，但實際可用的通訊協定取決於付款模式。按請求計費（Pay-per-request）和奈米支付（nanopayment）僅支援 JSON-RPC 和 REST；而gRPC 和 WebSocket 則需要預先扣款。

議程按請求付費微支付信貸提款用例
JSON-RPC是的是的是的標準 RPC 呼叫（例如：eth_blockNumber、getBlock）
REST是的是的是的HTTP GET 端點（例如：/v1/blocks/by_height）
gRPC不不是的用於高效能區塊鏈的一元呼叫與伺服器端串流（例如GetLatestBlock）
WebSocket不不是的即時訂閱（例如：eth_subscribe、accountSubscribe）

只需一個錢包，您即可存取Quicknode 所支援的任何鏈，涵蓋所有四種協定：Solana JSON-RPC 存取 EVM 鏈或Solana 、Aptos RESTAptos 存取Aptos 、Flow gRPC 存Flow ，以及透過 WebSocket 存取即時Ethereum 。

x402 儲存庫包含各通訊協定的可運作腳本。在下一節中，我們將逐步解析一個基本的 JSON-RPC 範例，您可依自己的步調探索這些可運作的腳本。

入門：JSON-RPC 範例​

本操作指南使用的是 信貸提款 用以示範完整認證與付款流程的範例。若您希望完全跳過認證步驟，請設定 paymentModel: '按請求計費' 改在客戶端設定中進行設定。

我們將製作 eth_blockNumber 呼籲「Base 」以及 getSlot 透過以下方式呼叫Solana ： x402 套件。

x402 儲存庫除了包含REST、gRPC 和 WebSocket 腳本外，還附有專屬的 JSON-RPC 範例，所有腳本均內建對Base 的 faucet 支援。以下指南將從頭開始建立一個獨立運作的腳本，讓您能清楚了解每個步驟。

步驟 1：設定專案​

mkdir x402-quickstart && cd x402-quickstart
npm init -y
npm install @quicknode/x402 tsx

步驟 2：建立 .env 檔案​

建立一個 .env 在專案根目錄中建立一個檔案，並加入您的 EVM 私鑰（適用於Base ）：

.env
PRIVATE_KEY=0x您的私鑰請填入此處

步驟 3：建立腳本​

建立一個名為 index.ts. 此腳本會建立一個客戶端，其 x402, 反覆地 eth_blockNumber 以及 getSlot 會呼叫以消耗點數，並在每次呼叫後記錄剩餘點數。

index.ts
import { createQuicknodeX402Client } from '@quicknode/x402'

const X402_BASE_URL = 'https://x402.quicknode.com'
const NETWORK = 'eip155:84532' // Base Sepolia

async function main() {
	// Credit drawdown: preAuth speeds up payment by authenticating (SIWX + JWT) upfront
	const client = await createQuicknodeX402Client({
		baseUrl: X402_BASE_URL,
		network: NETWORK,
		evmPrivateKey: process.env.PRIVATE_KEY || undefined,
		paymentModel: 'credit-drawdown',
		preAuth: true,
	})

	console.log('Client ready. Payment will be made with USDC on Base Sepolia.')
	console.log(
		'Making calls: eth_blockNumber on Base Sepolia and getSlot on Solana Devnet...\n'
	)

	// Make requests in a loop to see credit consumption
	for (let i = 1; i <= 10; i++) {
		const evmResponse = await client.fetch(`${X402_BASE_URL}/base-sepolia`, {
			method: 'POST',
			headers: { 'Content-Type': 'application/json' },
			body: JSON.stringify({
				jsonrpc: '2.0',
				id: i,
				method: 'eth_blockNumber',
				params: [],
			}),
		})

		const evmData = await evmResponse.json()
		const block = BigInt(evmData.result)
		console.log(`Request #${i}: Block ${block}`)
		console.log(
			'Credits:',
			(
				await fetch('https://x402.quicknode.com/credits', {
					headers: { Authorization: `Bearer ${client.getToken()}` },
				}).then(r => r.json())
			).credits
		)

		const solanaResponse = await client.fetch(
			'https://x402.quicknode.com/solana-devnet',
			{
				method: 'POST',
				headers: { 'Content-Type': 'application/json' },
				body: JSON.stringify({
					jsonrpc: '2.0',
					id: 1,
					method: 'getSlot',
					params: [],
				}),
			}
		)
		const solanaData = await solanaResponse.json()
		const slot = solanaData.result
		console.log(`Request #${i}: Solana Slot ${slot}`)
		console.log(
			'Credits:',
			(
				await fetch('https://x402.quicknode.com/credits', {
					headers: { Authorization: `Bearer ${client.getToken()}` },
				}).then(r => r.json())
			).credits
		)

		console.log('\n')
	}
}

main().catch(console.error)

步驟 4：執行程式​

需具備Testnet

在進行x402 ，您的錢包需要存有Base USDCtestnet 您可以從 圓形水龍頭. 或者，該 x402 儲存庫 包含一個 設定範例 具備內建自動水龍頭邏輯的輔助程式，用於實現自動化flow。

npx tsx --env-file=.env index.ts

首次執行時，客戶將：


  1. 使用提供的私鑰和設定建立一個客戶端
  2. 透過 SIWX 進行預先驗證 (附 preAuth: true) 透過簽署訊息並預先取得 JWT
  3. 製作 eth_blockNumber 以及 getSlot 呼叫，每次成功回應將消耗一個學分
  4. 當餘額用罄時，自動處理 402 款項
預期輸出
Client ready. Payment will be made with USDC on Base Sepolia.
Making calls: eth_blockNumber on Base Sepolia and getSlot on Solana Devnet...

Request #1: Block 38357505
Credits: 99
Request #1: Solana Slot 445776251
Credits: 98

Request #2: Block 38357506
Credits: 97
Request #2: Solana Slot 445776252
Credits: 96

# ... if you run the script multiple times, you'll see the 402 payment flow in action when credits run out:

Request #4: Block 38375819
Credits: 1
Request #4: Solana Slot 445872102
Credits: 0

Request #5: Block 38375821
Credits: 99
Request #5: Solana Slot 445872112
Credits: 98

Solana​

若要將x402 Solana 搭配使用，您需要一個內含 Devnet USDC 的錢包。該 /drip 該錢包僅支援 EVM，因此Solana 必須手動充值。

  1. 設定Solana ：產生一組新的金鑰對，或使用現有的 Base58 編碼密鑰。

    要產生一組新的Solana ：

    npm install tweetnacl bs58
    npx tsx -e "
    import nacl from 'tweetnacl'; import bs58 from 'bs58';
    const kp = nacl.sign.keyPair();
    console.log('Public key:', bs58.encode(Buffer.from(kp.publicKey)));
    console.log('Secret key:', bs58.encode(Buffer.from(kp.secretKey)));
    "

  2. 透過Solana 的 USDC 進行充值: 造訪 faucet.circle.com 並申請 Devnet USDC（鑄造： 4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU) 作為您的錢包地址。您需要 不是 需要 SOL。x402 負責支付交易手續費。

  3. 使用Solana 建立客戶端：

import { createQuicknodeX402Client } from '@quicknode/x402'

const client = await createQuicknodeX402Client({
	baseUrl: 'https://x402.quicknode.com',
	network: 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1', // Solana Devnet
	svmPrivateKey: '<YOUR_BASE58_SECRET_KEY>',
	preAuth: true,
})

該 svmPrivateKey 此參數接受以 Base58 編碼的密鑰。對於 EVM 鏈，請使用 evmPrivateKey 而是使用十六進位編碼的金鑰。

接著，您可以使用同一個客戶端向任何區塊鏈（不僅限於Solana）發起交易，而支付將透過您的Solana USDC 進行。

理解程式碼​

讓我們來看看這個範例運作原理的關鍵部分。

客戶設定​

該 建立 Quicknode X402 客戶端 此函式會建立一個客戶端，負責處理這三種模型間的付款協商。對於信用額度提款，它還會管理 SIWX 驗證及 JWT 會話：

import { createQuicknodeX402Client } from '@quicknode/x402'

const client = await createQuicknodeX402Client({
	baseUrl: 'https://x402.quicknode.com',
	network: 'eip155:84532',
	evmPrivateKey: process.env.PRIVATE_KEY as `0x${string}`,
	paymentModel: 'credit-drawdown',
	preAuth: true,
})
參數說明
baseUrlx402 URL。預設值： https://x402.quicknode.com
網路CAIP-2 鏈識別碼 針對支付網路（例如， eip155:84532 針對Base Sepolia， solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1 （適用於Solana ）
evmPrivateKeyEVM 鏈的十六進位編碼私鑰。若為Solana，請使用 svmPrivateKey 使用 Base58 編碼的金鑰
付款模式「按請求付費」, 「微支付」，或 「信貸提款」 (預設)。控制驗證與付款行為
preAuth僅限信用額度提款。當 true, 在首次請求前進行預先驗證（SIWX + JWT），使付款flow

提出請求​

該 client.fetch 此方法符合標準的 Fetch API。認證與付款皆以透明方式處理：

const evmResponse = await client.fetch(`${X402_BASE_URL}/base-sepolia`, {
	method: 'POST',
	headers: { 'Content-Type': 'application/json' },
	body: JSON.stringify({
		jsonrpc: '2.0',
		id: i,
		method: 'eth_blockNumber',
		params: [],
	}),
})

const evmData = await evmResponse.json()
const block = BigInt(evmData.result)
console.log(`Request #${i}: Block ${block}`)

const solanaResponse = await client.fetch(
	'https://x402.quicknode.com/solana-devnet',
	{
		method: 'POST',
		headers: { 'Content-Type': 'application/json' },
		body: JSON.stringify({
			jsonrpc: '2.0',
			id: 1,
			method: 'getSlot',
			params: [],
		}),
	}
)
const solanaData = await solanaResponse.json()
const slot = solanaData.result
console.log(`Request #${i}: Solana Slot ${slot}`)

請使用以下 URL 格式 https://x402.quicknode.com/{network} 以鎖定不同的區塊鏈。支付網路（設定於 網路 （在建立客戶端時）無需與您正在查詢的區塊鏈相符。

探索其他請求類型​

執行指南中的範例後，請進一步探索 x402 儲存庫 以了解x402 不同通訊協定和區塊鏈上的x402 運作。所有範例均使用 x402.

REST API​

該 rest.ts 此腳本示範了在Aptos Mainnet上x402 REST API 端點x402 功能。它會向諸如 /v1/ (帳簿資訊)， /v1/blocks/by_height/{h}，以及 /v1/accounts/0x1.

npm run start:rest

gRPC​

該 grpc.ts 此腳本同時展示了單元運算子呼叫（Ping, GetLatestBlock) 以及伺服器端串流 (訂閱 阻擋 最新動態) 於Flow Mainnet @connectrpc/connect-web.

npm run start:grpc

WebSocket​

該 websocket.ts 該腳本訂閱了 newHeads Mainnet Base Mainnet eth_subscribe, 在區塊標頭產生時即時接收。它使用非阻塞式信用點數查詢器來追蹤剩餘信用點數，同時不會中斷資料流。當信用點數耗盡時，連線會處理該 4402 關閉程式碼後，即可自動重新驗證。

npm run start:ws

有關各腳本的完整詳細資訊（包括設定選項和網路覆寫設定），請參閱範例儲存庫的README 文件。

在Quicknode上運用 AI 進行開發​

x402 Quicknode 人工智慧與agent 中的其中一層。每項工具皆針對工作流程的不同環節提供支援：搜尋文件、產生正確的程式碼、存取端點，以及管理基礎架構。《Build with AI》文件涵蓋了整個套件：


  • 針對 LLM 優化的文件： llms.txt 有助於大型語言模型（LLMs）針對任何問題找出合適的Quicknode 索引。
  • Build Web3 Plugin: An agent plugin that helps AI coding agents plan, build, and improve Web3 apps, with accurate Quicknode product knowledge built in. One install bundles the build-web3 skill and the Quicknode MCP server. In Claude Code, install it with /plugin marketplace add quicknode/agent-plugins.
  • x402 ：基於錢包的存取機制，提供三種支付模式（按請求付費、微支付、信用額度提領）。本指南涵蓋的內容。
  • MPP 付款：採用 IETF 付款驗證標頭的「按請求付費」存取模式，提供「每請求計費」（$0.001）及「基於會話計費」（$0.00001/請求）兩種定價方案。
  • Quicknode ：透過Claude 、Cursor、Codex 及其他相容於 MCPagents，以自然語言管理Quicknode 。
請嘗試使用x402 Hyperliquid

Quicknode開源HyperCore CLI亦支援x402 。開發者可直接從終端機串流及回填Hyperliquid ，並透過錢包按請求次數付費，無需擁有Quicknode 。

下一步​

既然您已經x402 Quicknode x402 見識過x402 Quicknode 運作，以下提供一些進一步探索的方法：

試試其他通訊協定

本指南雖然以 JSON-RPC 為例進行說明，但x402 儲存庫中也包含適用於 REST、gRPC 及 WebSocket 的可運作腳本。gRPC 和 WebSocket 需要進行信用額度提領；JSON-RPC 和 REST 則適用於這三種支付模式。

遷移至Mainnet

每個錢包每月享有 1,000,000 API 積分 的免費層級儲存桶，此配額適用於x402 MPP。RPC 請求每次消耗 1 個 API 積分，而 SQL Explorer 則消耗查詢所使用的 API 積分。免費層級用罄後，付費使用將繼續按照各模型適用的費率計費。付款機制與免費層級完全相同，只是改以真實資金支付。

建置Agent

將x402 整合x402 您的 AIagent 聊天機器人x402 。該 x402 該套件會自動處理身份驗證和付款事宜，因此任何使用 fetch 只需進行微幅調整即可加以應用。由於整個flow HTTP，因此任何能夠對訊息進行簽名並發出 HTTP 請求的客戶端皆可使用此功能。

Use the Quicknode CLI

Prefer the terminal over writing a client? The Quicknode CLI guide covers paying for RPC calls with x402 or MPP directly from qn, including per-request payments, prepaid credit drawdown, and MPP payment channels.

深入探索x402

若想深入了解x402 本身的技術細節，請參閱：


結論​

Quicknode x402 Quicknode 使用區塊鏈基礎設施的新方式，專為希望透過錢包驗證實現隨需存取的agents、機器人及開發人員而設計。安裝 x402, 可透過「按請求付費」、「納米支付」或「信用額度提領」等方式，使用受支援的穩定幣進行支付，並透過 JSON-RPC、REST、gRPC 或 WebSocket 存取所有受支援的網路。無需註冊。

This is an alpha release, and we're actively iterating based on developer and agent feedback. If you have questions, ideas, or run into issues, reach out on our Discord server or share feedback in the feedback section at the end of this page. Stay up to date by following us on X and our Telegram announcement channel.

最後更新時間 於