使用 TronPy 发送全部 TRX 余额需手动计算「可用余额 = 当前余额 − 预估转账手续费」，TronPy 本身不提供 send_all() 一类的内置方法；本文详解安全、精确的实现逻辑、代码示例及关键注意事项。
使用 tronpy 发送全部 trx 余额需手动计算「可用余额 = 当前余额 − 预估转账手续费」，tronpy 本身不提供 `send_all()` 一类的内置方法；本文详解安全、精确的实现逻辑、代码示例及关键注意事项。
在 TRON 网络中，发送 TRX 转账需消耗能量（Energy）或带宽（Bandwidth），而普通 TRX 转账（TRC-10 类型）默认使用带宽，不额外收费——但发起交易本身仍需支付一笔固定的 1 trx 手续费（fee limit 默认为 1,000,000 sun，即 0.001 TRX，实际扣费通常为 0，但账户必须至少保留 1 TRX 作为“基础余额”以维持活跃状态。⚠️ 更重要的是：TRON 要求每个账户必须持有 ≥ 1 TRX 才能保持地址可接收资产（否则会被冻结）；若强行转出全部余额（包括这 1 TRX），交易将因违反协议而失败。
因此，“发送全部余额”的正确含义是：
✅ 发送 account_balance - 1 TRX（保留最低生存余额）
✅ 显式设置 fee_limit 并预估实际消耗（虽通常极低，但需确保交易可广播）
✅ 使用 get_account() 获取实时余额，避免竞态导致超发
以下是完整、健壮的实现示例：
from tronpy import Tron
from tronpy.keys import PrivateKey
# 初始化客户端（主网）
client = Tron()
def send_all_trx(private_key: str, to_address: str, memo: str = "") -> dict:
priv_key = PrivateKey(bytes.fromhex(private_key))
address_from = priv_key.public_key.to_base58check_address()
# 1. 获取当前账户 TRX 总余额（单位：sun）
account = client.get_account(address_from)
balance_sun = account.get("balance", 0) # 单位：sun（1 TRX = 1_000_000 sun）
if balance_sun <= 1_000_000: # ≤ 1 TRX → 无法转出（需保留至少 1 TRX）
raise ValueError("Insufficient balance: must keep at least 1 TRX for account activation.")
# 2. 计算可转出金额：保留 1 TRX（1_000_000 sun）
amount_to_send_sun = balance_sun - 1_000_000
# 3. 构建交易（TRX transfer 是 TRC-10，无 token fee，仅需带宽）
txn = (
client.trx.transfer(address_from, to_address, amount_to_send_sun)
.memo(memo)
.build()
.sign(priv_key)
)
# 4. 广播并返回结果
result = client.broadcast(txn)
return {
"txid": result["txid"],
"sent_trx": amount_to_send_sun / 1_000_000,
"remaining_balance_trx": 1.0,
"timestamp": result.get("timestamp", None)
}
# 使用示例
try:
res = send_all_trx(
private_key="your_private_key_hex_here",
to_address="TQRQHBMYxdPjKmq8qJ3mdqAWDvABzRE1ZZB",
memo="Send all available TRX"
)
print("✅ Success:", res)
except Exception as e:
print("❌ Failed:", str(e))? 关键注意事项：
-
永不尝试发送
balance_sun全额：TRON 协议强制要求账户余额 ≥ 1 TRX，否则地址失效，且交易会被节点拒绝（ACCOUNT_NOT_EXIST或BALANCE_NOT_SUFFICIENT错误）； -
memo字段最大长度为 256 字节，超长将导致构建失败； -
get_account()返回余额为实时链上值，但存在极短延迟；高并发场景建议加锁或重试机制； - 若需发送 TRC-20 代币（如 USDT），逻辑不同：需调用合约
transfer()，且手续费仍由 TRX 支付，此时“全余额发送”需额外估算 Gas 消耗（推荐使用tronpy.contract+estimate_energy()）； - 生产环境务必添加异常捕获（如
tronpy.exceptions.TransactionError,tronpy.exceptions.ApiError）并记录日志。
总结：TronPy 不提供“一键清空”接口，但通过精准余额查询、硬性保留 1 TRX、规范构建交易，即可安全、可靠地实现“发送全部可用 TRX”。核心原则是——尊重链规则，而非绕过它。
