批量转账Skill batch-transfer

---

name: batch-transfer description: 在一次操作中批量转账TRX或TRC20代币到多个地址 version: 1.0.0 generated: true author: AI Agent (Self-Generated) tags: [auto-generated, blockchain, tron, batch, transfer]

批量转账

何时使用此技能

使用此技能当：向10个地址批量转账TRX或TRC20代币

先决条件

• 有效的TRON网络连接
• API密钥已在config.toml中配置（如果需要）
• Python 3.8+
• 足够的余额覆盖所有转账及费用

功能

1. 支持转账至最多100个地址
2. 在执行前验证所有地址
3. 计算总金额和费用
4. 返回每个转账的详细结果
5. 支持TRX和TRC20代币

数据源

• TronGrid API（交易构建）
• 地址验证工具

如何使用

基本用法

from personal_skills.batch_transfer.scripts.main import execute_skill

# 执行技能
result = await execute_skill(
    from_address="TYour...",
    recipients=[
        {"address": "TAddr1...", "amount": 10},
        {"address": "TAddr2...", "amount": 20},
        # ... 更多接收者
    ],
    token="TRX"  # 或用于TRC20的代币合约地址
)

print(result)

示例

# 向10个不同地址批量转账10 TRX
recipients = []
for i in range(10):
    recipients.append({
        "address": f"TTest{i}...",
        "amount": 10
    })

result = await execute_skill(
    from_address="TYourAddress...",
    recipients=recipients,
    token="TRX"
)

# 检查结果
if result['success']:
    print(f"已转账至 {result['data']['successful_count']} 个地址")
    print(f"总发送量： {result['data']['total_amount']} TRX")

错误处理

常见错误及解决方案：

• ValidationError：检查所有地址是否为有效的TRON地址
• InsufficientBalance：确认发送方有足够余额覆盖所有转账及费用
• APIError：检查网络连接和API密钥
• RateLimitError：等待后重试

限制

此为自动生成的技能。限制包括：

• 每批次最多100个地址（推荐：10-20个以提高可靠性）
• 所有转账顺序执行（非原子操作）
• 如果一笔转账失败，仍尝试剩余转账
• 需要手动签名每笔交易（安全特性）

实现细节

自动生成信息：

• 创建时间：2026-02-08 04:15:10
• 基于用户请求：“向10个地址批量转账TRX或TRC20代币”
• 复杂度：中等

重要提示：此技能为自动生成。在生产使用前请彻底审查和测试。

下一步

1. 在scripts/main.py中审查生成代码
2. 先用小金额测试（推荐使用测试网）
3. 根据需要优化错误处理
4. 更新文档添加具体示例
5. 添加单元测试

安全须知

⚠️ 重要安全警告：

• 在执行前仔细审查每个接收者地址
• 先从少量测试开始
• 先在测试网上使用
• 确认前验证总金额及费用
• 保持私钥安全（切勿传递给此技能）

参考资料

有关Agent Skills格式的更多信息：

• 参见：skills/skill-generator/references/ANTHROPIC_SKILLS_SPEC.md
• 官方文档：https://agentskills.io/