用途:帮助开发者从零完成一次成功的付费 API 调用——解析 CDP 托管钱包、包装 HTTP 客户端以自动响应 402、在测试网为钱包注资,并用 200 状态码验证。支持 TypeScript 与 Python。
主要能力:基于 x402 协议,用 CDP 托管钱包签名支付;提供 CdpX402Client,自动开户、注册支付方案并满足签名接口;支持 fetch、axios、httpx、requests 及 MCP 变体。
必要用法:写码前先确认 CDP_API_KEY_ID、CDP_API_KEY_SECRET、CDP_WALLET_SECRET 三项环境变量,并确认 Node.js 22+ 或 Python 3.10+。@x402/core、@x402/evm、@x402/svm、@x402/extensions 为可选 peer 依赖,即使用 EVM 也需全部安装。TypeScript 安装 @coinbase/cdp-sdk 及对应 @x402/fetch、@x402/axios 或 @x402/mcp;Python 安装 cdp-sdk 与 x402[evm,svm,httpx] 或 x402[evm,svm,requests]。示例命令:npm install @coinbase/cdp-sdk;pip install cdp-sdk。运行一次打印地址后,用 CDP 水龙头注资 Base Sepolia USDC,等待确认再重跑验证;HTTP 200 即成功。
适用场景:服务端代表用户付费调用受保护 API。
限制:若最终用户应用自己钱包支付,应改用 User Wallets 浏览器流程;若想不写代码让智能体花钱,应使用 agentic-wallet;若需自行构造签名或自定义重试则超出范围。网络默认 development(Base 测试网),除非用户明确要求,绝不切到 Base 主网以免花费真实 USDC。常见问题包括余额为空、同步与异步客户端混用、未注册网络方案等。其余细节暂未提供。