核心功能
agent-wallet 是 Anthropic MoneyDevKit 团队开发的自托管比特币闪电网络钱包，专为 AI 代理设计。通过单一 npm 命令即可初始化完整钱包功能，无需 API 密钥、注册或外部账户。核心能力包括：生成/解析闪电发票（bolt11/bolt12）、通过 LNURL 或闪电地址收付款、实时查询余额及完整支付历史。
显著优点
真正的自托管架构：钱包在本地生成 BIP39 助记词（12 词种子），派生私钥完全由代理掌控，非托管服务商模式。助记词存储于 ~/.mdk-wallet/config.json，资金控制权完全归属用户。
零配置即用：无需 Lightning 节点搭建、通道管理或 Tor 配置。npx @moneydevkit/agent-wallet init 单命令完成钱包初始化，本地守护进程自动在 :3456 端口启动 HTTP 服务，30 秒轮询处理入站支付。
多协议兼容：原生支持 bolt11（标准发票）、bolt12（静态报价单）、LNURL（可交互支付协议）及人类可读的闪电地址（如 user@getalby.com），覆盖 Lightning 生态主流支付场景。
JSON 原生接口：所有 CLI 命令返回结构化 JSON，便于代理程序解析；退出码 0/1 明确区分成功/失败状态。
潜在局限与风险
资金安全风险：助记词以明文形式存储于本地文件系统，依赖操作系统级文件权限保护（~/.mdk-wallet/）。若运行环境多用户共享或备份不当，存在私钥泄露风险。开发者明确警告："丢失助记词即丢失资金"，无恢复机制。
单点故障依赖：必须持续运行本地守护进程才能接收支付（轮询机制），进程崩溃或端口冲突将导致支付处理中断。当前版本无高可用或冗余设计。
网络信任假设：需出站连接至 MDK Lightning 基础设施（闭源后端），虽声称仅传输标准 Lightning 协议数据，但用户无法完全审计路由节点的资金通道流动性或审查行为。
功能边界：纯支付工具定位，无法币兑换、无高级隐私功能（如 trampoline 路由）、无多签支持。适合微支付场景，不适合大额资金存储。
适合人群
- AI 代理开发者：需为代理赋予"自主经济能力"，实现服务变现或资源购买
- Lightning 实验者：寻求最小化配置的闪电网络交互方案
- 自动化支付场景：机器间小额即时结算、API 按量计费等
常规风险提示
⚠️ 主网真实资金：默认连接比特币主网，测试与生产环境需严格隔离。
⚠️ 版本固定建议：生产环境应锁定具体版本（如 @0.11.0），避免 npx @latest 的供应链攻击风险。
⚠️ 备份强制要求：首次初始化后必须离线备份助记词，建议采用加密介质或分片存储。