BTCPay Server多签钱包导入问题分析与解决方案

问题背景

BTCPay Server作为一款开源的加密支付处理系统，近期在v1.12.5版本中出现了多签钱包导入功能失效的问题。多位用户报告在尝试导入由不同钱包软件(Sparrow、Electrum、Coldcard等)生成的多签钱包时遭遇失败，影响了商业运营。

问题现象

用户在使用以下三种导入方式时均出现错误：

1. 钱包文件导入：提示"导入失败，请确保导入兼容的钱包格式"
2. 扩展公钥(xpub)输入：显示"无效的钱包格式：无效字符串"
3. QR码扫描：虽然显示"UR crypto-output解码成功"，但提交后提示"请提供您的扩展公钥"

技术分析

经过开发团队复现和验证，确认问题存在于多签钱包描述符(descriptor)的解析过程中。测试使用的2-of-3多签钱包描述符示例：

wsh(sortedmulti(2,[34d84885/48h/0h/0h/2h]xpub6DkrjvJE1f5h2KJeC42w1GrvHw46S2Xje4BzMtBfkjDzSVKxmn8py8X6Z1BDTVngYitak1iKbvgPZLam3XmtaSDH5G2f2enLM248zJ4rdyh/<0;1>/*,[edec2269/48h/0h/0h/2h]xpub6EcYqB2j6txD8HjroiaiJ5B86HMk7pVuyNAmXkCqPZ6dQTcX8HVQZd1dykYtekih1n4Q9zRVYVQax4fnzfHa92RAf98jqhYUMEsU8JKjP2W/<0;1>/*,[8245fc81/48h/0h/0h/2h]xpub6FFL35Ucn7p1dpy6jsd9uHhMyH7yacewicd74anTLayTy2fbX1V8aa3BN55sBT7egQDsR6X6QTvvCWiBATYz1CxXNdGsZ4NUU5BKhuYeoo/<0;1>/*))#836zw0wm

问题根源在于BTCPay Server当前版本对多签钱包描述符的完整支持尚未完善，特别是对于包含派生路径和校验和等复杂结构的处理存在缺陷。

临时解决方案

对于急需使用多签钱包功能的用户，可采用以下临时解决方案：

1. 手动修改描述符：

   • 移除校验和部分(即#后的字符)
   • 将派生路径中的<0;1>替换为/0/
   • 示例修改后格式：wsh(sortedmulti(2,xpub1/0/*,xpub2/0/*,...))

2. 使用简化格式：

   • 直接使用2-of-xpub1-xpub2-xpub3的简化格式
   • 此方法在文档中有提及，但功能较为基础

需要注意的是，这些临时方案会牺牲部分功能(如不包含找零地址)，用户需自行评估风险。

未来展望

BTCPay Server团队表示，由于当前加密多签钱包规范尚未最终确定，且开发资源有限，完整解决方案的时间表尚不明确。建议关注项目更新，待规范稳定后将优先实现完整支持。

对于企业用户，建议在实施前进行充分测试，并考虑建立备用支付方案以降低风险。社区开发者也在积极探讨更优的临时解决方案，以缓解当前问题对商业用户的影响。