代码 USDT TRC20 自动收款:假币入账、回滚后发货、金额差一位,问题都出在这几处

2026-11-20 09:01:18

USDT TRC20 自动收款:假币入账、回滚后发货、金额差一位,问题都出在这几处

三个已发生的故障

  1. 用户发来 txid,页面显示订单已支付并已开通服务。到 Tronscan 上一查,那笔 Transfer 的合约地址不是 USDT,而是一个 symbol 写着 USDT、decimals 写着 6 的仿冒合约。真链上确实发生过这笔转账,只是转的不是 USDT。
  2. 订单是靠轮询拉到未确认交易后就置为已支付的。一小时后再查,这笔交易在 solidified 链上并不存在,钱没到,服务已经发出去了。
  3. 订单金额 100.00,链上到账 99.999999。监听用 float 比对,判为未付,用户拿着截图来投诉。

这三个故障分别对应入账判定链上的三个环节:合约地址、确认数、金额精度。第四个环节是订单匹配。

先说清楚不适用的情况

如果能够接交易所的充值回调,或者接第三方加密支付服务商来解决,因为他们会替你完成地址分配、确认数判断与归集,那就不要自己写监听。

自建轮询只在一种情况下值得:必须使用自己的收款地址,不接受第三方托管。否则你写的是别人已经写好并踩过坑的那部分。

入账判定链:四个位置会判错

1) 只认合约地址,不要认 symbol / decimals

USDT 在 TRON 上的合约地址是 TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t,Tether 官方支持页与 Tronscan 上一致。

链上任何人都能部署一个 symbol="USDT"、name="Tether USD"、decimals=6 的合约,然后从这个假合约“转”给你 1000 USDT,事件结构与真 USDT 完全一样。只校验 symbol / decimals、或只看 amount 的监听器会把它当成真实入账,这就是假充值攻击。

防护做两层:查询时带 contract_address=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t 过滤;落库前再比一次返回体里的 token_info.address,不一致直接丢弃并告警——不要静默跳过,静默跳过等于把攻击变成日常噪音。

2) only_confirmed=true 才是不可回滚

TronGrid v1 的 GET /v1/accounts/{address}/transactions/trc20 默认会把未确认交易一起返回。参数 only_confirmed=true 只返回 confirmed(即 solidified,已被 2/3+1 超级代表确认)。only_confirmed 与 only_unconfirmed 互斥,同时传会报参数错误(400)。

只查未确认就发货的后果是:极少数情况下交易不进 solidified,区块回滚后这笔 Transfer 在 solid 链上不存在。钱没有,货已发。

TRON 出块 3 秒,solidified 通常在 1 分钟左右,这个等待时间可以接受。

3) 金额是 6 位小数的整数字符串

TRC20 的 value 是原始精度整数,USDT 的 decimals=6,所以 12.34 USDT 在事件里是 "12340000"。

用 float 解析会在大额或多笔累加时出错。Go 侧用 int64 或 big.Int,PHP 侧用 string + BCMath,PHP 侧尤其注意不要用 (float) 做中转。转出时同理:不能写 12.34,必须乘以 1e6。

另外 value 是字符串,别直接 JSON 解成数字:JS 会丢精度,Go 用 json.Number:

// 示意:value 保留字符串语义,token_info.address 二次校验
type Trc20Transfer struct {
Value     json.Number `json:"value"`
TokenInfo struct {
Address string `json:"address"`
} `json:"token_info"`
}

4) 订单匹配:TRC20 没有可依赖的备注

TRON 交易有 raw_data.data 这个备注字段,但钱包和交易所 UI 基本不让用户填,也不能让客服教用户去填。所以只能靠「地址 + 金额 + 时间窗」匹配。

两种做法:

  • 一单一地址(推荐):订单生成时派生或分配一个收款地址,地址本身就是订单标识,不存在一额多单。
  • 固定地址 + 金额加尾数:把订单号编码成 0.00xx 的尾数,例如 100.0037。缺点是同时存在的未支付订单尾数会撞,且用户手工转账常把尾数抹掉导致匹配失败。必须在订单创建时就锁定尾数唯一。

