nostrwalletconnect

为AI实体提供金融能力——支付闪电发票、查询余额、通过Nostr Wallet Connect(NIP-47)创建发票。

安装

概览

什么是nostrwalletconnect

NostrWalletConnect(简称NWC)是一个为AI实体提供闪电网络金融能力的Python库,基于NIP-47协议实现。它允许开发者通过Nostr中继网络,以加密方式向兼容的闪电钱包发送支付指令,使AI系统能够自主执行支付、收款和余额查询等金融操作。该工具不依赖中心化支付网关,而是将金融能力直接嵌入到去中心化的身份体系中,让每个具备Nostr密钥的AI实体都能拥有独立的财务功能。使用前需先配置一个支持NWC的钱包(如Alby、Mutiny或Coinos),并通过环境变量注入连接字符串,即可在代码中安全调用各类交易接口。

核心功能特点

  1. 支持查询闪电钱包实时余额,返回单位为毫聪(millisatoshis)
  2. 可发起闪电网络支付,自动获取支付预映像作为交易凭证
  3. 能生成BOLT11格式的收款发票,包含金额与描述信息
  4. 提供发票支付状态查询功能,验证指定哈希是否已完成结算
  5. 记录并列出历史交易流水,涵盖入账与出账两种类型
  6. 获取钱包基础信息,包括别名、公钥及支持的NIP-47方法列表

适用场景

NostrWalletConnect特别适合需要自动化金融交互的去中心化AI应用场景。例如,在一个基于Nostr协议的聊天机器人中,当用户请求付费内容时,机器人可通过本库生成专属发票并发送给对方;一旦收到付款确认,即可解锁服务权限,全程无需人工干预。另一个典型用例是自治代理(autonomous agent),比如一个负责维护开源项目的AI助手,它可以定期检查社区赞助情况,自动向贡献者发放小额奖励,同时记录每笔支出的用途。此外,在社交电商或微支付生态中,创作者经济模型也可借此实现即时打赏与订阅收费——粉丝只需扫描生成的二维码即可完成支付,资金直接进入创作者的闪电钱包。所有操作均通过加密通道完成,确保隐私与安全,且完全脱离传统银行体系运作。