创建并提交订单

订单（意图）描述了用户想要什么：输入资产、期望的输出、结算参数和截止时间。在所有链上，推荐路径都是一样的：请求一个 V1 报价，然后签名并发送它返回的现成开启交易。链下提交（通过订单服务器）适用于 EVM 的无 gas 流程。在目标结算器支持的地方（EVM 上支持，Solana 上不支持），也可以使用交付时调用。

订单结构

LI.FI 意图使用 OIF 的 StandardOrder，它支持单链输入和多链输出。

type StandardOrder = {
  user: `0x${string}`;
  nonce: bigint;
  originChainId: bigint;
  expires: number;
  fillDeadline: number;
  inputOracle: `0x${string}`;
  inputs: [bigint, bigint][];
  outputs: MandateOutput[];
};

type MandateOutput = {
  oracle: `0x${string}`;
  settler: `0x${string}`;
  chainId: bigint;
  token: `0x${string}`;
  amount: bigint;
  recipient: `0x${string}`;
  call: `0x${string}`; // named `callbackData` in the order server's REST payloads
  context: `0x${string}`;
};

字段参考

字段	描述
`user`	输入资产的所有者。如果订单未被填充，则为退款接收方。
`nonce`	每个订单的唯一标识符。对于 The Compact，这是一个 allocator nonce。
`originChainId`	意图发起的链
`expires`	提交订单已被填充的证明的截止时间（unix 时间戳）。在此之后，订单可以退款。
`fillDeadline`	求解器填充订单的截止时间。必须早于 `expires`。
`inputOracle`	源链上的 oracle 地址。必须与 `outputs[].oracle` 对应。
`inputs`	以 `uint256` 表示的 `[tokenIdentifier, amount]` 对数组。对于托管，token 标识符是转换为 `uint256` 的地址。对于 The Compact，它是 ERC-6909 标识符。
`outputs`	描述期望交付的 `MandateOutput` 数组

输出字段

字段	描述
`oracle`	输出链上的 oracle 地址。必须与 `inputOracle` 处于同一个 oracle 网络中。
`settler`	输出 settler 合约。决定拍卖类型和结算逻辑。
`chainId`	目标链标识符
`token`	目标链上的 token 标识符
`amount`	输出 token 数额
`recipient`	输出代币和任何 calldata 的接收方地址
`call`	在代币交付后交付给 `recipient` 的 calldata。如不需要则设为 `0x`。
`context`	拍卖参数和结算上下文。对于简单的限价单，设为 `0x`。

选择资源锁

资源锁决定了在求解器填充订单期间用户资金如何被持有。

锁	最适用于	工作原理
Simple Escrow（`InputSettlerEscrow`）	与非资源锁桥接一同使用的标准集成	用户批准托管合约（通过直接批准或 Permit2）。代币按每笔意图进行托管。
The Compact（`InputSettlerCompact`）	资源锁原生应用	长期存款。用户存入一次即可从同一余额发出多个意图。

如果您要在其他桥接之外添加 LI.FI Intents，推荐使用 Simple Escrow。如果您正在构建资源锁优先的应用，请考虑使用 The Compact。资金存入的具体方式请参阅 Escrow 存款方式。

已部署的 InputSettlerCompact 合约尚未更新到当前版本的协议。更新后的部署上线后会公布其地址——在此之前请使用 Simple Escrow，或者如果您正在构建 Compact 集成，请联系 LI.FI。

在 Tron 和 Solana 上，只提供 Escrow——这两条链上都没有 Compact 或资源锁流程。

提交订单

每个 V1 报价都会返回 order.openIntentTx——一笔用于开启订单的源链交易。在链上开启这个动作本身就是广播：输入结算器会发出一个开启事件，订单服务器摄取该事件，求解器随即领取该订单。不存在单独的提交调用。不同链上，交易的形态以及发送前所需的步骤各不相同。

在 EVM 上开启

