核心用法
eth-payment 是一款轻量级命令行工具,专注于生成符合 EIP-681 标准的以太坊支付链接与二维码。用户可通过简单命令快速创建支持 ETH 及主流 ERC-20 代币(USDC、USDT 等)的收款请求,覆盖 Base、Ethereum、Arbitrum、Optimism、Polygon 五条主流 EVM 链。
典型工作流程:
1. 安装依赖:pip install qrcode pillow
2. 生成支付链接:eth-payment create --to 0x... --amount 100 --token USDC --qr payment.png
3. 分享二维码或 EIP-681 链接,用户通过 MetaMask 等钱包扫码即可完成支付
工具内置 JSON 输出模式,便于开发者集成到自动化开票系统;同时提供地址验证、链信息查询等辅助功能。
显著优点
- 零配置启动:无需注册 API、部署服务器或管理密钥,本地运行即可完成全部功能
- 多链原生支持:预置 5 条主流公链代币配置,扩展新链仅需修改 JSON 配置文件
- 离线可用:二维码通过 Python
qrcode库本地生成,无第三方图像服务依赖 - 钱包兼容性:生成的 EIP-681 链接可直接被 MetaMask、Rainbow、Coinbase Wallet 等主流应用识别
- 开发者友好:结构化 JSON 输出包含完整交易数据(to/value/data),便于程序化调用
潜在缺点与局限性
- 仅生成不执行:工具本身不具备交易签名能力,收款方仍需依赖外部钱包完成最终确认
- 代币配置静态化:新增代币需手动编辑
config/chains.json,无法实时同步链上合约 - 无支付状态回调:缺乏交易确认监听机制,需自行集成区块浏览器 API 或节点服务验证到账
- CLI 交互局限:无图形界面,对非技术用户存在使用门槛
适合人群
- 开发者快速搭建捐赠页、会员支付等轻量级加密收款场景
- DAO 财运营造无需后端的发票生成工具
- 线下商户打印静态二维码接受稳定币付款
常规风险
- 地址欺诈风险:生成的二维码/链接中的收款地址可能被恶意替换,需通过可信渠道分发
- 链网络错配:用户可能将资产发送至错误链的同名合约地址导致永久损失
- 金额精度问题:不同代币小数位差异(如 USDC 6 位 vs ETH 18 位)需仔细核对