102 lines
3.0 KiB
Markdown
102 lines
3.0 KiB
Markdown
# ERC20-USDT 批量转账功能
|
||
|
||
## 功能说明
|
||
|
||
该文件 `batch_transfer.go` 提供了 ERC20-USDT 的批量转账功能，支持从同一个发送地址向多个不同的接收地址转账。
|
||
|
||
## 主要功能
|
||
|
||
### 1. 批量转账类型
|
||
|
||
```go
|
||
type BatchTransferItem struct {
|
||
ToAddress string // 接收地址
|
||
Amount float64 // 转账金额
|
||
}
|
||
|
||
type BatchTransferResult struct {
|
||
TxHash string // 交易哈希（多个用逗号分隔）
|
||
Success bool // 是否成功
|
||
TotalAmount float64 // 总转账金额
|
||
Count int // 转账笔数
|
||
}
|
||
```
|
||
|
||
### 2. 使用方法
|
||
|
||
```go
|
||
// 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 费用
|
||
- 交易按顺序发送，可能在高负载时较慢
|