pacifica/examples/simple-usage.md

简化版 Pacifica 账户生成器

🎯 功能说明

这个简化版账户生成器只关注核心功能：

• 生成账户: 自动生成以太坊钱包地址和私钥
• 保存配置: 将账户信息保存到JSON文件
• 执行交易: 使用私钥签名和执行交易

🚀 快速使用

1. 生成账户

# 生成3个账户
npx tsx examples/simple-account-generator.ts generate 3 MyAccount

# 生成5个账户，使用默认名称
npx tsx examples/simple-account-generator.ts generate 5

2. 列出账户

# 查看已生成的账户
npx tsx examples/simple-account-generator.ts list

3. 执行交易

# 使用指定账户执行交易
npx tsx examples/simple-account-generator.ts trade MyAccount1 ETH/USD buy 0.5
npx tsx examples/simple-account-generator.ts trade MyAccount2 ETH/USD sell 0.3

4. 运行演示

# 运行完整演示
npx tsx examples/simple-account-generator.ts demo

📁 生成的文件

config/simple-accounts.json

[
  {
    "name": "Account1",
    "address": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
    "privateKey": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
  }
]

🔧 实际使用流程

步骤1: 生成账户

npx tsx examples/simple-account-generator.ts generate 4 HedgeAccount

步骤2: 导入到Pacifica DEX

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

步骤3: 执行交易

# 多头交易
npx tsx examples/simple-account-generator.ts trade HedgeAccount1 ETH/USD buy 0.5

# 空头交易  
npx tsx examples/simple-account-generator.ts trade HedgeAccount2 ETH/USD sell 0.5

💡 集成到交易系统

程序化使用

import { SimpleAccountGenerator, SimpleTradeExecutor } from './examples/simple-account-generator';

// 生成账户
const generator = new SimpleAccountGenerator();
const accounts = generator.generateMultipleAccounts(4, 'HedgeAccount');
await generator.saveAccounts(accounts);

// 执行交易
const executor = new SimpleTradeExecutor(accounts);
await executor.executeTrade('HedgeAccount1', 'ETH/USD', 'buy', 0.5);

获取私钥用于签名

const executor = new SimpleTradeExecutor(accounts);
const privateKey = executor.getAccountPrivateKey('HedgeAccount1');
// 使用privateKey进行交易签名

🎯 对冲交易示例

生成对冲账户对

# 生成4个账户用于对冲
npx tsx examples/simple-account-generator.ts generate 4 HedgeAccount

执行对冲交易

# 账户1买入，账户2卖出（对冲）
npx tsx examples/simple-account-generator.ts trade HedgeAccount1 ETH/USD buy 0.5
npx tsx examples/simple-account-generator.ts trade HedgeAccount2 ETH/USD sell 0.5

# 账户3买入，账户4卖出（对冲）
npx tsx examples/simple-account-generator.ts trade HedgeAccount3 ETH/USD buy 0.3
npx tsx examples/simple-account-generator.ts trade HedgeAccount4 ETH/USD sell 0.3

🔐 安全注意事项

私钥安全

• 私钥以明文存储，仅用于开发测试
• 生产环境请使用安全的密钥管理方案
• 不要将包含真实私钥的文件提交到版本控制

生产环境

• 使用硬件钱包或密钥管理服务
• 实施访问控制和审计日志
• 定期轮换密钥

📊 输出示例

生成账户输出

🚀 生成 3 个账户...
✅ 已保存 3 个账户到 config/simple-accounts.json

📊 共 3 个账户:
   1. TestAccount1 - 0x971d15E6176F364eB51b11d219AEC91C1295eA59
   2. TestAccount2 - 0x20f48c85B9A6b7F5f2695036A0F75E3e60309219
   3. TestAccount3 - 0xf22F36703Ebc44580f44A5A923e006A65DC7d607

交易执行输出

🔄 执行交易:
   账户: TestAccount1 (0x971d15E6176F364eB51b11d219AEC91C1295eA59)
   交易对: ETH/USD
   方向: 买入
   数量: 0.5
   私钥: 0xc77c225f...fe61
✅ 交易已提交 (模拟)

🎉 总结

这个简化版账户生成器提供了：

• ✅ 简单的账户生成
• ✅ 基本的交易执行
• ✅ 清晰的命令行界面
• ✅ 易于集成到现有系统

核心优势:

• 无复杂配置，即用即得
• 专注于账户和私钥管理
• 支持批量操作
• 易于扩展和定制

适用场景:

• 快速原型开发
• 测试环境部署
• 简单的对冲交易
• 学习和实验

这个工具为Pacifica多账户交易系统提供了最基础但最重要的功能：账户生成和私钥管理。