Skip to main content

概览

kaleido-sdk 0.1.9 起,SDK 在 kaleido-sdk/nwc 子路径下提供了一个 Nostr Wallet Connect (NIP-47) 客户端。它让客户端应用可以通过 Nostr 中继驱动远端的钱包服务 —— 例如运行 RGB Lightning Node 的 KaleidoSwap 桌面枢纽 —— 而无需与该节点建立直接的 HTTP 连接。 在标准 NIP-47 钱包方法之外,该客户端还增加了 rln* RGB 闪电扩展方法,让你能够通过同一条加密的 NWC 通道读取余额、管理 RGB 资产,并在远端节点上创建发票。
传输层采用 NIP-44 端到端加密;当钱包服务未声明支持 NIP-44 时,会回退到 NIP-04

建立连接

你需要一个由钱包服务签发的 NWC 连接 URInostr+walletconnect://...)。
如果你需要在连接前查看 URI 的内容(中继、钱包公钥、密钥),可以使用导出的 parseNwcUri(uri);协议错误或 超时会抛出 NwcError

标准钱包方法(NIP-47)

RGB Lightning Node 扩展方法

这些方法把 RLN 操作映射到同一条 NWC 连接上:

通过 NWC 使用完整的 RLN 客户端

如果你已经在用 RlnClient 连接 HTTP 的 nodeUrl,可以把传输层换成 NWC —— 客户端 接口完全一致,只是改由 Nostr 承载:
如果你需要直接构造底层传输,可以使用 NwcRlnNodeClient

NWC 与 HTTP 的选择