概述
balance-management 是一款专为 Routstr API 设计的账户余额管理工具，集成了比特币 Lightning Network 和 Cashu 协议，为用户提供完整的资金管理解决方案。
核心功能
1. 余额实时监控：查询当前 Routstr 账户余额（同时显示 satoshi 和 BTC 单位），并展示累计消费金额与请求次数统计。
2. Lightning 发票充值：通过 create_invoice.sh 创建指定金额的 Lightning 发票，利用比特币闪电网络实现即时、低成本的充值。
3. 发票状态追踪：使用 invoice_status.sh 实时查询发票支付状态，确保资金到账透明可验证。
4. Cashu 代币充值：支持通过 topup_cashu.sh 使用 Cashu 协议（eCash 协议）进行余额充值，提供额外的隐私保护支付选项。
显著优点
- 多单位显示：自动转换 satoshi 与 BTC，适应不同用户习惯
- 双轨支付：同时支持 Lightning 发票和 Cashu 代币，兼顾效率与隐私
- 轻量脚本：基于 shell 脚本，无需复杂依赖，易于审计
- 配置分离：API 凭据存储于独立配置文件，支持多环境管理
潜在局限
- 生态依赖：完全依赖 Routstr API 服务可用性
- 链上确认：发票支付需等待网络确认，极端网络拥堵时可能延迟
- 配置风险：敏感信息存储于本地 JSON 文件，需自行确保文件权限安全
- Cashu 认知门槛：Cashu 协议相对新颖，部分用户可能不熟悉其使用方法
适合人群
- Routstr API 付费用户
- 偏好比特币/Lightning 支付的开发者
- 注重支付隐私的技术用户
- 需要程序化账户管理的自动化场景
风险提示
⚠️ 资金风险：务必核对发票金额与收款地址，错误操作可能导致资金损失
⚠️ 密钥管理：~/.openclaw/openclaw.json 包含敏感 API 密钥，请设置 600 权限并避免版本控制
⚠️ 发票时效：Lightning 发票存在有效期，超时未支付需重新创建