Pacifica 账户生成使用示例

🚀 快速开始

1. 生成单个账户

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

2. 批量生成账户

# 生成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. 验证账户配置

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

4. 运行完整示例

# 运行所有示例演示
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: 创建对冲账户组合

# 生成4个账户用于对冲交易
npx tsx examples/account-generation.ts generate 4 HedgeAccount moderate

生成的账户可以配对使用：

HedgeAccount1 (多头) + HedgeAccount2 (空头)
HedgeAccount3 (多头) + HedgeAccount4 (空头)

场景2: 多策略账户配置

# 生成不同风险配置的账户
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: 大规模部署

# 生成20个账户用于大规模对冲
npx tsx examples/account-generation.ts generate 20 ProductionAccount moderate

📁 生成的文件

config/accounts.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
    }
  }
]

🔐 安全注意事项

生产环境使用

设置强密码: 修改默认加密密码

export ENCRYPTION_PASSWORD="your-very-secure-password-here"

启用加密: 在生产环境中启用私钥加密

// 在代码中设置 encrypt: true
await generator.saveAccountsToFile(accounts, true);

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

开发环境使用

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

🎯 集成到对冲系统

1. 导入账户配置

import { AccountGenerator } from './examples/account-generation';

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

2. 创建对冲会话

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

3. 启动交易系统

# 启动后台对冲服务
npm run backend

📈 监控和管理

账户状态监控

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

风险控制

自动止损
仓位限制
杠杆控制
滑点监控

🔄 自动化部署

CI/CD 集成

# .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: # 部署脚本

环境配置

# 开发环境
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: 运行验证命令查看具体错误：

npx tsx examples/account-generation.ts validate

调试模式

# 启用详细日志
DEBUG=* npx tsx examples/account-generation.ts generate 2 TestAccount moderate

📚 扩展功能

自定义风险配置

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

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

批量操作

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

集成测试

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

🎉 总结

这个账户生成示例提供了：

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

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

usage-examples.md 6.0 KB History Raw