# Pacifica 账户生成示例

这个目录包含了Pacifica多账户对冲系统的账户生成和管理示例。

## 文件说明

- `account-generation.ts` - 主要的账户生成脚本
- `account-config-example.json` - 账户配置示例文件
- `README.md` - 使用说明文档

## 快速开始

### 1. 运行完整示例

```bash
# 运行完整的账户生成示例
tsx examples/account-generation.ts
```

这将演示：
- 生成单个账户
- 批量生成多个账户
- 保存和加载账户配置
- 不同风险配置的账户
- 创建对冲账户组合

### 2. 生成指定数量的账户

```bash
# 生成5个账户，使用默认名称和风险配置
tsx examples/account-generation.ts generate 5

# 生成10个账户，自定义名称和风险配置
tsx examples/account-generation.ts generate 10 MyAccount aggressive
```

参数说明：
- `count`: 要生成的账户数量
- `name`: 账户名称前缀（可选，默认：HedgeAccount）
- `risk`: 风险配置（可选，默认：moderate）
  - `conservative`: 保守型
  - `moderate`: 中等型
  - `aggressive`: 激进型

### 3. 验证现有账户配置

```bash
# 验证config/accounts.json中的账户配置
tsx examples/account-generation.ts validate
```

## 功能特性

### 🔐 安全特性
- **私钥加密**: 使用AES-256-GCM加密存储私钥
- **密码保护**: 支持环境变量设置加密密码
- **格式验证**: 完整的账户配置验证

### 📊 风险配置
- **保守型**: 低风险，适合稳定收益
- **中等型**: 平衡风险和收益
- **激进型**: 高风险高收益

### 🎯 对冲策略
- **账户配对**: 自动生成多头/空头账户对
- **风险平衡**: 确保对冲账户风险配置一致
- **批量管理**: 支持批量生成和管理

## 配置说明

### 风险限制参数

| 参数 | 说明 | 保守型 | 中等型 | 激进型 |
|------|------|--------|--------|--------|
| maxPositionSize | 最大持仓大小 | 5% | 10% | 20% |
| maxDailyLoss | 最大日损失 | 2% | 5% | 10% |
| maxLeverage | 最大杠杆 | 5x | 10x | 20x |
| stopLossThreshold | 止损阈值 | 2% | 5% | 10% |
| maxSlippage | 最大滑点 | 0.05% | 0.1% | 0.2% |
| minMarginRatio | 最小保证金比率 | 20% | 15% | 10% |

### 账户配置结构

```typescript
interface AccountConfig {
  name: string;                    // 账户名称
  privateKey: string;              // 私钥（加密存储）
  initialUSDC: number;             // 初始USDC余额
  riskLimits: {                    // 风险限制
    maxPositionSize: number;       // 最大持仓大小
    maxDailyLoss: number;          // 最大日损失
    maxLeverage: number;           // 最大杠杆
    stopLossThreshold: number;     // 止损阈值
    maxSlippage: number;           // 最大滑点
    minMarginRatio: number;        // 最小保证金比率
  };
}
```

## 使用流程

### 1. 生成账户
```bash
# 生成4个对冲账户
tsx examples/account-generation.ts generate 4 HedgeAccount moderate
```

### 2. 配置环境变量
```bash
# 设置加密密码（生产环境必须修改）
export ENCRYPTION_PASSWORD="your-secure-password-here"
```

### 3. 导入到Pacifica DEX
- 使用生成的账户地址在Pacifica DEX创建账户
- 为每个账户充值USDC
- 验证账户状态

### 4. 启动对冲系统
```bash
# 启动后台服务
npm run backend
```

## 安全注意事项

⚠️ **重要安全提醒**：

1. **私钥安全**: 
   - 私钥已加密存储，但仍需妥善保管
   - 生产环境必须修改默认加密密码
   - 建议使用硬件钱包或密钥管理服务

2. **环境变量**:
   - 设置强密码作为加密密钥
   - 不要将私钥提交到版本控制系统
   - 定期轮换加密密钥

3. **网络安全**:
   - 使用HTTPS连接
   - 配置防火墙规则
   - 监控异常访问

## 故障排除

### 常见问题

**Q: 生成的账户无法在Pacifica DEX使用？**
A: 确保账户地址正确，并且已在Pacifica DEX注册。

**Q: 私钥解密失败？**
A: 检查环境变量`ENCRYPTION_PASSWORD`是否正确设置。

**Q: 账户配置验证失败？**
A: 运行验证命令查看具体错误信息：
```bash
tsx examples/account-generation.ts validate
```

### 日志和调试

启用详细日志：
```bash
DEBUG=* tsx examples/account-generation.ts
```

## 扩展功能

### 自定义风险配置
可以修改`AccountGenerator`类中的`getRiskLimits`方法来添加自定义风险配置。

### 批量操作
支持批量生成、验证和管理账户，适合大规模部署。

### 集成测试
账户生成器可以与测试框架集成，用于自动化测试。

## 下一步

1. **部署到生产环境**: 配置安全的环境变量和网络设置
2. **监控和告警**: 设置账户状态监控和风险告警
3. **自动化管理**: 集成到CI/CD流程中
4. **性能优化**: 根据实际使用情况调整参数

## 支持

如有问题或建议，请查看项目文档或提交Issue。