BTCPay Server多签名钱包PSBT签名功能异常分析

BTCPay Server作为一款开源的加密支付处理系统，其多签名钱包功能是许多企业级用户的重要选择。近期在v2.1.0版本中发现了一个影响用户体验的PSBT签名流程异常问题，本文将深入分析该问题的技术背景和解决方案。

问题现象

在多签名钱包(3of5)的交易签名过程中，用户报告了一个特定操作路径下的异常行为：

1. 用户首先通过BTCPay Server Vault完成了第一笔签名
2. 当尝试使用Seedsigner进行第二签名时，选择"Partially Signed 加密 Transaction"选项后，系统没有进入预期的PSBT签名界面，而是直接跳转回了交易列表页面

技术背景

PSBT(Partially Signed 加密 Transaction)是加密生态中用于多签名交易的重要标准协议。它允许交易在不同设备间传递并逐步签名，特别适合冷存储或多方签名的场景。

在BTCPay Server中，PSBT签名流程通常包含以下步骤：

1. 导出未完成的交易为PSBT格式
2. 将PSBT传输至签名设备
3. 签名设备完成签名后返回PSBT
4. 合并签名至最终交易

问题根源分析

经过代码审查，发现问题出在路由处理逻辑上。当用户从交易列表进入签名流程时，系统未能正确识别当前交易状态，导致路由跳转逻辑错误。具体表现为：

• 前端未能正确传递交易ID参数
• 后端路由处理缺少必要的状态检查
• 异常情况下默认跳转至交易列表而非显示错误信息

解决方案

开发团队通过以下修改解决了该问题：

1. 修复了前端路由参数传递逻辑，确保交易ID正确传递
2. 在后端增加了交易状态验证环节
3. 优化了错误处理流程，提供明确的错误反馈而非直接跳转
4. 完善了PSBT签名流程的状态机管理

用户建议

对于遇到类似问题的用户，可以采取以下临时解决方案：

1. 使用"Export PSBT for signing"功能手动导出PSBT文件
2. 在外部钱包应用中完成签名
3. 通过"Combine PSBT"功能导入已签名的交易

该修复已包含在后续版本中，建议用户升级至最新版本以获得完整的多签名钱包体验。对于需要严格安全隔离的场景，PSBT签名流程仍然是实现冷签名的最佳实践之一。