SuperAPI AI 工具集

walletconnect-pay

办公与效率

查看项目

更新于 10-16 04:30

技能介绍

用途:通过 walletconnect-pay CLI 在终端创建支付、查询支付状态,并用已连接钱包完成结账流程。适用于用户要求创建 WalletConnect Pay 支付、查询支付状态、用钱包付款或端到端完成支付;不适用于仅需基础钱包连接(用 walletconnect 技能)、质押 WCT(用 walletconnect-staking 技能)或修改 pay-cli 源码。

主要能力:status 只读显示金额、商户、状态与过期时间;create 创建支付,金额以最小单位计(1000 = $10.00);checkout 执行完整流程:获取支付、连接钱包、获取支付选项、签名交易、提交合规数据、确认并轮询结果。

使用方式:二进制位于 packages/pay-cli/dist/cli.js,或全局链接为 walletconnect-pay;必要时先构建:npm run build -w @walletconnect/pay-cli。认证分两种:代理模式(默认,未设置 WC_PAY_WALLET_API_KEY 或传 --proxy 时自动走前端代理,无需 API 密钥);直连 API 模式需设置 WC_PAY_WALLET_API_KEY,商户操作还需 WC_PAY_PARTNER_API_KEY 与 WC_PAY_MERCHANT_ID。常用命令:walletconnect-pay status <paymentId>;walletconnect-pay create <amount>;walletconnect-pay checkout <paymentId>。create 支持 --unit(默认 iso4217/USD)、--reference-id;checkout 支持 --wallet、--name、--dob、--pob-country、--pob-address,Travel Rule 数据也可用环境变量 WC_PAY_NAME、WC_PAY_DOB、WC_PAY_POB_COUNTRY、WC_PAY_POB_ADDRESS 设置。各命令均支持 --staging 与 --proxy。

适用场景与限制:该 CLI 为实验性,API 与接口可能大幅变动,风险自负。checkout 需已安装并连接 CWP 钱包,且需用户在钱包应用中批准签名,建议超时 60 秒以上。部分支付要求 Travel Rule 信息采集,缺少 --name、--dob、--pob-country、--pob-address 时会报错。--staging 用于测试,生产为默认。