跟踪订单状态

提交订单后，您可以通过订单服务器 API 或直接监控链上事件来跟踪其进度。

订单服务器状态

调用 GET /orders/status，附带您提交订单时返回的 onChainOrderId 或 catalystOrderId。

curl -X GET 'https://order.li.fi/orders/status?catalystOrderId=intent_qVo7_1TkJ7VekL99O7SGS9cRHv0si6'

const getOrderStatus = async (orderId: string) => {
  const res = await fetch(
    `https://order.li.fi/orders/status?catalystOrderId=${orderId}`
  );
  return res.json();
};

const status = await getOrderStatus('intent_qVo7_1TkJ7VekL99O7SGS9cRHv0si6');
console.log('Status:', status.meta.orderStatus);

查询参数

参数	描述
`onChainOrderId`	在合约事件中发出的链上订单 ID。对于 Solana，这是 `OpenEvent` 中的 `order_id`，以十六进制编码。
`catalystOrderId`	从 `POST /orders/submit` 返回的订单服务器 ID（例如 `intent_qVo7_...`）

至少需要一个参数。

响应

响应包含完整的订单、任何关联的报价，以及一个带有状态信息的 meta 对象。

{
  order: StandardOrder,
  quote: QuoteInfo | null,
  sponsorSignature: string | null,
  allocatorSignature: string | null,
  inputSettler: string,
  meta: {
    submitTime: number,
    orderStatus: "Signed" | "Delivered" | "Settled" | "Refunded",
    destinationAddress: string,
    orderIdentifier: string,
    onChainOrderId: string,
    signedAt: string | null,
    deliveredAt: string | null,
    settledAt: string | null,
    refundedAt: string | null,
    expiredAt: string | null,
    orderInitiatedTxHash: string | null,
    orderDeliveredTxHash: string | null,
    orderVerifiedTxHash: string | null,
    orderSettledTxHash: string | null,
    refundTxHash: string | null,
    lastCompactDepositBlockNumber: string | null,
    quoteId: string | null,
    solverAddress: string | null,
    integratorKeyHash?: string
  }
}

状态生命周期

meta.orderStatus 取以下四个值之一：

状态	含义
`Signed`	订单已被接受，可供求解器领取
`Delivered`	求解器已在目标链上交付资产
`Settled`	Oracle 已验证交付，锁定资金释放给求解器。终态。
`Refunded`	订单未被填充，输入资金已退还给用户。终态。

其路径为 Signed → Delivered → Settled，Refunded 是另一种终态。 Signed 涵盖填充之前的所有情况，包括链上的 Open 事件——开启订单本身不会产生一个独立的状态。如果您需要确认订单已经上链，请关注 meta.orderInitiatedTxHash。

GET /orders 的 ?status= 过滤参数也接受 Submitted 和 Open 这两个值，但 meta.orderStatus 永远不会返回它们——匹配这些过滤条件的订单会显示为 Signed。

REST 响应和面向求解器的 WebSocket 信息流对同一组状态使用不同的名称。对应关系如下：

REST `meta.orderStatus`	WebSocket 状态
`Signed`	——（订单以 `user:vm-order-submit` 通告）
`Delivered`	`Delivered`
`Settled`	`Finalised`
`Refunded`	`Refunded`

需要特别注意：不要等待 WebSocket 的 Settled 事件——表示成功的终态事件名为 Finalised。

轮询示例

const sleep = (ms: number) => new Promise(r => setTimeout(r, ms));

const pollUntilDone = async (
  orderId: string,
  maxWaitAfterExpiryMs = 60 * 60 * 1000, // give up 1h after expiry
) => {
  let expirySeenAt: number | undefined;

  while (true) {
    const data = await getOrderStatus(orderId);
    const { orderStatus, expiredAt } = data.meta;
    // `order.expires` is a unix timestamp in seconds; don't rely on `expiredAt` alone.
    const expired = expiredAt !== null || Date.now() / 1000 > Number(data.order.expires);
    console.log(`Status: ${orderStatus}`);

    if (orderStatus === 'Settled') {
      console.log('Complete. Delivery tx:', data.meta.orderDeliveredTxHash);
      return { outcome: 'settled', data };
    }

    if (orderStatus === 'Refunded') {
      console.log('Refunded. Refund tx:', data.meta.refundTxHash);
      return { outcome: 'refunded', data };
    }

    if (expired) {
      // Expired means the order can no longer be filled, not that funds are back.
      expirySeenAt ??= Date.now();
      if (Date.now() - expirySeenAt > maxWaitAfterExpiryMs) {
        console.log('Expired and refund still pending.');
        return { outcome: 'refund-pending', data };
      }
      console.log('Expired, waiting for refund...');
      await sleep(30_000);
    } else {
      await sleep(3_000);
    }
  }
};

