订阅 wiki
Share wiki
Bookmark
x402
x402
x402 是由 Coinbase 开发的开源支付协议，构建于 HTTP 标准之上。它利用历史上处于休眠状态的 402 Payment Required 状态码，以实现互联网原生的、机器对机器的微支付，使用链上资产如 稳定币。
概述
x402 协议旨在解决传统在线支付系统（如信用卡和银行转账）中存在的效率低下问题，这些系统通常具有高摩擦、结算时间慢以及不适合程序化或自动化交易的特点。 [8] 该项目的核心理念是，互联网上的支付应该像信息的 flow 流动一样无缝和原生。它旨在创建一个支付轨道，人类用户和自主 AI 代理 都可以同样访问，从而促进 API 调用、数据访问和云计算等数字资源的按次付费经济。 [6] [1]
Coinbase 将该协议定位为“修复互联网的第一个错误”的一种方式，认为传统的支付轨道是为“互联网前时代”构建的，速度慢、成本高且地域限制。 [8] 该协议复活了实验性的 HTTP 402 状态代码，以创建一个互联网原生的支付系统，将 稳定币 支付直接嵌入到 Web 交互中。随着机器对机器交互和 AI 驱动服务的兴起，该协议旨在提供一个即时、可编程、可互操作且信任最小化的支付层。 [9]
该协议被设计为一个开放标准，以防止依赖任何一方。它是链
- 和代币无关的，允许扩展到新的 区块链 网络和数字资产。通过直接集成到标准的客户端-服务器 HTTP 请求 flow 流程中，它避免了对单独的支付接口或复杂的用户身份验证过程（如 OAuth）的需求。x402 的灵感来自 Balaji Srinivasan 在 21.co 早期对加密微支付的研究，而最近 Base 等低成本 Layer 2 区块链的出现使这一概念在经济上更可行。 [7]
在协议的公告中，Coinbase 开发者平台工程主管 Erik Reppel 表示：“就像 HTTPS 保护了 Web 一样，x402 可以定义互联网的下一个时代；一个价值像信息一样自由和即时流动的时代。我们正在为不仅由人，而且由软件运行的经济奠定基础——自主、智能且始终在线。” [7] [8] 该协议强调信任最小化，支付方案旨在防止中介机构滥用客户的资金。它还优先考虑开发人员的易用性，旨在通过“一行”集成来 abstract 掉与加密相关的复杂性，如 gas 费用和 RPC node 管理。 [6]
历史
x402的开发由Coinbase开发者平台主导，该项目的白皮书由Erik Reppel、Ronnie Caspers、Kevin Leffew、Danny Organ、Dan Kim和Nemil Dalal撰写。 [2]
其早期历史的关键里程碑包括：
- 2025年2月27日： 该项目的Apache-2.0许可文件在其官方仓库中创建，标志着一个早期的基础性步骤。
- 2025年4月25日： 一个重要的提交建立了核心TypeScript生态系统，包括用于Express、Next.js和Hono等框架的多个npm模块。
- 2025年5月6日： Coinbase公开宣布推出x402开放标准并发布其官方白皮书。该公告包括协议的详细信息、其随附工具以及启动合作者的列表。 [8]
- 2025年6月13日：
ROADMAP.md和PROJECT-IDEAS.md文件被添加到仓库中，概述了协议的未来方向和潜在应用。 - 2025年8月30日： 添加了对Solana 区块链 (SVM) 的支持，展示了该协议超越其初始EVM焦点的多链能力。
这些事件说明了该项目从概念到公开发布的多链协议的进展。 [6] [7]
技术
x402协议直接构建于现有的HTTP框架中，利用标准状态码和标头来促进支付，而无需新的通信层。
核心机制
该协议的功能主要围绕 HTTP 402 Payment Required 状态码展开，该状态码在早期的 Web 标准中定义，但在过去 25 年多的时间里基本上未被使用。当客户端从启用了 x402 的服务器请求受保护的资源时，服务器可以返回 402 状态。此响应包含一个 JSON 主体，其中包含支付详细信息，例如所需金额、接收者地址以及接受的代币和区块链网络。然后，客户端使用此信息来构建、签名支付负载，并将其附加到后续的同一资源请求中。服务器在授予访问权限之前会验证此负载。整个过程发生在标准的请求-响应周期中。 [2] [3] [9]
架构
x402 架构涉及三个主要参与者：
- 客户端： 为资源付费的实体。这可以是 Web 浏览器、命令行应用程序或自主 AI 代理。客户端负责创建和签署支付负载。
- 资源服务器： 提供付费资源的 HTTP 服务器，例如 API 端点或数字文件。此服务器负责发出 402 质询并在满足请求之前验证付款。
- 协调服务器： 一个可选但推荐的第三方服务，用于处理链上支付验证和结算。通过卸载这些任务，资源服务器不需要维护直接的 区块链 连接、管理钱包或处理私钥，从而简化其运营要求。
这种架构允许关注点分离，资源服务器专注于提供其核心服务，而协调器处理 区块链 交互的复杂性。 [6]
协议流程
支付和资源访问过程遵循一系列明确的步骤：
- 初始请求：
client向resource server发送标准 HTTP 请求，以获取受保护的资源。 - 支付质询： 服务器返回 HTTP
402 Payment Required状态。响应正文包含一个 JSON 对象，详细说明了接受的支付方式，包括价格、货币和网络。 - 支付负载创建：
client选择一种支付方式，并使用其钱包创建并以加密方式签署支付负载。这通常使用 EIP-712 等标准来完成，以确保签名消息是人类可读的。 - 已支付请求：
client为同一资源发送新的 HTTP 请求，这次在自定义X-PAYMENT标头中包含已签名的支付负载。 - 验证：
resource server接收已支付的请求并验证支付负载。它可以在本地执行此操作，也可以将负载发送到facilitator server的/verify端点。 - 履行： 如果验证成功，
resource server将处理请求并生成资源。 - 结算：
resource server结算付款。这可以通过直接与 区块链 交互或将经过验证的负载发送到facilitator server的/settle端点来完成。 - 确认：
facilitator server将交易提交到 区块链，等待确认，并将结果（包括交易哈希）返回给resource server。 - 最终响应：
resource server向client发送200 OK响应，传递请求的资源。它还可以包含一个X-PAYMENT-RESPONSE标头，其中包含成功交易的详细信息。
此流程将支付直接集成到 Web 的原生通信协议中，使用自定义标头来管理交易，而不会改变 HTTP 的基本工作方式。 [6] [7] [9]
关键概念
- 方案 (Schemes): 转移资金的逻辑方法。该协议被设计为可扩展的，支持不同的方案。第一个提出的方案是
exact，用于转移特定的、预定义的金额。未来理论上的方案upto可用于根据资源消耗（例如 LLM 令牌生成）支付高达一定金额的款项。 - 网络 (Networks): 该协议与区块链无关，通过支持
(方案, 网络)对来运作，例如在 以太坊 或 Solana 上的exact支付。 - 促进者 API (Facilitator API): 促进者服务器公开了一个简单的 API 来协助资源服务器。关键端点包括
POST /verify以验证支付负载，POST /settle以将支付提交到 区块链，以及GET /supported以列出促进者支持的支付方案和网络。
这些概念为互联网原生支付提供了一个灵活且可扩展的框架。 [6] [3]
Bazaar Discovery Layer
x402 Bazaar 是协议生态系统的发现层，Coinbase 将其描述为“代理搜索引擎”，也是代理商务的第一个发现层。它作为一个去中心化的开放网络运作，服务器通过托管机器可读的 x402.json 清单文件（通常位于 .well-known/x402.json 路径）来宣传其付费服务。该文件列出了可用的资源、API 端点、定价详情和接受的付款方式，为 AI 代理 创建了一个市场，使其能够自主发现和支付 API 的费用，而无需人工干预。该系统的主要目的是解决 AI 的工具发现问题，使代理能够动态地查找和使用添加到生态系统中的新服务。这解锁了一种新型的自我改进、自适应代理，它们可以随着可用工具网络的增长而不断发展能力，从而使它们能够执行复杂的多步骤任务，例如研究数据、委托 AI 生成的艺术品或自动预订服务。 [4] [5] [6]
与传统系统的比较
x402 与传统支付轨道
x402 的设计与 Visa、Stripe 和 PayPal 等传统在线支付系统有着根本的区别。虽然传统系统以平台为先，以人为本——需要登录、用户帐户和手动步骤——但 x402 以协议为先，针对机器对机器的交互进行了优化。主要区别包括：
- 结算时间： x402 支付可以通过链上交易在几秒钟内完成结算，而传统的 轨道 通常需要一到三个工作日。
- 微支付： 该协议支持小到几美分的分数支付，这在信用卡网络上由于高额固定费用是不可行的。
- 全球访问： 作为一个加密原生协议，x402 在设计上是全球性的，不需要货币兑换或区域银行关系。
- 开销： 它旨在通过利用链上转账的不可变性，几乎消除退款、欺诈风险和中介费用。
- 集成： 传统系统需要与中心化处理器进行复杂的集成，并且通常涉及重定向。x402 将支付直接嵌入到 HTTP 协议中，无需单独的接口。
这种结构支持一种原生于互联网架构的后端到后端货币化模型。 [9]
人工智能支付的现有方法
主要的支付巨头也开始探索人工智能驱动的和稳定币的支付方式。Visa 宣布了人工智能代理进行购买的计划，Stripe 推出了稳定币金融账户，PayPal 推出了自己的稳定币（PYUSD）并附带奖励计划。然而，这些努力都在中心化的“围墙花园”生态系统中运作。他们的服务是许可制的，受公司政策管辖，并且需要注册和平台批准。相比之下，x402 是一个开放且无需许可的协议，允许任何开发者集成它，而无需商家帐户或批准。封闭服务和开放协议之间的这种区别是 x402 创建更分散、由代理驱动的经济的目标的核心。 [9]
货币化和费用
x402协议本身是一个开放标准，不向商家或客户收取任何费用。它可以免费实施和使用。但是，使用该协议进行的交易需要支付底层区块链的标准网络费用（gas费）。通过利用低成本的Layer 2网络，这些费用可以忽略不计，使得低至0.001美元的小额支付在经济上可行。这种模式与传统的支付系统形成对比，后者通常包括固定费用加上交易价值的百分比。 [1] [2]
USDC等稳定币在该协议的功能中起着核心作用。它们的价格稳定性允许代理和开发者以可预测的单位进行交易，而无需承担加密货币市场波动的风险。此外，Base或其他Layer 2等高速链上的稳定币提供快速的最终性，转账在几秒钟内确认，费用极低，非常适合x402旨在处理的高频率、低价值交易。 [9]
使用案例
该协议旨在为数字经济实现新的货币化模型，特别是对于程序化和自动化系统。
AI 代理经济
x402 的主要重点是为“代理商务”提供支付层，使自主人工智能代理无需人工干预即可进行交易。这使得代理能够在执行任务时按需支付资源费用，从而将它们从需要持续人工交互的工具转变为自主的经济参与者。 [8]
- 自主计算： 代理可以按每次推理或每秒使用量支付 GPU 资源或云服务费用。
- 数据获取： 代理可以自主购买对实时市场数据、专有数据集或来自高级来源的文章的访问权限，按每次查询付费。
- 自动化工作流程： 代理可以通过支付物流 API 来管理供应链，在预测市场中下注，或获取数字资产作为更大的自动化策略的一部分。
NEAR 的联合创始人 Illia Polosukhin 对此潜力发表评论：“我们的愿景是将 x402 的无摩擦支付与 NEAR intents 相结合，使用户能够放心地通过其 AI 代理购买任何东西，同时代理开发者可以通过跨链结算来收取收入，从而使 区块链 的复杂性变得不可见。” [7]
代理支付
“代理支付”是x402用例的核心概念。这些是由软件代理而非人类自动进行的支付，其特点是快速、可编程且通常价值较低。传统的支付基础设施并非为此而设计，因为它需要手动步骤、费用高且结算时间慢，因此不适合自主、高频的交易。代理支付对于实现机器优先的经济至关重要，它通过消除访问付费服务的摩擦来实现实时AI决策，并为可组合服务铺平道路，使代理可以自主地将付费API链接在一起。 [9]
开发者和内容货币化
x402为开发者和创作者提供了订阅模式或广告支持之外的替代收入模式。
- 付费API： 开发者可以通过微支付来货币化每个API调用，实现真正的按需付费模式，而不是分层订阅计划。
- 软件和内容解锁： 该协议可用于按需、按次付费访问高级软件功能、新闻文章、视频或其他数字内容，无需订阅或信用卡最低消费。 [8]
- 计量服务： 云存储提供商或其他基础设施服务可以根据实际资源消耗进行计费，并以近乎实时的速度结算付款。
这些用例得益于该协议能够高效地处理小额、频繁的交易，而无需用户注册或输入信用卡信息。 [2] [3]
生态系统和采用
x402 作为一个开源项目启动，得到了 Coinbase 以及来自技术和 web3 行业的众多合作者的支持。
开发和支持
该协议是 Coinbase 开发者平台的一项倡议，其主要存储库由 GitHub 上的 Coinbase 组织维护。该标准采用 Apache-2.0 许可，鼓励广泛采用和社区贡献。官方开发者资源包括 GitBook 上托管的文档和一个用于使用 x402 构建 AI 应用程序的 Vercel 启动模板。 [6] [3]
实现
提供了官方库和SDK，以方便客户端和服务器应用程序在几种编程语言中进行集成：
- TypeScript（带有 Express、Next.js、Hono、Axios 和 Fetch 的特定包）
- Python
- Go
- Java
合作者和早期采用者
该项目于2025年5月6日启动，并宣布获得多个关键组织的支持。
- 启动合作者： AWS、Anthropic、Circle和NEAR。
- 早期采用者和构建者： 一批多元化的公司和项目在启动时开始使用x402进行构建，包括用于社交应用的Neynar和XMTP；用于代理交互的Anthropic和NEAR AI；以及用于实时数据演示的Chainlink。
Circle的产品管理副总裁Gagan Mac评论说，x402“优雅地简化了实时货币化”，并解锁了“令人兴奋的新用例，例如AI代理和应用程序的微支付”。[8] 早期采用者Neynar的创始人Rish Mukherji指出该协议的实用性：“x402将Neynar的Farcaster API变成了一种纯粹的按需实用程序——代理可以准确地提取他们需要的数据，在同一个HTTP 402往返中以USDC结算，并完全跳过API密钥或预付费层。” [7]
与 Vercel 的 MCP 集成
在 2025 年 9 月，Vercel 宣布了 x402-mcp，这是一个旨在将 x402 支付协议与模型上下文协议 (MCP) 和 Vercel AI SDK 集成的库。此合作解决了 AI 代理 需要访问付费外部服务而无需手动设置（例如管理 API 密钥和单独计费）的挑战。该集成允许开发人员在其 MCP 服务器中定义 paidTool，并为每次工具调用指定价格。当 AI 代理需要使用其中一个工具时，x402-mcp 库会使用 x402 促进每次调用的付款。这创建了一个自我维持的生态系统，开发人员可以直接通过其工具获利，并且 AI 代理 可以自主发现、授权付款并利用越来越多的功能，而无需预先存在的商业关系。[7]
发现错误了吗？