hailin
/
rwadurian
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
rwadurian/backend/mpc-system/services/service-party-android
History
hailin 003871aded fix(android): 修复 markPartyReady 乐观锁冲突导致 keygen 失败的关键Bug [CRITICAL] 
## 问题根因
从用户日志分析发现关键错误：
```
15:58:58.318 E/GrpcClient: Mark party ready failed:
INTERNAL: optimistic lock conflict: session was modified by another transaction
```

**问题链条**：
1. markPartyReady 失败（optimistic lock conflict）
2. 但代码没有检查返回值，继续执行
3. 服务器认为 Party 未准备好，不发送 TSS 消息
4. 534个消息堆积（15:58:58.345 + 15:59:28.440）
5. TSS 协议无法进行
6. keygen 卡死

## 修复内容

### 1. 添加 markPartyReady 重试机制
在所有调用 markPartyReady 的地方添加智能重试：
- 最多重试 5 次
- 检测到 optimistic lock conflict 时延迟重试（500ms, 1s, 1.5s, 2s）
- 每次重试记录详细日志
- 5次失败后停止进度收集并返回错误

### 2. 修复位置（6处）
- startKeygenAsInitiator (line 2137)
- joinKeygenViaGrpc (line 1347)
- startSignAsInitiator (line ~1540)
- joinSignViaGrpc (line ~1686)
- startSignAsJoiner (line ~1888)
- co-sign相关函数

### 3. 日志增强
添加详细的重试日志：
- "markPartyReady successful on attempt X"
- "markPartyReady attempt X failed: {error}"
- "Retrying after Xms..."

## 为什么24小时前正常？

**不是 safeLaunch 的问题！** 而是：
1. 优化前，markPartyReady 失败被静默忽略
2. 可能偶尔能工作（没有并发冲突）
3. 现在并发量增加或服务器负载高，冲突频繁
4. 没有重试机制，一次失败就永久卡住

## 验证方法

重新测试创建2-of-3钱包，日志应显示：
- ✅ "markPartyReady successful on attempt 1" 或
- ✅ "Retrying after 500ms..." → "markPartyReady successful on attempt 2"

不应再有：
- ❌ 534个消息堆积30秒不变
- ❌ keygen 永久卡住

## 附加文档

创建了 LOG_ANALYSIS_PARTY1.md 详细分析日志：
- 完整的日志流程分析
- 3个关键问题定位
- 根本原因推断（70% 概率是 markPartyReady 失败）
- 临时和永久解决方案

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 		2026-01-27 00:09:40 -08:00
..
app fix(android): 修复 markPartyReady 乐观锁冲突导致 keygen 失败的关键Bug [CRITICAL] 2026-01-27 00:09:40 -08:00
contracts feat(blockchain): 切换到dUSDT(绿积分)合约 - KAVA主网 2026-01-02 04:31:11 -08:00
gradle/wrapper feat(android): add Android TSS Party app with full API implementation 2025-12-31 23:27:29 -08:00
tsslib feat(tss): add real-time round progress from msg.Type() parsing 2026-01-01 22:41:51 -08:00
.gitignore feat(android): strengthen gRPC connection reliability 2026-01-01 06:44:42 -08:00
2OF3_FLOW_ANALYSIS.md docs(android): 添加调试日志指南和2-of-3流程分析 2026-01-26 23:27:43 -08:00
CRASH_PREVENTION_SUMMARY.md fix(android): 修复备份导出的数据完整性问题 - 原子写入 + 完整性验证 [CRITICAL] 2026-01-26 22:43:21 -08:00
DEBUG_LOG_GUIDE.md docs(android): 添加调试日志指南和2-of-3流程分析 2026-01-26 23:27:43 -08:00
IMPLEMENTATION_PLAN.md feat(android): 实现 2-of-3 钱包服务器备份参与签名功能 2026-01-26 17:32:36 -08:00
LOG_ANALYSIS_PARTY1.md fix(android): 修复 markPartyReady 乐观锁冲突导致 keygen 失败的关键Bug [CRITICAL] 2026-01-27 00:09:40 -08:00
PERMISSIONS_AUDIT.md docs(android): 添加完整的权限审计报告 2026-01-26 22:53:59 -08:00
QUICK_DEBUG_COMMANDS.md feat(android): 添加一键编译安装调试脚本 2026-01-26 23:51:13 -08:00
README.md feat(android): add Android TSS Party app with full API implementation 2025-12-31 23:27:29 -08:00
build-apk.bat fix(android): simplify build-apk.bat with official gomobile setup 2026-01-01 00:53:04 -08:00
build-install-debug.bat fix(android): 修复批处理文件中文乱码问题 2026-01-26 23:53:25 -08:00
build.gradle.kts feat(android): add Android TSS Party app with full API implementation 2025-12-31 23:27:29 -08:00
gradle.properties feat(android): add Android TSS Party app with full API implementation 2025-12-31 23:27:29 -08:00
gradlew feat(android): add Android TSS Party app with full API implementation 2025-12-31 23:27:29 -08:00
gradlew.bat feat(android): add Android TSS Party app with full API implementation 2025-12-31 23:27:29 -08:00
settings.gradle.kts feat(android): add Android TSS Party app with full API implementation 2025-12-31 23:27:29 -08:00

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

功能

  1. 加入 Keygen 会话 - 扫描/输入邀请码，参与多方密钥生成
  2. 查看钱包 - 显示已创建的共管钱包列表
  3. 签名交易 - 使用密钥份额参与多方签名
  4. 设置 - 配置 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