# Pacifica 账户生成使用示例

## 🚀 快速开始

### 1. 生成单个账户
```bash
# 生成一个中等风险配置的账户
npx tsx examples/account-generation.ts generate 1 MyAccount moderate
```

### 2. 批量生成账户
```bash
# 生成5个对冲账户
npx tsx examples/account-generation.ts generate 5 HedgeAccount moderate

# 生成10个保守型账户
npx tsx examples/account-generation.ts generate 10 ConservativeAccount conservative

# 生成3个激进型账户
npx tsx examples/account-generation.ts generate 3 AggressiveAccount aggressive
```

### 3. 验证账户配置
```bash
# 验证已保存的账户配置
npx tsx examples/account-generation.ts validate
```

### 4. 运行完整示例
```bash
# 运行所有示例演示
npx tsx examples/account-generation.ts
```

## 📊 风险配置说明

### 保守型 (Conservative)
- 最大持仓大小: 5%
- 最大日损失: 2%
- 最大杠杆: 5x
- 止损阈值: 2%
- 最大滑点: 0.05%
- 最小保证金比率: 20%

### 中等型 (Moderate) - 默认
- 最大持仓大小: 10%
- 最大日损失: 5%
- 最大杠杆: 10x
- 止损阈值: 5%
- 最大滑点: 0.1%
- 最小保证金比率: 15%

### 激进型 (Aggressive)
- 最大持仓大小: 20%
- 最大日损失: 10%
- 最大杠杆: 20x
- 止损阈值: 10%
- 最大滑点: 0.2%
- 最小保证金比率: 10%

## 🔧 实际使用场景

### 场景1: 创建对冲账户组合
```bash
# 生成4个账户用于对冲交易
npx tsx examples/account-generation.ts generate 4 HedgeAccount moderate
```

生成的账户可以配对使用：
- HedgeAccount1 (多头) + HedgeAccount2 (空头)
- HedgeAccount3 (多头) + HedgeAccount4 (空头)

### 场景2: 多策略账户配置
```bash
# 生成不同风险配置的账户
npx tsx examples/account-generation.ts generate 2 ConservativeAccount conservative
npx tsx examples/account-generation.ts generate 2 ModerateAccount moderate  
npx tsx examples/account-generation.ts generate 2 AggressiveAccount aggressive
```

### 场景3: 大规模部署
```bash
# 生成20个账户用于大规模对冲
npx tsx examples/account-generation.ts generate 20 ProductionAccount moderate
```

## 📁 生成的文件

### config/accounts.json
包含所有生成的账户配置：
```json
[
  {
    "name": "HedgeAccount1",
    "privateKey": "0x...",
    "initialUSDC": 10000,
    "riskLimits": {
      "maxPositionSize": 0.1,
      "maxDailyLoss": 0.05,
      "maxLeverage": 10,
      "stopLossThreshold": 0.05,
      "maxSlippage": 0.001,
      "minMarginRatio": 0.15
    }
  }
]
```

## 🔐 安全注意事项

### 生产环境使用
1. **设置强密码**: 修改默认加密密码
```bash
export ENCRYPTION_PASSWORD="your-very-secure-password-here"
```

2. **启用加密**: 在生产环境中启用私钥加密
```typescript
// 在代码中设置 encrypt: true
await generator.saveAccountsToFile(accounts, true);
```

3. **安全存储**: 将配置文件存储在安全的位置
4. **访问控制**: 限制配置文件的访问权限

### 开发环境使用
- 可以使用默认设置进行测试
- 私钥以明文存储（仅用于开发）
- 不要将包含真实私钥的配置文件提交到版本控制

## 🎯 集成到对冲系统

### 1. 导入账户配置
```typescript
import { AccountGenerator } from './examples/account-generation';

const generator = new AccountGenerator();
const accounts = await generator.loadAccountsFromFile();
```

### 2. 创建对冲会话
```typescript
// 使用生成的账户创建对冲会话
const hedgingSession = {
  name: "ETH-USD-Hedging",
  accounts: [accounts[0], accounts[1]], // 配对账户
  strategy: {
    symbol: "ETH/USD",
    volumeTarget: 100000
  }
};
```

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

## 📈 监控和管理

### 账户状态监控
- 实时余额监控
- 持仓状态跟踪
- 风险指标监控
- 交易历史记录

### 风险控制
- 自动止损
- 仓位限制
- 杠杆控制
- 滑点监控

## 🔄 自动化部署

### CI/CD 集成
```yaml
# .github/workflows/deploy-accounts.yml
name: Deploy Accounts
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Generate Accounts
        run: npx tsx examples/account-generation.ts generate 10 ProductionAccount moderate
      - name: Deploy to Production
        run: # 部署脚本
```

### 环境配置
```bash
# 开发环境
NODE_ENV=development npx tsx examples/account-generation.ts generate 2 DevAccount moderate

# 测试环境  
NODE_ENV=test npx tsx examples/account-generation.ts generate 5 TestAccount moderate

# 生产环境
NODE_ENV=production npx tsx examples/account-generation.ts generate 20 ProdAccount moderate
```

## 🛠️ 故障排除

### 常见问题

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

**Q: 私钥格式不正确？**
A: 检查私钥是否以`0x`开头，长度为66个字符。

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

### 调试模式
```bash
# 启用详细日志
DEBUG=* npx tsx examples/account-generation.ts generate 2 TestAccount moderate
```

## 📚 扩展功能

### 自定义风险配置
可以修改`AccountGenerator`类来添加自定义风险配置：

```typescript
// 添加自定义风险配置
const customRiskLimits = {
  maxPositionSize: 0.15,
  maxDailyLoss: 0.08,
  maxLeverage: 15,
  stopLossThreshold: 0.08,
  maxSlippage: 0.0015,
  minMarginRatio: 0.12
};
```

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

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

## 🎉 总结

这个账户生成示例提供了：
- ✅ 完整的账户生成功能
- ✅ 多种风险配置选项
- ✅ 安全的私钥管理
- ✅ 批量操作支持
- ✅ 配置验证功能
- ✅ 详细的文档和示例

使用这个工具，你可以快速生成和管理Pacifica多账户对冲系统所需的所有账户配置。