m2pool_payment/internal/blockchain/eth/batch_transfer_example.md

ERC20-USDT 批量转账功能

功能说明

该文件 batch_transfer.go 提供了 ERC20-USDT 的批量转账功能，支持从同一个发送地址向多个不同的接收地址转账。

主要功能

1. 批量转账类型

type BatchTransferItem struct {
    ToAddress string  // 接收地址
    Amount    float64 // 转账金额
}

type BatchTransferResult struct {
    TxHash      string  // 交易哈希（多个用逗号分隔）
    Success     bool    // 是否成功
    TotalAmount float64 // 总转账金额
    Count       int     // 转账笔数
}

2. 使用方法

// 1. 准备批量转账列表
items := []eth.BatchTransferItem{
    {ToAddress: "0xRecipient1", Amount: 100.0},
    {ToAddress: "0xRecipient2", Amount: 200.0},
    {ToAddress: "0xRecipient3", Amount: 50.0},
}

// 2. 调用批量转账
fromAddress := "0xYourAddress"
result, err := ethNode.USDTBatchTransfer(fromAddress, items)
if err != nil {
    log.Fatalf("批量转账失败: %v", err)
}

// 3. 处理结果
fmt.Printf("批量转账完成: %d笔, 总金额: %.2f USDT", result.Count, result.TotalAmount)
fmt.Printf("交易哈希: %s", result.TxHash)

工作原理

由于标准 ERC20 合约不支持批量转账，本实现采用以下策略：

1. 多次独立交易：对每笔转账创建一个独立的 ERC20 transfer 交易
2. Nonce 管理：自动管理 nonce，确保交易按顺序广播
3. Gas 费用：支持 EIP-1559 动态费用和传统 gas price
4. 错误处理：单笔失败不影响其他交易，返回成功和失败的详细统计

注意事项

1. Gas 费用

• 每笔转账需要独立的 gas 费用（约 65,000 gas）
• 批量转账 10 笔需要约 650,000 gas
• 确保发送地址有足够的 ETH 作为 gas 费用

2. 余额检查

• 函数会自动检查 USDT 余额是否足够
• 如果余额不足，会返回错误并终止转账

3. 部分成功

• 如果某些转账失败，函数会继续执行其他转账
• 返回结果中包含成功笔数和详细交易哈希

4. 网络拥堵

• 在高网络拥堵时，某些交易可能被推迟
• 建议监控所有交易状态

性能优化建议

如果需要更高效的批量转账，考虑：

1. 部署批量转账代理合约：实现一个合约方法 batchTransfer(address[] to, uint256[] amounts)
2. 使用多签钱包：减少私钥管理风险
3. Gas 优化：使用更低的 gas price 分批发送

示例输出

🔄 批量转账 - 检测钱包=0x...，余额=1000.00 USDT
✅ 批量转账第1笔已提交: 0xabc123..., 金额=100.00 USDT, 收款地址=0x...
✅ 批量转账第2笔已提交: 0xdef456..., 金额=200.00 USDT, 收款地址=0x...
✅ 批量转账第3笔已提交: 0x789ghi..., 金额=50.00 USDT, 收款地址=0x...
📊 批量转账完成: 总计3笔, 成功3笔, 总金额=350.00 USDT

限制

• 标准 ERC20 不支持真正的批量转账（单笔交易）
• 需要确保发送地址有足够的 ETH 作为 gas 费用
• 交易按顺序发送，可能在高负载时较慢