Compact 订单

Compact 流程使用 The Compact 资源锁进行链下、无 gas 的订单提交。用户存入一次代币后，即可从该余额中发出多个意图，而无需为每笔订单支付 gas。

如果您要在其他桥接之外添加 LI.FI Intents，标准托管流程更简单且推荐使用。当您需要无 gas 提交或正在构建资源锁原生应用时，请使用 Compact 流程。

它与 Escrow 有何不同

	Escrow	Compact
代币锁定	每笔意图，每次都在链上	存入一次，重复使用余额
订单提交	链上（`open`/`openFor`）	链下（`POST /orders/submit`）
每笔意图的 gas	用户支付 gas 进行锁定	初次存入后无 gas
结算	`finalise`（无需签名）	`finaliseWithSignature`（需要签名）
订单类型	不适用（链上检测）	`CatalystCompactOrder`

流程

存入 The Compact

将代币存入 The Compact 资源锁。这是一次性的链上交易。后续意图从该余额中提取，不会产生额外 gas 成本。有关存入和注册意图的 UI 示例，请参阅 lintent.org 演示。

请求报价

调用旧版 V0 端点 POST /quote/request，并在 supportedTypes 中包含 "oif-resource-lock-v0" 以表明支持 Compact。V1 报价端点不服务于资源锁流程，它只返回用户自行开启的订单。因此该流程使用 V0，其参数为 EIP-7930 互操作地址——它们将链和地址打包进一个 bytes 字段。可使用 interoperable-addresses 库来构造它们。

const response = await fetch('https://order.li.fi/quote/request', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    user: '0x0001000002210514YOUR_WALLET_ADDRESS_20_BYTES',
    intent: {
      intentType: 'oif-swap',
      inputs: [{
        user: '0x0001000002210514YOUR_WALLET_ADDRESS_20_BYTES',
        asset: '0x0001000002210514833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',  // USDC on Base
        amount: '10000000',
      }],
      outputs: [{
        receiver: '0x0001000002A4B114YOUR_WALLET_ADDRESS_20_BYTES',
        asset: '0x0001000002A4B114af88d065e77c8cC2239327C5EDb3A432268e5831',  // USDC on Arbitrum
        amount: null,
      }],
      swapType: 'exact-input',
    },
    supportedTypes: ['oif-escrow-v0', 'oif-resource-lock-v0'],
  }),
});

const { quotes } = await response.json();
const bestQuote = quotes[0];

签署领取

Compact 订单通过 EIP-712 签名而非链上交易进行授权。使用 The Compact 的域分隔符签署一个 BatchClaim。

TypeScript

// The claim is signed as a BatchCompact struct:
// struct BatchCompact {
//   address arbiter;        // InputSettlerCompact address
//   address sponsor;        // User address
//   uint256 nonce;          // Allocator nonce
//   uint256 expires;        // Claim expiry
//   uint256[2][] idsAndAmounts;
//   Mandate mandate;        // fillDeadline, inputOracle, outputs
// }

有关完整的签名示例，请参阅 lintent.org 演示。

链下提交订单

将签名的订单提交到 POST /orders/submit。包含 quoteId 以获得优先的解算器匹配。

curl -X POST 'https://order.li.fi/orders/submit' \
  -H 'Content-Type: application/json' \
  -d '{
    "orderType": "CatalystCompactOrder",
    "inputSettler": "0x0000000000cd5f7fDEc90a03a31F79E5Fbc6A9Cf",
    "quoteId": "QUOTE_ID_FROM_STEP_2",
    "order": {
      "expires": 1942819670,
      "user": "0xYOUR_WALLET_ADDRESS",
      "nonce": "1004",
      "originChainId": "8453",
      "fillDeadline": 1942819670,
      "inputOracle": "0x008C3800F3Ad9b3B662d002E90Cc00000000eE17",
      "inputs": [
        ["749071750893463290574776461331093852760741783827", "10000000"]
      ],
      "outputs": [{
        "oracle": "0x000000000000000000000000008C3800F3Ad9b3B662d002E90Cc00000000eE17",
        "settler": "0x00000000000000000000000075220B7600c300005038432a0000f308e0000068",
        "chainId": "42161",
        "token": "0x000000000000000000000000af88d065e77c8cC2239327C5EDb3A432268e5831",
        "amount": "9986765",
        "recipient": "0x000000000000000000000000YOUR_WALLET_ADDRESS",
        "callbackData": "0x",
        "context": "0x"
      }]
    }
  }'

CatalystCompactOrder 提交需要 sponsor 签名或 Compact 注册的交易哈希。上面的负载是一个参考模板。您必须包含相应的签名字段。在生产环境之前，请始终在 order-dev.li.fi 上进行测试。

响应包含一个带有 orderIdentifier 和 onChainOrderId 的 meta 对象用于跟踪。

跟踪订单

与托管流程相同。轮询 GET /orders/status，直到订单达到 Settled 或 Refunded 状态。

const trackOrder = async (orderId: string) => {
  let status: string;
  do {
    const res = await fetch(
      `https://order.li.fi/orders/status?catalystOrderId=${orderId}`
    );
    const data = await res.json();
    status = data.meta.orderStatus;
    console.log(`Status: ${status}`);

    if (status !== 'Settled' && status !== 'Refunded') {
      await new Promise(r => setTimeout(r, 3000));
    }
  } while (status !== 'Settled' && status !== 'Refunded');

  return status;
};

// `submitted`：上一步中 POST /orders/submit 返回的 JSON 响应体
await trackOrder(submitted.meta.orderIdentifier);

集成示例

签署 BatchCompact 领取（UI 示例）
存入和注册意图（UI 示例）
RegisterIntentLib.sol（智能合约示例）

后续步骤

结算

Compact 领取结构、注册和 Permit2 详情

资源锁

资源锁、sponsor、allocator 和 arbiter 的工作原理

创建并提交订单

完整的订单构造参考和验证规则

跟踪订单状态

通过 API 或链上事件监控订单

入门

Intents API

Solver API

MCP Server

架构

知识库

Compact 订单

它与 Escrow 有何不同

流程

集成示例

后续步骤

结算

资源锁

创建并提交订单

跟踪订单状态

​它与 Escrow 有何不同

​流程

​集成示例

​后续步骤

结算

资源锁

创建并提交订单

跟踪订单状态

它与 Escrow 有何不同

流程

集成示例

后续步骤