Quicknode

2026年2月17日 — 阅读时间11分钟

Quicknode 现已支持 x402 按请求付费访问模式，让开发者和 AI 代理能够通过钱包认证，即时访问 130 多个网络上的区块链端点。这包括 RPC、WebSocket、REST 和 gRPC 接口。您可以在 Base、Solana 或 Polygon 上使用 USDC 支付，几分钟内即可开始发起调用。

x402 是一种补充性访问方式，可与 Quicknode 现有的套餐相辅相成。运行生产工作负载的团队可从 Quicknode 的标准套餐中获益，这些套餐包含服务水平协议（SLA）、专属支持以及基于信用的计费方式。对于那些优先考虑轻量级、无许可访问的使用场景，x402 提供了一种新的选择。

本文将介绍什么是 x402、它如何与 Quicknode 配合使用、可以用它构建什么，以及如何入门。

什么是 x402？

x402 是由 Coinbase 开发的一种开放式支付协议，旨在为 HTTP 提供原生支付功能。它重新启用了长期预留的 HTTP 402“需要支付”状态码，并将其转变为互联网上的一个可运行的支付层。

该概念非常简单：当客户端向支持 x402 的端点发送未包含支付信息的请求时，服务器会返回 402 状态码，并附上支付说明（价格、支持的代币、网络及钱包地址）。客户端签署一份 USDC 支付授权，将其附加到请求头中，然后重试。服务器通过中介机构验证支付，在链上完成结算，并返回所请求的数据。

这对 AI 代理而言尤为重要。传统的支付系统需要人工完成注册、凭证管理和计费周期等操作，而 x402 则彻底消除了这些环节。拥有钱包的代理无需任何人工干预，即可自主发现、支付并使用 API 服务。

Quicknode 为何支持 x402

Quicknode 为开发者和企业提供覆盖 80 多条链和 130 多个网络的区块链基础设施。访问该基础设施通常需要创建账户并管理 API 密钥，这对开发生产级应用的团队来说非常适用。

x402 为一个日益壮大的用户群体提供了额外的访问途径：AI 代理、快速原型设计者，以及希望在确定计划前先进行测试的开发者。在 Quicknode 端点上启用 x402 后，任何拥有钱包的人（或任何实体）都可以：

• 访问覆盖130多个区块链网络的RPC、WebSocket、REST和gRPC端点

• 采用USDC支付的按请求付费模式，基于信用额度扣减机制。只需一次性充值账户余额，每次请求都会自动从您的信用额度中扣减，因此不会产生每次调用时的支付延迟。

• 使用基于钱包的身份验证（Sign-In with X / SIWx）进行身份验证，同时支持 EVM 和 Solana 钱包

• 使用 devnet USDC，最多可获得 10,000 次免费请求，立即开始体验

支付网络与您进行查询的终端是解耦的。这意味着，您可以在 Base 上使用 USDC 支付并调用 Solana 合约，也可以使用 Solana 上的 USDC 支付并查询以太坊，或者使用 Polygon 上的 USDC 支付。支付所用的链无需与查询所用的链一致。

x402 与标准 Quicknode 套餐对比

x402 属于补充方案，并不取代 Quicknode 的标准套餐。拥有生产环境工作负载的团队应继续使用标准 SLA 套餐、专属支持服务以及更高的速率限制。

支持的支付网络

Quicknode 的 x402 实现目前支持在以下平台上进行 USDC 支付：

• Base（主网和Sepolia测试网）

• Solana（主网和开发网）

• Polygon（主网和Amoy测试网）

目前正在积极增加新的支付网络。x402协议在设计上不依赖特定区块链，因此随着新服务提供商上线，扩展支持非常简单。

为了进行测试，开发者可以在 Base Sepolia、Solana 开发网或 Polygon Amoy 上使用 devnet USDC，向 Quicknode 的任何生产端点发起最多 10,000 次免费请求。

工作原理：技术流程

当代理或开发者向 Quicknode 发送一个支持 x402 的请求时，其底层处理过程如下：

1. 初始请求：客户端 向 Quicknode x402 端点发送一个不包含支付头信息的 HTTP 请求。

2. 402 响应：服务器 返回 HTTP 402 状态码，并附带一个包含支付详情的 PAYMENT-REQUIRED 标头：每次请求的费用、接受的代币（USDC）、支持的网络（Base、Solana、Polygon）以及支付的钱包地址。

3. 钱包身份验证：客户端 使用 SIWx（Sign-In with X）进行身份验证。Quicknode 的实现利用 SIWx 签发 JWT 令牌，通过避免每次请求的签名验证开销（这会使每次调用增加 10-20 毫秒），从而优化了性能。

4. 支付授权：客户端 使用 EIP-3009（适用于 EVM）或等效的 Solana 签名方法签署 USDC 转账授权。对于客户端而言，这是一项无需支付 gas 费的操作。

5. 使用支付信息重试：客户端 在 X-PAYMENT 头中包含已签名的支付信息，并重试原始请求。

6. 验证与结算：协调员 验证已签署的授权书，在链上完成USDC转账，并确认付款。

7. 响应：Quicknode 返回了请求的数据。

x402 客户端库会自动处理第 2 至第 6 步。从开发者的角度来看，该代码看起来就像是一个标准的 HTTP 请求。

你可以制作什么

具备自主区块链访问权限的AI代理

最直接的应用场景是让 AI 代理无需预先配置的 API 密钥即可与区块链数据进行交互。一个代理可以：

