wallet-mpc-tss

README

wallet-mpc-tss

基于 TSS（门限签名）的 MPC 钱包服务：支持 ECDSA (t,n) 门限密钥生成与签名，服务端仅做协调与加密转发，不接触密钥与 TSS 明文。

• 模块路径：github.com/godaddy-x/wallet-mpc-tss

概述

• 服务端（CLI/Web）：提供 HTTP API（创建/解锁钱包、MPC 密钥生成、交易单签名等），协调 Keygen/Sign 任务，按 Subject 转发节点间 ML-KEM-1024 加密消息，不存储 TSS SaveData。
• 节点（node）：连接 App WebSocket（ML-DSA-87 认证），运行 Alice CGGMP DKG/Refresh/Sign；MPC 消息 ML-KEM-1024 加密转发；shard 本地落盘（-keysdir）。
• 钱包与类型：交易单、账户等类型使用 wallet-adapter；CLI/Node 协议 DTO 在 dto/；OPS 客户端 SDK 见 wallet-api-go。

密码学分层

层级	算法	说明
WS 登录	ML-DSA-87	节点 Plan2 认证
WS 传输	AES	已登录连接 Body 外层加密
MPC 交互	ML-KEM-1024	临时公钥、Start、协议 WireBytes
TSS / 链上	ECDSA secp256k1	CGGMP 门限签名；链上验签 mpc/ecdsa

部署：MPC 交互协议使用 ML-KEM-1024（eccrypto 协议 0x04），cli 与全部 node 须同版本。

MPC 全流程总览见 docs/MPC_FLOW.md。Keygen/Sign 细节见 MPC_KEYGEN_SIGN_FLOW.md；HD 派生见 docs/MPC_HD_DERIVATION.md。

ML-DSA 全链后量子路线（SSS + HSM 瞬态重组，与当前 TSS 方案独立）见 ML_DSA_SSS_SIGN_DESIGN.md。

目录结构

.
├── main.go              # CLI 入口：加载配置、启动交互式控制台
├── app/                 # 服务端：配置、HTTP 路由、CLI 业务、MPC 协调与收集
├── node/                # MPC 节点入口：WebSocket、Keygen/Sign 处理
├── dto/                 # CLI / Node WebSocket 协议 DTO
├── mpc/                 # CGGMP + HD + 验签
│   ├── algorithm.go
│   ├── alg_ecdsa/       # DKG / Refresh / Sign (CGGMP)
│   ├── hd/              # wallet / account / address 派生
│   └── ecdsa/           # VerifySignatureHex
├── docs/MPC_FLOW.md     # ★ MPC 全流程总览
├── cli_config.yaml
├── MPC_KEYGEN_SIGN_FLOW.md
├── MPC_SIGN_MEMORY_TEST.md   # 连续 Sign 压测与内存验收
└── ML_DSA_SSS_SIGN_DESIGN.md # ML-DSA + SSS + HSM 分布式签名方案（过渡设计）

构建与运行

环境要求

• Go 1.26+
• 已配置的 Go 模块环境

构建

go build -o cli .
go build -o node ./node

服务端（CLI）

# 生成默认配置示例
./cli -init
# 使用指定配置启动（日志文件：配置名_log.log）
./cli -config=cli_config.yaml

MPC 节点

每个节点使用独立配置（如 cli_node0.json），包含服务端域名、WebSocket 地址、ML-DSA 认证等：

./node -config=cli_node0.json
# 可选：指定 SaveData 本地存储目录（默认 keys）
./node -config=cli_node0.json -keysdir=./data/shards

配置说明

• cli_config.yaml：服务端端口、JWT、GC、extract（walletDir、walletMode、各白名单/黑名单等）。
• walletMode：仅支持 MPC 模式，3=2-of-3（3 节点）、5=3-of-5（5 节点），需部署对应数量节点。
• walletDir（extract.walletDir / env MPC_CLI_WALLET_DIR）：CLI KeyMeta，{walletDir}/{appID}/{walletID}.json
• shardKeysDir（node/cli_nodeN.json / -keysdir）：节点 MPC 分片 {keyID}-nodeN.json

依赖（import 路径）

• github.com/godaddy-x/wallet-adapter：多链适配器类型（RawTransaction、KeySignature、错误码等）。
• github.com/getamis/alice：CGGMP 门限 ECDSA（v1.0.7）。
• github.com/godaddy-x/eccrypto：ML-KEM-1024 / ML-DSA-87（MPC 交互加密与 WS 认证）。
• github.com/godaddy-x/freego：HTTP/WebSocket/JWT/工具等。

本地开发可将 github.com/godaddy-x/wallet-adapter 在 go.mod 中 replace 到本地路径。

许可证

GPL-3.0

Documentation

Overview

程序入口：加载配置并启动 MPC 钱包 CLI 交互式控制台。 支持 -config 指定配置文件。