匹配窗口要给容差:金额完全相等才认,差 1 个最小单位都不认;时间窗外到达的进人工队列。

拉单:增量游标、分页和 429

  • 自建 java-tron 全节点没有「按地址查历史」的接口,只能自己扫块或依赖 TronGrid 索引 API。想省钱自建节点同时还要历史查询,基本行不通,参见交易所钱包接入文档。
  • 增量游标用 min_timestamp(毫秒)+ 本地记录的最大 block_timestamp,不要用 fingerprint 当增量游标。fingerprint 是分页 token,order_by 默认 block_timestamp,desc,新交易持续插到头部,用上一页的 fingerprint 续下一页会错位,结果就是漏单或重复。
  • 每页 limit 最大 200;带上 only_confirmed=true 和 contract_address 过滤。
  • 落库以 txid 建唯一索引去重,链上事件会被重复拉到。
  • TronGrid 免费额度有限,遇到 429 Too Many Requests 要退避;生产请求需要 API key。
curl --request GET \
--url "https://api.trongrid.io/v1/accounts//transactions/trc20?only_confirmed=true&contract_address=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&limit=200&min_timestamp=1730000000000&order_by=block_timestamp,asc" \
-H "TRON-PRO-API-KEY: $TRONGRID_KEY"

接口定义见 TronGrid TRC20 历史接口与 TRC20 history 说明。

归集出款:卡在能量上

把收到的 USDT 从各订单地址归集到冷钱包,是最容易「交易发不出去」的一步。

  • TRC20 转账消耗能量(Energy)+ 带宽(Bandwidth)。带宽每字节 1000 sun,已激活账户每天免费 600;能量没有免费额度,单价 100 sun(= 0.0001 TRX),链上参数是 getEnergyFee,可从 wallet/getchainparameters 读取。
  • 单笔 USDT 转账消耗取决于收款地址那一刻的 USDT 余额:已有余额约 64,285 能量;余额为零(含被归集清零过的地址、也从没收到过 USDT 的新地址)约 130,285 能量。差额来自 TVM 新建 balance 存储条目,SSTORE 从 0 写入比覆盖贵 15000 基础能量。这两个数字是 2026-11-09 主网数据,来源见文末链接,本文未自行实测。动态能量模型会把 USDT 这类热门合约放大到接近 4.4 倍上限,所以「一笔 USDT 固定烧多少 TRX」的说法必须带日期。
  • 能量不足时会燃烧发送方 TRX 补足;TRX 也不够 → 交易失败,回执 status 失败、energy_usage 照扣,常见报错 OUT_OF_ENERGY。归集脚本必须给每个出款地址留够 TRX,或先租/委托能量再发。
  • 发起合约调用要设 fee_limit(单位 sun),设太低同样 out of gas。
  • tronweb 的 triggerConstantContract / estimateEnergy 预估不准是已知问题(issue #487):拿硬编码的测试地址去估会得到 3 万多的值,而实际转入零余额地址要 6 万多。必须拿真实收款地址去估。
  • 新地址要先被激活(收到一笔 TRX 或创建账户调用)才有带宽/能量。只收到 USDT 不等于账户被激活。这一点与「收到 USDT 即激活」的常见误解相反,需自行在测试网验证,本文未实测。
  • 成本对比:直接烧 TRX 约 6.4 / 13 TRX 一笔;租能量通常便宜,但依赖第三方、有到账延迟,批量归集时要把「租能量失败」当成一种正常故障来处理,重试和跳过都要有出口。

对账:链上是唯一事实

  • 每天把 trc20 记录按 txid 与订单表做全量比对,找出两类差异:「链上有本地无」是漏单;「本地有链上无」是假充值,或回滚后被改。
  • 「本地有链上无」优先怀疑假币合约和未确认即发货,不要先怀疑接口。
  • 失败的出款交易也会吃 energy,账里要把这部分记为手续费损耗。
  • 别用「用户发来的交易哈希截图」当凭证,一律以自己拉到的记录为准。

资料来源

复制全文 生成海报 支付对接 USDT TRC20 区块链 排障

推荐文章

程序员茄子在线接单