hailin
0eea1815ae
目的：允许 2-of-3 MPC 用户在丢失一个设备时，使用服务器备份参与签名转出资产
实现方式：纯新增代码，不修改现有逻辑，保持完全向后兼容
详细修改：
1. TssRepository.kt (新增 256 行)
- 新增 buildSigningParticipantList() 辅助方法 (lines 3715-3743)
* 根据 includeServerParties 参数决定是否包含服务器方
* 默认 false，保持现有行为
- 新增 createSignSessionWithOptions() 方法 (lines 3746-3959)
* 完整复制 createSignSession 逻辑
* 使用辅助方法构建参与方列表
* 支持 includeServerBackup 参数
- 详细日志标记: [CO-SIGN-OPTIONS]
2. MainViewModel.kt (新增 72 行)
- 新增 initiateSignSessionWithOptions() 方法 (lines 1387-1467)
* 调用 repository.createSignSessionWithOptions()
* 处理签名会话创建和自动加入逻辑
* 保留原有 initiateSignSession() 方法不变
- 详细日志标记: [SIGN-OPTIONS]
3. TransferScreen.kt (新增 47 行)
- 修改 onConfirmTransaction 回调: () -> Unit 改为 (Boolean) -> Unit
- 在 TransferConfirmScreen 中新增复选框 UI (lines 736-776)
* 仅在 2-of-3 时显示 (wallet.thresholdT == 2 && wallet.thresholdN == 3)
* 主文本: "包含服务器备份参与签名"
* 说明文本: "如果您丢失了一个设备，勾选此项以使用服务器备份完成签名"
- 传递 checkbox 状态到回调
4. MainActivity.kt (新增 10 行)
- 更新 onConfirmTransaction 回调接受 Boolean 参数
- 条件调用:
* includeServerBackup = true: 调用 initiateSignSessionWithOptions()
* includeServerBackup = false: 调用 initiateSignSession() (原逻辑)
5. IMPLEMENTATION_PLAN.md (新增文件)
- 详细记录实施方案、安全限制、测试场景
- 包含完整的回滚方法
核心设计：
安全限制：
- 仅 2-of-3 配置显示选项
- 其他配置 (3-of-5, 4-of-7 等) 不显示
- 需要用户主动勾选，明确操作意图
- 服务器只有 1 个 key < t=2，无法单独控制钱包
向后兼容：
- 默认行为完全不变 (includeServerBackup = false)
- 不勾选或非 2-of-3 时使用原有方法
- 所有现有方法保持不变，无任何修改
代码特点：
- 所有新增代码都有详细中文注释
- 标注 "【新增】" 或 "新增参数" 便于识别
- 说明目的、安全性、回滚方法
- 详细的调试日志 ([CO-SIGN-OPTIONS], [SIGN-OPTIONS])
测试场景：
1. 2-of-3 正常使用 (不勾选)
- 设备A + 设备B 签名 ✅
- 服务器被过滤 (现有行为)
2. 2-of-3 设备丢失 (勾选)
- 设备A + 服务器 签名 ✅
- 用户明确勾选 "包含服务器备份"
3. 3-of-5 配置
- 不显示复选框 ✅
- 保持现有行为
回滚方法：
按以下顺序删除新增代码即可完全回滚：
1. MainActivity.kt: lines 365-377 恢复为简单调用
2. TransferScreen.kt: 删除 checkbox UI (lines 736-776) 和参数修改
3. MainViewModel.kt: lines 1387-1467 删除新方法
4. TssRepository.kt: lines 3715-3960 删除新方法和辅助方法
5. 删除 IMPLEMENTATION_PLAN.md
编译状态：
✅ Kotlin 编译通过 (BUILD SUCCESSFUL in 1m 8s)
✅ 无编译错误
⏳ 待运行时测试验证服务器 party ID 格式和在线状态
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
|
||
|---|---|---|
| .. | ||
| app | ||
| contracts | ||
| gradle/wrapper | ||
| tsslib | ||
| .gitignore | ||
| IMPLEMENTATION_PLAN.md | ||
| README.md | ||
| build-apk.bat | ||
| build.gradle.kts | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| settings.gradle.kts | ||
README.md
TSS Party Android
Android 版本的 TSS (Threshold Signature Scheme) Party 应用，用于多方共管钱包的密钥生成和签名。
项目结构
service-party-android/
├── app/ # Android 应用模块
│ ├── src/main/
│ │ ├── java/com/durian/tssparty/
│ │ │ ├── data/ # 数据层
│ │ │ │ ├── local/ # 本地存储 (Room, TSS Bridge)
│ │ │ │ ├── remote/ # 远程通信 (gRPC)
│ │ │ │ └── repository/ # 数据仓库
│ │ │ ├── domain/model/ # 领域模型
│ │ │ ├── presentation/ # UI 层
│ │ │ │ ├── screens/ # Compose 屏幕
│ │ │ │ └── viewmodel/ # ViewModels
│ │ │ ├── di/ # Hilt 依赖注入
│ │ │ ├── ui/theme/ # Material Theme
│ │ │ └── util/ # 工具类
│ │ ├── proto/ # gRPC Proto 文件
│ │ └── res/ # Android 资源
│ └── libs/ # TSS 原生库 (.aar)
├── tsslib/ # Go TSS 库源码
│ ├── tsslib.go # gomobile 绑定
│ ├── go.mod
│ ├── build.sh # Linux/macOS 构建脚本
│ └── build.bat # Windows 构建脚本
└── gradle/ # Gradle Wrapper
技术栈
- UI: Jetpack Compose + Material 3
- 架构: MVVM + Repository Pattern
- 依赖注入: Hilt
- 数据库: Room
- 网络: gRPC (protobuf-lite)
- TSS 核心: Go + gomobile (BnB Chain tss-lib v2)
构建步骤
1. 构建 TSS 原生库 (可选，需要 Go 环境)
# 安装 gomobile
go install golang.org/x/mobile/cmd/gomobile@latest
gomobile init
# 构建 Android AAR
cd tsslib
./build.sh # Linux/macOS
# 或
build.bat # Windows
这将在 app/libs/ 生成 tsslib.aar。
注意: 当前版本使用 Kotlin stub 实现，无需编译 Go 库即可构建 APK。 实际运行需要真正的
tsslib.aar。
2. 构建 APK
# Debug 版本
./gradlew assembleDebug
# Release 版本 (需要签名配置)
./gradlew assembleRelease
APK 输出路径: app/build/outputs/apk/debug/app-debug.apk
功能
- 加入 Keygen 会话 - 扫描/输入邀请码，参与多方密钥生成
- 查看钱包 - 显示已创建的共管钱包列表
- 签名交易 - 使用密钥份额参与多方签名
- 设置 - 配置 Message Router 服务器地址
配置
默认服务器配置:
- Message Router:
localhost:50051 - Kava RPC:
https://evm.kava.io
与 Electron 版本的对应关系
| Electron 版本 | Android 版本 |
|---|---|
electron/main.ts |
TssNativeBridge.kt + GrpcClient.kt |
electron/preload.ts |
TssRepository.kt |
src/pages/*.tsx |
presentation/screens/*.kt |
tss-party/ (Go 子进程) |
tsslib/ (gomobile .aar) |
| sql.js | Room Database |
许可证
MIT