• 查询跨链代币价格和投资组合余额

• 监控钱包活动和交易记录

• 为 DeFi 协议执行区块链读取操作

• 访问历史区块数据以供分析

这一切都无需用户事先注册账户。

用于人工智能辅助基础设施管理的 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

面向人工智能编程代理的区块链技能

Quicknode 还提供了“Blockchain Skills”——一个轻量级的参考包，可为 AI 编码代理提供关于 Quicknode 全系列产品的准确、最新的知识。只需一条命令，即可将其添加到 Claude Code、Cursor、Codex、Windsurf 或任何支持技能的代理中：

npx skills add quicknode-labs/blockchain-skills

该技能仅需约 240 个令牌，即可为您的智能代理提供正确的端点、准确的参数以及最新的最佳实践，同时不会使上下文窗口过于臃肿。该项目在github.com/quicknode-labs/blockchain-skills上完全开源。您可以在技能注册表skills.sh/quicknode-labs/blockchain-skills上浏览该技能。

按请求付费的开发与原型设计

希望在多条链上测试创意的开发者，可以使用 x402 访问 Quicknode 支持的任何网络，而无需绑定任何套餐。只需快速搭建一个原型，为实际发起的 RPC 调用支付几美分（USDC），然后继续下一步工作即可。

Quicknode 的管理 API 提供了对您的账户和基础设施配置的全面程序化控制，使代理商和开发人员能够通过简单的 REST 调用创建端点、管理安全设置并监控使用情况。

带 x402 的 HyperCore CLI

Quicknode 的开源 HyperCore CLI 工具还支持 x402 按请求付费访问模式。开发者可以直接从终端流式读取并补全 Hyperliquid 数据集（交易、订单、成交、TWAP、订单簿更新、事件、大宗交易），并通过钱包按请求付费，无需 Quicknode 账户。

全局安装：

npm install -g @quicknode/hypercore-cli

该命令行界面（CLI）支持通过 WebSocket 和 gRPC 进行实时流传输，具备带缺口恢复功能的自动重连、历史数据补全功能，并可将数据导出为 JSON、CSV 或 SQLite 格式。

内容与API变现

除了使用支持 x402 的服务外，开发人员还可以利用 Quicknode 的开源工具构建自己的基于 x402 的 API：

• x402-rails:一个用于在 Rails 应用程序中添加 x402 付费墙的 Ruby gem

• 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

致 Solana 用户： 该 @quicknode/x402-solana npm 封装 @quicknode-x402 并增加了使用 Solana 工具包 立即使用 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 的钱包或 Solana 钱包）

• 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. 或者从 Solana 水龙头获取 Solana 开发网的 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 的集成： 将 x402 集成到 Ruby on Rails API 中的指南

• x402 付费墙指南： 关于实施 x402 的全面指南

• llms.txt： 用于大型语言模型（LLM）和智能体可发现性的机器可读 文档。该协议本身是开源的，由 Coinbase 在github.com/coinbase/x402上维护

• @quicknode/x402 软件包：

常见问题解答

Quicknode 上的 x402 是什么？

Quicknode 上的 x402 是一项 Alpha 级功能，支持通过 USDC 实现基于钱包认证的按请求付费访问 Quicknode 端点（RPC、WebSocket、REST 和 gRPC）。该功能采用 HTTP 402“需要支付”标准，并基于 Coinbase 的开源 x402 协议构建。

x402 是否会取代 Quicknode 的账户或套餐？

x402 方案属于补充型方案。它与 Quicknode 的标准方案并行，提供了一条互补的访问路径。运行生产工作负载的团队应继续使用标准方案，以获取服务水平协议（SLA）、专属支持以及更高的速率限制。x402 方案专为 AI 代理、快速原型开发和无许可访问而设计。

使用 x402 是否需要一个 Quicknode 账户？

No. x402 的访问需通过钱包验证。您需要一个加密货币钱包和 USDC，而非 Quicknode 账户或 API 密钥。

支持哪些支付网络？

目前，Base（主网和Sepolia测试网）、Solana（主网和开发网）以及Polygon（主网和Amoy测试网）均支持USDC支付。更多支付网络正在陆续添加中。支付网络无需与您查询的链保持一致。

AI 代理能否自主使用 x402？

是的。x402 专为自主代理访问而设计。拥有充值钱包的代理无需任何人工干预，即可发现、认证、支付并使用 Quicknode 端点。

x402 是否已准备好投入生产？

Quicknode 上的 x402 目前处于 Alpha 测试阶段。该服务功能正常且可供使用，但并不提供与标准 Quicknode 套餐相同的 SLA 保障。对于需要正常运行时间保障和专属支持的生产环境工作负载，请使用标准 Quicknode 套餐。

每次请求需要多少钱？

按请求计费的费用极低，且以USDC为单位。开发者可以使用开发网（devnet）中的USDC免费进行测试，该网络提供最多10,000次针对生产环境RPC端点的免费请求。

支持哪些钱包进行身份验证？

任何兼容 EVM 的钱包或 Solana 钱包。身份验证采用 SIWx（Sign-In with X），该机制同时支持 EVM 和 Solana 钱包的签名。

技术摘要

资源

• 指南： 通过 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 生态系统：

Quicknode 为开发者和企业提供覆盖 80 多条链和 130 多个网络的区块链基础设施。您可以选择标准套餐开始使用，或通过 x402 按请求付费模式立即访问端点。