agent-wallet-nwc-bridge

自托管闪电网络NWC桥接服务

🥥79总安装量 16评分人数 12
100% 的用户推荐

基于Node.js的自托管NWC桥接方案,通过systemd服务将本地Lightning钱包安全接入Stacker.News等Nostr生态应用,实现去中心化支付能力。

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 代码审计通过:无 eval/exec/system 等危险函数,无 SQL/命令注入、XSS 漏洞,输入验证与异常处理机制完善
  • ✅ 密钥管理安全:敏感信息(wallet_service.sk_hex、client secrets)仅存储于本地 state.json,无静默上传云端行为,Nostr 通信采用 NIP-04/NIP-44 加密
  • ✅ 系统级防护:systemd 服务配置安全加固(NoNewPrivileges/PrivateTmp/ProtectSystem),以用户权限运行无需 root,危险操作需预配置连接和预算限制
  • ⚠️ 依赖供应链风险:nostr-tools 使用 `^2.23.0` 版本范围未完全锁定,且运行时通过 npx 动态安装 @moneydevkit/agent-wallet,建议改用 package-lock.json 锁定版本
  • ⚠️ 本地文件安全:state.json 包含 NWC 连接密钥,用户需自行确保文件权限(chmod 600)并防止误提交至版本控制

使用说明

agent-wallet-nwc-bridge 是一个专为 Nostr 生态设计的轻量级桥接服务,基于 Node.js 开发,旨在将本地运行的 @moneydevkit/agent-wallet Lightning 钱包通过 NIP-47 协议暴露为标准的 Nostr Wallet Connect (NWC) 服务端。该技能通过 systemd 用户服务形式常驻运行,使 Stacker.News 等支持 NWC 的客户端能够安全地调用本地的 make_invoicepay_invoice 能力,实现去中心化的比特币闪电网络支付功能。

核心用法上,用户需在 Linux 环境下部署该服务,通过 npm install 安装依赖后,使用提供的 install_systemd_user.sh 脚本将服务注册为 systemd 用户单元。服务启动后,会生成本地 state.json 存储钱包连接密钥,并监听配置的 Nostr 中继(如 wss://nos.lol)等待 NWC 客户端请求。用户可为不同用途(收款/付款)生成独立的 NWC URI,并设置预算上限(budget_sats)进行权限隔离。

该技能的显著优点包括:完全自托管架构确保私钥本地留存,符合"Not your keys, not your coins"的加密精神;systemd 服务单元配置了严格的安全加固选项(NoNewPrivileges=true、PrivateTmp=true、ProtectSystem=strict),以用户级权限运行无需 root;支持通过环境变量灵活配置多中继节点和默认预算;与 Stacker.News 等主流 Nostr 应用生态无缝集成。

潜在缺点与局限性方面,该技能强制依赖 Linux systemd 环境,Windows 和 macOS 用户无法直接使用;作为 T3 来源的个人项目,长期维护稳定性不及企业级方案;依赖管理中使用 ^ 版本范围且通过 npx 动态安装 @moneydevkit/agent-wallet,存在供应链更新风险;此外,NWC 协议本身的复杂性要求用户具备一定的 Lightning Network 和 Nostr 协议知识。

适合的目标群体主要包括:运行个人 Lightning 节点并希望接入 Nostr 生态的技术用户;使用 @moneydevkit/agent-wallet 的自托管钱包用户;对中心化托管方案不信任、偏好本地密钥管理的隐私敏感型用户;以及需要将 Stacker.News 等内容平台与自有 Lightning 节点集成的内容创作者。

使用该技能可能存在的常规风险包括:state.json 文件包含 NWC 连接私钥,若未设置适当文件权限(如 chmod 600)或误提交至 Git 仓库可能导致密钥泄露;npx 动态安装依赖包虽包名固定,但仍存在供应链投毒的理论风险;预算配置不当或 URI 权限管理疏忽可能导致非预期资金支出;作为网络服务暴露在外,虽无高危漏洞但需确保 Nostr 中继连接的安全性。建议用户定期备份 state.json,并在生产环境使用前充分测试预算限制功能。

agent-wallet-nwc-bridge 内容

手动下载zip · 9.9 kB
agent-wallet-nwc-bridge.servicetext/plain
请选择文件