openIntentTx 携带输入结算器地址（to）、十六进制 calldata（data）以及 gas 预估值（gasRequired）。发送前，请满足 order.checks.allowances 中的每一项——每一项都断言用户为 spender 持有并已授权至少 required 数量的 token（可以是直接的 ERC-20 授权，也可以是 Permit2）：

import { erc20Abi } from 'viem';

// walletClient: your connected viem wallet client
// quote: the winning entry from the quote response
const { openIntentTx, checks } = quote.order;

for (const check of checks.allowances) {
  await walletClient.writeContract({
    address: check.token,
    abi: erc20Abi,
    functionName: 'approve',
    args: [check.spender, BigInt(check.required)],
  });
}

const hash = await walletClient.sendTransaction({
  to: openIntentTx.to,
  data: openIntentTx.data,
});

在 Tron 上开启

在 Tron 上，openIntentTx.data 是完整的 ABI calldata（函数选择器 + 参数），而不是一笔可直接广播的交易。请先授权 TRC-20 输入，然后使用 TronWeb 将该 calldata 包裹进 TriggerSmartContract 信封中；feeLimit 是以 SUN 计的能量花费上限，而非估算值：

import { TronWeb } from 'tronweb';

const tronWeb = new TronWeb({ fullHost: 'https://api.trongrid.io' /*, privateKey */ });
const { to, data, feeLimit } = quote.order.openIntentTx;

const tx = await tronWeb.transactionBuilder.triggerSmartContract(
  to,                       // settler (base58)
  '',                       // selector empty: full calldata is supplied via `input`
  { feeLimit, input: data.replace(/^0x/, '') },
  [],
  tronWeb.defaultAddress.base58,
);
const signed = await tronWeb.trx.sign(tx.transaction);
await tronWeb.trx.sendRawTransaction(signed);

关于地址转换和 TVM 信封的详细说明，见 Tron vs EVM。

在 Solana 上开启

在 Solana 上，openIntentTx.data 是一个序列化的交易模板。签名之前，请替换其中的占位区块哈希，并使用 openIntentTx.computeUnitsRequired 中返回的计算单元限制重建其消息：

import {
  ComputeBudgetProgram,
  Connection,
  Keypair,
  TransactionMessage,
  VersionedTransaction,
} from "@solana/web3.js";
import bs58 from "bs58";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const userKeypair = Keypair.fromSecretKey(bs58.decode(process.env.USER_SECRET_KEY!));

// The winning entry from the quote response:
const quote = quotes[0];

const template = VersionedTransaction.deserialize(
  bs58.decode(quote.order.openIntentTx.data),
);
const message = TransactionMessage.decompile(template.message);
message.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;
message.instructions.unshift(
  ComputeBudgetProgram.setComputeUnitLimit({
    units: Number(quote.order.openIntentTx.computeUnitsRequired),
  }),
);

const tx = new VersionedTransaction(message.compileToV0Message());
tx.sign([userKeypair]);
const signature = await connection.sendTransaction(tx);

当前模板不包含地址查找表，因此可以直接反编译而无需提供查找表账户。如果这一点将来发生变化，请在重建之前解析每一个查找表并将其传给 TransactionMessage.decompile。在 dApp 中，请使用您钱包适配器的 signTransaction，而不是 Keypair。open 指令会托管输入代币并发出一个 OpenEvent；订单服务器会摄取该事件并将订单分发给求解器。这里没有预先的授权步骤：checks.allowances 始终为 []，因为 SPL 转账发生在 open 指令内部。

请将 USER_SECRET_KEY 之类的密钥保存在环境变量中——切勿硬编码，也不要在浏览器代码中暴露它们。

链下提交（无 gas 与 Compact）

仅当您的集成需要链下订单提交时——无 gas 托管或已签名的 Compact 领取，二者都仅限 EVM——才使用 POST /orders/submit。它不接受 Tron 或 Solana 订单。如果您使用了来自订单服务器的报价，请包含 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_1",
    "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"
      }]
    }
  }'