一旦 order.expires 已过（或 meta.expiredAt 已被设置），订单就无法再被填充——但这不等同于已经退款。只有当 orderStatus 为 Refunded 且 refundTxHash 已设置时，用户的资金才算真正退回；因此过期后应继续轮询（以较低的频率），并展示”退款处理中”的状态，而不是直接报告完成。

列出订单

使用 GET /orders 通过过滤器查询多个订单。订单服务器会将响应缓存几秒钟，对过于频繁的轮询可能会限流或暂时超时。

curl -X GET 'https://order.li.fi/orders?user=0xYOUR_ADDRESS&status=Delivered&limit=10'

参数	描述
`user`	按发起方地址过滤
`status`	按订单状态过滤
`nonce`	按 nonce 过滤
`exclusiveFor`	按求解器地址过滤
`onChainOrderId`	按链上订单 ID 过滤
`catalystOrderId`	按订单服务器 ID 过滤
`limit`	最大结果数（1-50，默认 50）
`offset`	跳过的结果数（0-1000，默认 0）

链上事件

您也可以直接从合约事件跟踪订单。orderId 在所有相关事件上都作为 topic1 发出。

订单已打开

event Open(bytes32 indexed orderId, StandardOrder order);

输出已填充（由求解器）

event OutputFilled(
  bytes32 indexed orderId,
  bytes32 solver,
  uint32 timestamp,
  MandateOutput output,
  uint256 finalAmount
);

订单已完结（结算完成）

event Finalised(
  bytes32 indexed orderId,
  bytes32 solver,
  bytes32 destination
);

订单已退款

event Refunded(bytes32 indexed orderId);

链上 orderId 是确定性的，其计算方式为：

function orderIdentifier(StandardOrder calldata order) internal view returns (bytes32) {
  return keccak256(
    abi.encodePacked(
      block.chainid,
      address(this),
      order.user,
      order.nonce,
      order.expires,
      order.fillDeadline,
      order.inputOracle,
      keccak256(abi.encodePacked(order.inputs)),
      abi.encode(order.outputs)
    )
  );
}

Solana 事件

在 Solana 上，各程序发出的是 Anchor 事件而非 Solidity 事件，每个生命周期步骤对应一个：

步骤	事件	程序	字段
订单已开启	`OpenEvent`	输入结算器	`order_id: [u8; 32]`, `order: StandardOrder`
输出已填充	`OutputFilledEvent`	输出结算器	`settler`, `order_id`, `solver`, `timestamp`, `output: MandateOutput`, `final_amount`
输出未被填充（截止时间之后）	`OutputNotFilledEvent`	输出结算器	`settler`, `order_id`, `fill_deadline`, `output: MandateOutput`
跨链证明已完成	`OutputProvenEvent`	预言机	`chain_id`, `remote_identifier`, `application`, `payload_hash`
订单已完结	`FinalisedEvent`	输入结算器	`settler`, `order_id`, `solver`, `destination`
订单已退款（过期或已证明未填充）	`RefundedEvent`	输入结算器	`order_id`

Solana 的 order_id 由内容派生：keccak256(borsh_serialize(StandardOrder))。intents_protocol 程序还会发出认证和配置层面的事件，列在 Solana 程序的”认证”部分中。

后续步骤

API 概述

完整的端点参考和 Base URL

创建并提交订单

订单构造和提交

结算

输入和输出结算的工作原理

系统概述

Intent/Solver Marketplace 的完整架构

入门

Intents API

Solver API

MCP Server

架构

知识库

跟踪订单状态

订单服务器状态

查询参数

响应

状态生命周期

轮询示例

列出订单

链上事件

订单已打开

输出已填充（由求解器）

订单已完结（结算完成）

订单已退款

Solana 事件

后续步骤

API 概述

创建并提交订单

结算

系统概述

​订单服务器状态

​查询参数

​响应

​状态生命周期

​轮询示例

​列出订单

​链上事件

​订单已打开

​输出已填充（由求解器）

​订单已完结（结算完成）

​订单已退款

​Solana 事件

​后续步骤

API 概述

创建并提交订单

结算

系统概述

订单服务器状态

查询参数

响应

状态生命周期

轮询示例

列出订单

链上事件

订单已打开

输出已填充（由求解器）

订单已完结（结算完成）

订单已退款

Solana 事件

后续步骤