x402-development
基于x402协议的链上微支付开源工具包
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:x402-development。 它的用途是:基于x402协议的链上微支付开源工具包 完整的 Skill 内容见:https://321skill.com/skills/x402-development-x-8/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我用x402协议为我的AI绘画API添加按次付费功能,用户支付0.01 ETH即可调用一次。' AI会生成集成x402的代码示例,包括设置支付端点、验证交易、返回内容等。例如在Node.js中引入x402 SDK,定义路由,当收到请求时返回402并附带支付要求,用户钱包签名后验证交易再返回图片。
介绍
x402-development 是一个实现 HTTP 402 Payment Required 标准的开源协议工具包,旨在解决互联网原生支付场景中账户注册繁琐、API 密钥管理复杂、微支付成本高等问题。它允许开发者直接通过区块链进行按需付费,无需用户注册账户或申请密钥,只需钱包签名即可完成支付。
使用方式灵活:提供 TypeScript、Python、Go 三种语言的 SDK,覆盖 EVM、Solana、Stellar、Aptos、NEAR、XRPL 等多条链。开发者可以在付费 API、付费墙内容、AI 代理支付流程、MCP 工具等场景中集成,只需在返回 HTTP 402 状态码时附带支付要求,用户端自动发起链上交易,验证通过后即可获取资源。
适合后端开发、全栈开发、智能体开发者,尤其是需要为 AI 模型调用、数据接口、内容订阅等场景构建按次付费机制的项目。无论是个人开发者还是团队,都能快速实现无账户、无中间商的直接支付流程。
建议先阅读协议文档理解 402 响应格式,再根据目标区块链选择对应 SDK。注意链上交易确认时间(如以太坊约 10-15 秒)会影响用户体验,高频小额支付可考虑 Layer2 或高性能链。同时需确保用户钱包有足够余额支付 gas 费。
核心特点
区别于传统支付 SDK(如 Stripe、支付宝),x402 无需注册商户账户、无需申请 API 密钥,直接利用 HTTP 402 状态码和区块链签名实现点对点微支付,特别适合去中心化、AI 代理自动支付等场景。
注意事项
不适合对实时性要求极高的支付场景(如线下扫码支付),因为链上交易确认存在延迟;且要求用户必须持有加密货币钱包并承担 gas 费用。
常见问题
使用 x402 需要注册账户吗?
不需要,直接使用加密货币钱包签名即可,无需注册任何账户或申请 API 密钥。
支持哪些区块链?
支持 EVM(以太坊、Polygon 等)、Solana、Stellar、Aptos、NEAR 和 XRPL。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/x402-development-x-8/raw/index.md 读取 x402-development 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/x402-development-x-8/raw/index.md(查看排版版本)