Portal 跨链已扣币未到账：查 WTT 消息、VAA 与目标链领取
链小知 · 入门 · 核验 · 依官方文档整理
通过 Wormholescan 定位原转账，区分源链锁定/销毁、Guardian 签名与目标链赎回。
开始前准备
- 准备现有 Portal 转账的源链交易哈希、目标链、接收地址与路线记录。
- 本篇限 Wormhole Wrapped Token Transfers / Token Bridge；Portal 其他路线不能自动套用。
1. 先确认 WTT 路线与资产
核对源链与目标链及原生/包装币身份。WTT 对原生资产通常锁定，对包装资产销毁，再在目标链铸造包装资产或释放原生资产。源链余额减少只是流程的一部分。
检查结果：路线确属 WTT，资产身份和接收地址明确。
2. 在正确网络查源交易
打开 Wormholescan，选择 Mainnet 或 Testnet，再输入源链哈希。检查结果的 source transaction ID、status、transaction details 和 VAA ID；同一哈希在错误网络查不到，不能判定丢失。
检查结果：找到匹配源交易和网络的消息记录。
3. 核对 VAA 身份
VAA 关联 emitterChain、emitterAddress、sequence。将这些字段与原消息对应，存在 VAA 说明签名消息已取得，不能说明已经在目标链完成。SDK 示例使用 Testnet，复用时必须匹配实际源链网络。
检查结果：VAA 与转账消息一致，未当成目标链到账证据。
4. 区分自动中继与手动领取
自动路线依赖适用链的 relayer；手动路线仍需在目标链提交 VAA。检查记录显示哪种模式及有没有目标交易。自动中继费、native gas drop-off 会影响到手数量，不能用源链本金直接当净到账。
检查结果：模式、目标交易和预期净金额各有记录。
5. 处理旧 VAA 与缺失结果
官方说明手动转账应及时完成：Guardian 集有效性至少保障 24 小时，拖延后旧签名可能被拒绝。遇到这种错误按当前官方替换过期签名流程继续核查，不能推断资金必然丢失。最后以目标链接收地址、代币合约和实际到账为结束依据。
检查结果：缺 VAA、旧签名、未赎回、已到账分别标明。
怎样确认完成
- 建立源交易、VAA、目标交易与资产到账的对应记录。
- 需要手动领取或替换签名时注明待处理，不在诊断中发起交易。
常见错误与边界
- Portal 所有路线都当 Token Bridge。
- 把 VAA 取得当资金到账。
- 忽略目标币可能是包装资产和中继费用。