pacifica/examples

Pacifica 账户生成示例

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

文件说明

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

快速开始

1. 运行完整示例

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

这将演示：

• 生成单个账户
• 批量生成多个账户
• 保存和加载账户配置
• 不同风险配置的账户
• 创建对冲账户组合

2. 生成指定数量的账户

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

# 验证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%

账户配置结构

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

使用流程

1. 生成账户

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

2. 配置环境变量

# 设置加密密码（生产环境必须修改）
export ENCRYPTION_PASSWORD="your-secure-password-here"

3. 导入到Pacifica DEX

• 使用生成的账户地址在Pacifica DEX创建账户
• 为每个账户充值USDC
• 验证账户状态

4. 启动对冲系统

# 启动后台服务
npm run backend

安全注意事项

⚠️ 重要安全提醒：

1. 私钥安全:

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

2. 环境变量:

   • 设置强密码作为加密密钥
   • 不要将私钥提交到版本控制系统
   • 定期轮换加密密钥

3. 网络安全:

   • 使用HTTPS连接
   • 配置防火墙规则
   • 监控异常访问

故障排除

常见问题

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

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

Q: 账户配置验证失败？ A: 运行验证命令查看具体错误信息：

tsx examples/account-generation.ts validate

日志和调试

启用详细日志：

DEBUG=* tsx examples/account-generation.ts

扩展功能

自定义风险配置

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

批量操作

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

集成测试

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

下一步

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

支持

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