核心用法
agent-wallet 是专为 AI 代理设计的自托管 Bitcoin Lightning 钱包，由 MoneyDevKit 开发。通过单一命令即可初始化，无需 API 密钥、注册或账户体系。核心功能包括：
- 钱包初始化：
npx @moneydevkit/agent-wallet init生成 BIP39 助记词，创建本地配置 - 余额查询：
balance返回以 satoshi 为单位的余额 - 收款：支持固定金额/可变金额发票（
receive）、BOLT12 可复用报价（receive-bolt12） - 付款：自动识别 bolt11、b bolt12、LNURL、闪电地址等多种格式
- 本地守护进程：在
localhost:3456运行 HTTP 服务，轮询入账支付
显著优点
1. 完全自托管：私钥（助记词）仅存本地，无第三方托管风险
2. 零配置设计：一条命令启动，无需 Lightning 节点运维知识
3. 多标准兼容：覆盖 BOLT11/BOLT12/LNURL/闪电地址全生态
4. JSON 输出：所有命令返回结构化数据，便于代理程序解析
5. Agent-to-Agent 支付：代理间可直接通过对等网络完成价值转移
潜在缺点与局限性
- 安全责任自负：助记词丢失即资金永久丢失，无恢复途径
- 单点故障：本地守护进程若崩溃，支付轮询将中断
- 网络依赖：需 outbound 连接至 MDK Lightning 基础设施
- Node.js 依赖：要求目标环境预装 node/npx
- 文件系统风险：助记词明文存储于
~/.mdk-wallet/config.json，需严格权限控制
适合人群
- 需要自主收款/付款能力的 AI 代理开发者
- 追求非托管、抗审查支付方案的自动化系统
- 已具备 Node.js 运行环境的边缘计算或服务器场景
- 愿意承担密钥管理责任的进阶用户
常规风险
| 风险类别 | 描述 | 缓解建议 |
|---------|------|---------|
| 密钥泄露 | 助记词文件权限不当或被恶意读取 | `chmod 600 ~/.mdk-wallet/` 并定期备份至离线介质 |
| 供应链攻击 | npm 包被篡改 | 生产环境锁定版本号（如 `@0.11.0`），验证源码签名 |
| 资金损失 | 误删钱包目录或助记词遗忘 | 初始化后立即离线备份助记词 |
| 网络隔离 | 守护进程无法连接 MDK 基础设施 | 监控 `status` 命令，配置防火墙放行 outbound |
| 本地端口冲突 | `:3456` 被占用 | 启动前检查端口占用，或使用容器隔离 |