LI.FI 已发送却没收到：核对状态、实际数量和退款
链小知 · 进阶 · 核验 · 依官方文档整理
对已有 status 记录逐项查身份与执行腿，区分完成、部分完成、退款和仍未知。
开始前准备
- 准备原应用的 Step/桥名称、来源链/目标链、交易 hash 或 transactionId，以及已保存的 /v1/status 响应、浏览器交易记录和预期收款地址。
- 仅核对公开/已有记录；不用再次签名或重发。当前状态指南比参考 schema 的 FAILED 子状态更广，未知字段按原文保留。
1. 把查询标识与交易 hash 分开
记录原 /v1/status 查询的 txHash 参数和 fromChain/toChain/bridge。txHash 可承载发送 hash、接收 hash 或 transactionId；transactionId 是 LI.FI 转移 ID，不因此变成链上交易 hash。对普通同链兑换，两链应相同。
若现有查询遗漏来源链或填错桥，先说明查找范围；来源批准交易不能当桥接发送交易。记录 sending.txHash 与 receiving.txHash 各自链，不因两边都是 0x 就混在同一浏览器查。
检查结果：查询标识、来源执行和接收执行各有位置与网络。
2. 保存 status 与 substatus 的组合
抄下 HTTP 状态、业务 status/substatus/substatusMessage 与取得时间。DONE+COMPLETED、DONE+PARTIAL、DONE+REFUNDED 分开；退款完成不是目标资产 fill，部分完成不能显示“全部收到”。
PENDING 的 WAIT_SOURCE_CONFIRMATIONS/WAIT_DESTINATION_TRANSACTION 是不同等待环节，BRIDGE_NOT_AVAILABLE/CHAIN_NOT_AVAILABLE 可能是外部查询不可用。FAILED 按原错误排查，REFUND_IN_PROGRESS 只是进行中。不要为兼容较窄 schema 丢掉指南的失败子状态。
检查结果：结论包含组合状态和时间，等待、查询失败、退款与成交分列。
3. 复核来源成功与目标执行腿
打开已有记录中的 sending.txLink 或相应链浏览器，核对实际发送地址、资产、数量及交易状态；来源 reverted 是来源失败，来源成功只说明该腿执行，不等目标完成。确认数策略也需要按链和重组风险保留。
再核 receiving 的链、hash、收款人、token 身份与数量，查看已有目的链记录中的实际转移。receiving 缺失时标未取得，不能填零；中间桥接资产、退款和预期目标币不一致时逐项记账。
检查结果：两侧链上证据与平台状态可对齐，缺腿不会被当已到账或资产为零。
4. 同一目标资产下比较报价和实际数量
若 status.quote 存在，比较 quote.estimate.toAmount/toAmountMin 与 receiving.amount，三者都是目标 Token 最小单位整数字符串；先确认 token/chain 相同再用 BigInt 作差。COMPLETED 不要求等于预计 toAmount，实际可不同而仍在底线之上。
quote 可在 PENDING 已存在，也可能因旧记录/合作方入库/无保存报价而缺失，均不能当结算错误。没有同币种或精度时停止数量差计算；官方样本中观察日期和 createdAt 年份不一致，样本不作为当前交易回执。
检查结果：同币种对账可复现，报价缺失与时间矛盾明示。
5. 遇到 404 或 NOT_FOUND 先保留未知
HTTP404/code1003 与 200/NOT_FOUND 都可能是索引延迟、错链、未挖或已替换，超时不是失败证明。先查已有来源 receipt/交易记录；原交易有 receipt 时判断成功或 revert，没有 receipt 仍可能 pending。
普通 EVM 替换只有找到同链、同 sender/nonce 的另一笔已挖交易，再验证 recipient/value/calldata 的实际意图才能绑定新 hash；nonce 增长、空 RPC 或“加速”名字都不够。取消交易不会完成跨链，非 EVM/账户抽象不套该 nonce 规则。
检查结果：无证据的查不到保留未决，未自动重发、绑定替换或宣称资金丢失。
6. 给部分完成或退款形成追踪清单
PARTIAL/REFUNDED 时保存实际资产、网络、收款地址与 hash，核对是否还有目标兑换或退款步骤；失败代码如 OUT_OF_GAS/SLIPPAGE_EXCEEDED/NOT_PROCESSABLE_REFUND_NEEDED 只帮助定位，不能保证某桥自动退款或固定到账时间。
整理原 Step、查询参数、时间序列、两侧交易与数量差异给应用支持；已有数据缺少退款腿则标等待补证。即使停止自动轮询也保留上下文，避免把终止等待按钮当执行终态。
检查结果：输出已完成/部分/退款/未决四类结论与缺证清单。
怎样确认完成
- 结论绑定原记录身份、执行腿、组合状态与同币种数量比较。
- 仅文档流程核验，未访问实际钱包/RPC/status；没有转移、退款或到账的行为验收。
常见错误与边界
- DONE 不等于目标币完整到账；查看 substatus 和真实资产。
- 404、等待时长和 nonce 增长均不单独证明失败或替换。
- 不跨币种直接比较报价与执行金额，不以美元估值证明数量一致。