# MPC 分布式签名系统文档

## 文档目录

| 文档 | 说明 | 适用读者 |
|------|------|---------|
| [01-architecture.md](01-architecture.md) | 系统架构设计 | 架构师、技术负责人 |
| [02-api-reference.md](02-api-reference.md) | API 接口文档 | 后端开发、前端开发、集成工程师 |
| [03-development-guide.md](03-development-guide.md) | 开发指南 | 后端开发 |
| [04-testing-guide.md](04-testing-guide.md) | 测试指南 | 测试工程师、开发人员 |
| [05-deployment-guide.md](05-deployment-guide.md) | 部署指南 | 运维工程师、DevOps |
| [06-tss-protocol.md](06-tss-protocol.md) | TSS 协议详解 | 密码学工程师、安全研究员 |

## 快速开始

### 1. 环境要求

- Go 1.21+
- Docker 20.10+
- Docker Compose 2.0+

### 2. 本地运行

```bash
# 克隆项目
git clone https://github.com/rwadurian/mpc-system.git
cd mpc-system

# 安装依赖
make init

# 启动服务
docker-compose up -d

# 运行测试
make test
```

### 3. 验证安装

```bash
# 健康检查
curl http://localhost:8080/health

# 运行集成测试
go test -v ./tests/integration/... -run "TestFull2of3MPCFlow"
```

## 系统概览

```
┌─────────────────────────────────────────────────────────────────────┐
│                    MPC 分布式签名系统                                │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│   ┌──────────────┐    ┌──────────────┐    ┌──────────────┐         │
│   │   Account    │    │   Session    │    │   Message    │         │
│   │   Service    │───►│  Coordinator │───►│    Router    │         │
│   │   账户管理    │    │   会话协调    │    │   消息路由    │         │
│   └──────────────┘    └──────────────┘    └──────────────┘         │
│          │                   │                    │                 │
│          │                   ▼                    │                 │
│          │           ┌──────────────┐             │                 │
│          │           │ Server Party │◄────────────┘                 │
│          │           │  ×3 实例     │                               │
│          │           │  TSS 计算    │                               │
│          │           └──────────────┘                               │
│          │                   │                                      │
│          ▼                   ▼                                      │
│   ┌─────────────────────────────────────────────────────────┐      │
│   │                   PostgreSQL + Redis                     │      │
│   └─────────────────────────────────────────────────────────┘      │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘
```

## 核心功能

### 阈值签名支持

| 方案 | 密钥生成 | 签名 | 状态 |
|------|---------|------|------|
| 2-of-3 | 3 方 | 任意 2 方 | ✅ 已验证 |
| 3-of-5 | 5 方 | 任意 3 方 | ✅ 已验证 |
| 4-of-7 | 7 方 | 任意 4 方 | ✅ 已验证 |

### 安全特性

- ✅ ECDSA secp256k1 (以太坊/比特币兼容)
- ✅ 密钥分片 AES-256-GCM 加密存储
- ✅ 无单点密钥暴露
- ✅ 门限安全性保证

## 测试报告

最新测试结果:

```
=== 2-of-3 MPC 流程测试 ===
✅ 密钥生成: PASSED (92s)
✅ 签名组合 0+1: PASSED
✅ 签名组合 0+2: PASSED
✅ 签名组合 1+2: PASSED
✅ 安全性验证: PASSED

=== 3-of-5 MPC 流程测试 ===
✅ 密钥生成: PASSED (198s)
✅ 5 种签名组合: ALL PASSED

=== 4-of-7 MPC 流程测试 ===
✅ 密钥生成: PASSED (221s)
✅ 多种签名组合: ALL PASSED
✅ 安全性验证: 3 方无法签名
```

## 技术支持

- 问题反馈: [GitHub Issues](https://github.com/rwadurian/mpc-system/issues)
- 文档更新: 提交 PR 到 `docs/` 目录

## 版本历史

| 版本 | 日期 | 更新内容 |
|------|------|---------|
| 1.0.0 | 2024-01 | 初始版本，支持 2-of-3 |
| 1.1.0 | 2024-01 | 添加 3-of-5, 4-of-7 支持 |