核心用法
agent-wallet 是一款专为 AI 代理设计的自托管比特币闪电网络（Lightning Network）钱包工具，由 MoneyDevKit 开发。它采用极简的零配置设计，一条命令即可完成钱包初始化，所有操作输出均为 JSON 格式，便于程序化集成。
快速启动流程：
1. 运行 npx @moneydevkit/agent-wallet init 生成 BIP39 助记词并创建配置
2. 本地守护进程自动在 localhost:3456 启动 Lightning 节点
3. 使用 balance 查余额、receive 生成收款发票、send 付款
支持协议：
- BOLT11：传统一次性发票
- BOLT12：可重复使用的静态报价（offer），付款方自定金额
- LNURL 与 闪电地址（如
user@getalby.com）：人类友好的收款标识
该工具完全自主托管（self-custodial），代理持有自己的私钥，无需注册账户或 API 密钥。
显著优点
1. 真正的自托管架构：BIP39 助记词本地生成并存储于 ~/.mdk-wallet/config.json，用户完全掌控资金，无第三方托管风险
2. 零配置体验：单条命令初始化，自动启动本地守护进程，无需手动设置 Lightning 节点或端口转发
3. 多协议兼容：原生支持 BOLT11/12、LNURL、闪电地址，覆盖 Lightning 生态主流付款场景
4. 代理间支付原生支持：专为 AI 代理设计，任何安装该工具的代理可直接向其他代理的发票或闪电地址付款
5. JSON 化输出：所有命令返回结构化数据，易于脚本化和 AI 代理集成
6. 无外部依赖：除 Node.js 环境外，无需额外基础设施（如 webhook 服务器）
潜在缺点与局限性
1. 单点密钥管理风险：助记词以明文形式存储于本地文件系统，若文件权限设置不当或系统被入侵，资金面临被盗风险
2. 守护进程本地绑定限制：HTTP 服务仅绑定 localhost:3456，无法直接用于需要外部回调的某些 Lightning 场景（如某些 LNURL-auth 流程）
3. MDK 基础设施依赖：出站连接依赖 MoneyDevKit 的 Lightning 基础设施，若该服务中断可能影响支付路由
4. 无多签或社交恢复：当前实现为标准单签钱包，无私钥分片或恢复机制，助记词丢失即资金永久丢失
5. Node.js 环境依赖：必须在支持 node 和 npx 的环境中运行，限制了部分边缘计算场景
6. 版本锁定建议：生产环境需手动锁定版本（如 @0.11.0），@latest 可能引入未预期变更
适合人群
- AI 代理开发者：需要为代理赋予自主收发比特币能力的开发者
- 自动化支付场景：机器对机器（M2M）支付、按使用付费（pay-per-use）API、代理服务结算
- Lightning 实验者：希望快速体验 Lightning Network 而无需运行完整节点的用户
- 隐私敏感用户：偏好自托管、无需 KYC/注册账户的比特币支付方案
常规风险
| 风险类别 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| **密钥泄露** | `~/.mdk-wallet/config.json` 包含 BIP39 助记词，文件权限不当可导致资金被盗 | 严格设置目录权限（`chmod 700`），定期备份助记词至离线安全存储 |
| **主网资金风险** | 默认连接比特币主网，操作涉及真实价值转移 | 小额测试后再大额使用，确认 `network` 配置 |
| **守护进程安全** | 本地 HTTP 服务若通过代理暴露至公网，可能被恶意利用 | 确保仅绑定 `localhost`，禁止外部网络访问 `:3456` |
| **供应链攻击** | npm 包可能被篡改或依赖恶意子依赖 | 生产环境锁定版本，审计 `package.json` 依赖树，验证发布者签名 |
| **服务中断** | MDK Lightning 基础设施故障可能影响支付成功率 | 监控支付状态，准备备用支付通道方案 |
| **助记词丢失** | 无恢复机制，丢失助记词即永久丢失资金 | 多重备份（物理纸质、硬件安全模块），定期验证备份有效性 |