用途:该技能用于在 Node.js/Express 应用或 Model Context Protocol(MCP)服务器中快速加入 x402 付费墙,让每次 API 调用都要求通过 Base L2 支付 USDC 微支付,从而实现按调用计费。
主要能力:提供 X402Wrapper 封装与 requirePayment 中间件,可按路由设置费率;中间件放行时表示款项已结算入账,可通过 req.paymentTx 获取交易回执。客户端需在 Payment-Signature 头中发送 Base64 编码的 JSON,结构为 { from, validAfter, validBefore, nonce, signature }。
使用方式:安装依赖 npm install x402-express ethers;引入 express 与 x402-express,实例化 X402Wrapper 时传入 rpcUrl(如 https://mainnet.base.org)、privateKey(RELAYER_PRIVATE_KEY,必填)与 recipient(MY_WALLET_ADDRESS,必填,作为净收益地址);在路由上使用 x402.requirePayment("20000"),其中 amountRaw 为 6 位小数的 USDC,"20000" 即 0.02 美元。
架构说明:该封装承担 Relayer 角色,由服务器自身调用 M2MCentEscrow.settle() 在链上结算,因此 RELAYER_PRIVATE_KEY 必须持有 Base L2 的 ETH gas;消费 API 的客户端支付 0 gas。v1.1+ 中 escrowAddress 已硬编码,注入外部合约地址会报错。
适用场景:为新建微 SaaS、API 或 MCP 服务器添加付费门槛,要求以 USDC 微支付使用端点。
限制:需要有效的环境变量(RELAYER_PRIVATE_KEY、MY_WALLET_ADDRESS)及 Base L2 gas 余额;仅覆盖 x402 封装/中间件,不含完整基础设施加固与生产密钥管理;面向 Node.js/Express,其他运行时或框架需额外适配。其他细节暂未提供。