响应包含完整的订单、关联的报价（如有）以及一个带有 orderIdentifier 和 onChainOrderId 的 meta 对象用于跟踪。

这是一个参考模板。CatalystCompactOrder 提交需要 sponsor 签名或 Compact 注册的交易哈希。在主网上线之前，请始终在 order-dev.li.fi 上进行验证。

链上 vs 链下订单

类型	示例	是否需要订单服务器？
链上	已打开的托管意图、已注册的 Compact 领取	否。求解器和订单服务器会自动检测这些。
链下（无 gas）	无 gas 托管意图、签名的 Compact 领取	是。通过 `POST /orders/submit` 提交。

订单服务器是一个便利层，而非链上订单的必需项。所有链上意图都可以在不使用它的情况下提交。一些求解器会独立检测链上意图。

交付时调用

每个 MandateOutput 都支持一个 call 字段，用于在代币交付后在目标链上执行的 calldata。接收方先收到代币，然后输出 settler 在 recipient 合约上调用 outputFilled(bytes32 token, uint256 amount, bytes executionData)。在使用交付时调用时：

对于每一个输出，输出结算器会先交付代币，再运行该调用
如果调用失败，则整个意图无法被填充
recipient 必须是实现了 outputFilled 的合约，而非 EOA
对于多链输出，只有第一个输出应包含 calldata

对于任意合约调用，请使用批处理合约或 Single-Call Architecture (SCA) 包装器，因为调用被包装在 outputFilled 中。如果您需要 SCA 实现，请联系 LI.FI。

Solana 不支持交付时调用。带有 Solana 输出的订单必须将回调字段留空；否则输出结算器会拒绝填充。

意图验证

在提交之前，请根据以下规则验证您的订单。

安全性

检查 oracle 网络相对于该意图的价值是否足够安全
所有 oracle（输入和输出）都应属于同一个网络
多输出订单可能容易受到 DoS 攻击，即仅填充第一个输出。请将第一个输出设为最有价值的。
来自输出 settler 的调用不能用于认证，因为任何人都可以填充输出
将 user 设置为预期的退款接收方，而非意图发起方或中继地址。

确保退款接收方能够正确接收和处理资金。使用无法接受代币的地址（例如没有 receive 函数的合约，或错误的链地址）将永久损失资金。

正确性

使用已知的、可靠的代币、结算合约和 oracle
使用尽可能少的代币。低价值或不知名的代币会让填充的可能性降低。
在 fillDeadline 和 expires 之间留出足够的时间以适应消息传递延迟
确保 nonce 是唯一的。托管要求用户唯一性，而 The Compact 要求 allocator 唯一性。
对于 The Compact，确保所有输入共享同一个 allocator，且资源锁的过期时间在意图过期时间之后

后续步骤

跟踪订单状态

监控订单进度并处理终态

请求报价

在构造订单之前获取求解器定价

结算

托管和 Compact 注册详情

Oracle 系统

Oracle 网络和验证

入门

Intents API

Solver API

MCP Server

架构

知识库

创建并提交订单

订单结构

字段参考

输出字段

选择资源锁

提交订单

在 EVM 上开启

在 Tron 上开启

在 Solana 上开启

链下提交（无 gas 与 Compact）

链上 vs 链下订单

交付时调用

意图验证

安全性

正确性

后续步骤

跟踪订单状态

请求报价

结算

Oracle 系统

​订单结构

​字段参考

​输出字段

​选择资源锁

​提交订单

​在 EVM 上开启

​在 Tron 上开启

​在 Solana 上开启

​链下提交（无 gas 与 Compact）

​链上 vs 链下订单

​交付时调用

​意图验证

​安全性

​正确性

​后续步骤

跟踪订单状态

请求报价

结算

Oracle 系统

订单结构

字段参考

输出字段

选择资源锁

提交订单

在 EVM 上开启

在 Tron 上开启

在 Solana 上开启

链下提交（无 gas 与 Compact）

链上 vs 链下订单

交付时调用

意图验证

安全性

正确性

后续步骤