BTCPay Server中Nostr Wallet Connect(NIP47)支付检测问题解析

问题背景

在BTCPay Server 2.0.3版本中，用户在使用Nostr Wallet Connect(NWC)协议通过Alby钱包进行闪电网络支付时遇到了两个关键问题：

1. 连接字符串格式兼容性问题：当使用nostr+walletconnect://格式的连接字符串时，系统虽然接受连接但无法检测支付；而添加type=nwc;前缀后，系统又拒绝接受该格式。

2. 支付状态更新问题：即使成功建立连接，支付完成后发票(invoice)状态无法自动更新为"已结算"。

技术分析

连接字符串格式规范

BTCPay Server对NWC连接字符串有两种合法格式要求：

1. 显式类型声明格式：

type=nwc;key=b889ff5b1513b641e2a139f661a661364979c5beee91842f8f0ef42ab558e9d4?relay=wss%3A%2F%2Frelay.example.com&secret=71a8c14c1407c113601079c4302dab36460f0ccd0ad506f1f2dc73b5100e4f3c

2. 协议前缀格式：

nostr+walletconnect:b889ff5b1513b641e2a139f661a661364979c5beee91842f8f0ef42ab558e9d4?relay=wss%3A%2F%2Frelay.example.com&secret=71a8c14c1407c113601079c4302dab36460f0ccd0ad506f1f2dc73b5100e4f3c

问题根源

1. 格式解析错误：系统底层代码(LightningConnectionStringHelper.ExtractValues)强制要求连接字符串必须包含type键，但在处理协议前缀格式时未能正确识别。

2. 支付状态检测失效：这是由于Nostr插件(版本1.1.15.0和1.1.16.0)存在缺陷，导致无法正确监听和处理支付完成事件。

临时解决方案

开发团队确认了一个有效的混合格式：

type=nwc;key=nostr+walletconnect:05d719xxxxxxxxxxxxxxxxxxxxxxxxx?relay=wss://relay.example.com/v1&secret=xxxxxxxxxxxxxxxxxxxxx&lud16=[e-mail]

但需要注意，此格式虽然能建立连接，支付状态更新问题仍需等待插件更新。

开发者响应

BTCPay Server开发团队已确认这些问题，并计划发布新版本修复：

1. 统一连接字符串处理逻辑，确保两种标准格式都能被正确识别
2. 修复Nostr插件中的支付状态监听机制

给用户的建议

1. 目前建议使用混合格式连接字符串建立钱包连接
2. 关注BTCPay Server更新，及时升级到包含修复的版本
3. 对于关键业务场景，建议暂时使用其他闪电网络实现作为替代方案

技术展望

Nostr Wallet Connect作为新兴的闪电网络支付协议，其与BTCPay Server的集成仍在不断完善中。这次遇到的问题反映了协议实现早期常见的兼容性挑战，随着开发团队的持续优化，未来将提供更稳定可靠的支付体验。