SuperAPI AI 工具集

build-x402-server

编程与开发

查看项目

更新于 10-15 20:13

技能介绍

用途:把未受保护的 HTTP 路由改造成按次收费的 x402 服务,收到真实 USDC 并结算到 CDP 管理的钱包。不适用于通过 Coinbase Business 售卖、为 MCP 工具收费、作为付款方,或想要零代码变现服务的场景。

主要能力:先按决策表确定语言、框架、接线方式、路由配置来源、收款钱包、网络与计费方案(固定价用 exact,按量用 upto),再只读对应语言与框架小节。TypeScript 用 createX402Server 自动准备收款钱包、接入 CDP Facilitator、注册方案与扩展;已有 x402 服务可只替换 facilitator 为 createCdpFacilitatorClient();路由可内联或放在 x402.config.json。Next.js 需在独立模块构建 server 再导入。Python 无 createX402Server,需手动组装 CDP 钱包与 x402 中间件,FastAPI 用 PaymentMiddlewareASGI,Flask 用同步版与 payment_middleware。

使用方式:先确认 CDP_API_KEY_ID、CDP_API_KEY_SECRET、CDP_WALLET_SECRET 与运行时(Node.js 22+ 或 Python 3.10+)。安装示例:npm install express @coinbase/cdp-sdk @x402/core @x402/evm @x402/svm @x402/extensions @x402/express;Python 为 pip install "cdp-sdk" "x402[evm,svm,fastapi]" uvicorn。定价需明确收费路由、单价与一句话描述。用 curl -i http://localhost:8402/report 验证返回 402 与 PAYMENT-REQUIRED 头,再通过 pay-for-service 或 build-x402-client 完成真实支付。

限制:默认 development 使用测试网,省略 environment 即主网,未经用户当轮要求不得切主网;用户提供 payTo 需回显确认;只有配置中列出的路由受保护;Python 路径仅支持 EVM;模块级同步解析 PAY_TO 在 ASGI 事件循环下会报 RuntimeError,需改用 lifespan。