跳转到主要内容

​
交易状态

本指南解释了如何使用 LI.FI 提供的 /status 端点检查跨链和交换交易的状态。

​
查询状态端点

要获取转账的状态，可以使用以下任一方式查询 /status 端点：
  1. 发送交易哈希
  2. 接收交易哈希
  3. transactionId
只需要上述值之一，并需要在 txHash 参数中传递。

​
必需：

  • txHash

​
可选：

  • fromChain：加快请求速度（推荐）
  • toChain
  • bridge
对于交换交易，将 fromChain 和 toChain 设置为相同的值。可以省略 bridge 参数。 
const getStatus = async (txHash: string) => {
  const result = await axios.get('https://li.quest/v1/status', {
    params: { txHash },
  });
  return result.data;
};

​
示例响应

{
  "transactionId": "0x0959ee0fbb37a868752d7ae40b25dbfa3b7d72f499fa8386fd5f4105b18b62bd",
  "sending": {
    "txHash": "0x5862726dbc6643c6a34b3496bb15e91f11771f6756ccf83826304846bbc93c0v",
    "txLink": "https://etherscan.io/tx/0x5862726dbc6643c6a34b3496bb15e91f11771f6756ccf83826304846bbc93c0v",
    "amount": "60000000000000000000000",
    "token": {
      "symbol": "ORDS",
      "priceUSD": "0.012027801612559667"
    },
    "gasPrice": "23079962248",
    "gasUsed": "231727",
    "gasAmountUSD": "14.0296",
    "amountUSD": "721.6681",
    "includedSteps": [
      {
        "tool": "feeCollection",
        "fromAmount": "60000000000000000000000",
        "toAmount": "59820000000000000000000"
      },
      {
        "tool": "1inch",
        "fromAmount": "59820000000000000000000",
        "toAmount": "275101169247651913"
      }
    ]
  },
  "receiving": {
    "txHash": "0x2862726dbc6643c6a34b3496bb15e91f11771f6756ccf83826604846bbc93c0v",
    "amount": "275101169247651913",
    "token": {
      "symbol": "ETH",
      "priceUSD": "2623.22"
    },
    "gasAmountUSD": "14.0296",
    "amountUSD": "721.6509"
  },
  "lifiExplorerLink": "https://scan.li.fi/tx/0x5862726dbc6643c6a34b3496bb15e91f11771f6756ccf83826304846bbc93c0v",
  "fromAddress": "0x14a980237fa9797fa27c5152c496cab65e36da4f",
  "toAddress": "0x14a980237fa9797fa27c5152c496cab65e36da4f",
  "tool": "1inch",
  "status": "DONE",
  "substatus": "COMPLETED",
  "substatusMessage": "The transfer is complete.",
  "metadata": {
    "integrator": "example_integrator"
  }
}

​
状态值

状态描述
NOT_FOUND交易不存在或尚未挖矿。
INVALID哈希未与请求的工具绑定。
PENDING桥接仍在进行中。
DONE交易成功完成。
FAILED桥接过程失败。

​
子状态定义

​
PENDING

  • WAIT_SOURCE_CONFIRMATIONS：等待源链确认
  • WAIT_DESTINATION_TRANSACTION：等待目标交易
  • BRIDGE_NOT_AVAILABLE：桥接 API 不可用
  • CHAIN_NOT_AVAILABLE：源/目标链 RPC 不可用
  • REFUND_IN_PROGRESS：退款进行中（如果支持）
  • UNKNOWN_ERROR：状态不确定

​
DONE

  • COMPLETED：转账成功
  • PARTIAL：仅部分转账完成（常见于 across、hop、stargate、amarok）
  • REFUNDED：代币已退款

​
FAILED

  • NOT_PROCESSABLE_REFUND_NEEDED：无法完成，需要退款
  • OUT_OF_GAS：交易 gas 不足
  • SLIPPAGE_EXCEEDED：接收金额过低
  • INSUFFICIENT_ALLOWANCE：授权额度不足
  • INSUFFICIENT_BALANCE：余额不足
  • EXPIRED：交易已过期
  • UNKNOWN_ERROR：未知或无效状态
  • REFUNDED：代币已退款
⌘I