Cross-Chain Composer

Composer 支持跨 EVM 链的跨链存入。Ethereum 上的用户可以存入 Base 上的 Morpho vault，或将 Arbitrum 上的 USDC 存入 Base 上任意受支持的协议。LI.FI 会自动处理桥接选择、中间交换以及最终存入。从开发者的角度看，集成与同链完全相同：只需将 fromChain 与 toChain 设为不同的值。

跨链 Composer 目前可在 EVM 链之间工作。非 EVM 链（Solana 等）尚不受支持。

How It Works

跨链 Composer 结合了 LI.FI 的两项能力：

桥接路由： LI.FI 选择最优桥接，将资产从源链移动到目标链。
Composer 执行： 在目标链上，Composer 原子地存入目标协议。

从用户的角度看，这是一个单一 flow，在源链上只需一次签名。

Cross-Chain vs. Same-Chain

	Same-chain	Cross-chain
Transactions	1	2（源链 + 目标链）
Atomicity	完全原子	每链原子；整体上最终一致
Status tracking	无需	轮询 `/status` 直到完成
Integration	`fromChain === toChain`	`fromChain !== toChain`

Example 1: ETH (Ethereum) → Morpho Vault (Base)

将 Ethereum 上的 ETH 存入 Base 上由 Spark 策展的 Morpho USDC vault。LI.FI 桥接 ETH，在 Base 上交换为 USDC，并存入 vault。

curl -X GET 'https://li.quest/v1/quote?\
fromChain=1&\
toChain=8453&\
fromToken=0x0000000000000000000000000000000000000000&\
toToken=0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A&\
fromAddress=0xYOUR_WALLET_ADDRESS&\
toAddress=0xYOUR_WALLET_ADDRESS&\
fromAmount=100000000000000000&\
slippage=0.01'

import axios from "axios";

const { data: quote } = await axios.get("https://li.quest/v1/quote", {
  params: {
    fromChain: 1, // Ethereum
    toChain: 8453, // Base
    fromToken: "0x0000000000000000000000000000000000000000", // ETH (native)
    toToken: "0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A", // Morpho vault on Base
    fromAddress: "0xYOUR_WALLET_ADDRESS",
    toAddress: "0xYOUR_WALLET_ADDRESS",
    fromAmount: "100000000000000000", // 0.1 ETH
    slippage: 0.01, // 1% for cross-chain
  },
});

// No approval needed for native ETH; submit directly
const tx = await signer.sendTransaction(quote.transactionRequest);
await tx.wait();
console.log("Source chain tx confirmed:", tx.hash);

// Poll status until the cross-chain transfer completes
let status;
do {
  const { data } = await axios.get("https://li.quest/v1/status", {
    params: {
      txHash: tx.hash,
      fromChain: quote.action.fromChainId,
      toChain: quote.action.toChainId,
    },
  });
  status = data;
  console.log(`Status: ${status.status} ${status.substatus || ""}`);

  if (status.status !== "DONE" && status.status !== "FAILED") {
    await new Promise((r) => setTimeout(r, 5000));
  }
} while (status.status !== "DONE" && status.status !== "FAILED");

console.log("Final status:", status.status);
// User now holds Morpho vault tokens on Base

Example 2: USDC (Arbitrum) → Morpho Vault (Base)

在单一 flow 中将 Arbitrum 上的 USDC 桥接并存入 Base 上由 Spark 策展的 Morpho vault。

curl -X GET 'https://li.quest/v1/quote?fromChain=42161&toChain=8453&fromToken=0xaf88d065e77c8cC2239327C5EDb3A432268e5831&toToken=0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A&fromAddress=0xYOUR_WALLET_ADDRESS&toAddress=0xYOUR_WALLET_ADDRESS&fromAmount=10000000'

const { data: quote } = await axios.get("https://li.quest/v1/quote", {
  params: {
    fromChain: 42161, // Arbitrum
    toChain: 8453, // Base
    fromToken: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", // USDC on Arbitrum
    toToken: "0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A", // Morpho vault on Base
    fromAddress: "0xYOUR_WALLET_ADDRESS",
    toAddress: "0xYOUR_WALLET_ADDRESS",
    fromAmount: "1000000000", // 1000 USDC (6 decimals)
    slippage: 0.01,
  },
});

// Approve USDC, send tx, and poll status (same pattern as above)

底层可能发生的事：

将 USDC 从 Arbitrum 桥接到 Base
在 Base 上将 USDC 存入 Morpho vault
用户收到 vault 代币

确切的步骤取决于 API 返回的路由。若能产生更好的结果，路由引擎可能选择不同的桥接或插入中间交换。

Swap + Bridge + Deposit

用户在另一条链上持有另一种代币。 示例： Ethereum 上的 ETH → Optimism 上的 Aave USDC 借贷

curl -X GET 'https://li.quest/v1/quote?fromChain=1&toChain=10&fromToken=0x0000000000000000000000000000000000000000&toToken=AAVE_AUSDC_TOKEN_ADDRESS_ON_OPTIMISM&fromAddress=0xYOUR_WALLET_ADDRESS&toAddress=0xYOUR_WALLET_ADDRESS&fromAmount=100000000000000000'

const quote = await getQuote({
  fromChain: 1, // Ethereum
  toChain: 10, // Optimism
  fromToken: "0x0000000000000000000000000000000000000000", // ETH (native)
  toToken: "AAVE_AUSDC_TOKEN_ADDRESS_ON_OPTIMISM", // Aave aUSDC on Optimism
  fromAmount: "100000000000000000", // 0.1 ETH
  fromAddress: "0xYOUR_WALLET_ADDRESS",
});

底层可能发生的事：

在 Ethereum 上将 ETH → USDC 交换，然后将 USDC 桥接到 Optimism；或直接桥接 ETH 并在目标链上交换
在 Optimism 上将 USDC 存入 Aave
用户收到 aUSDC 代币

路由引擎决定最优序列。你会在路由响应中看到所选路径。

Bridge + Swap + Stake

用户想在另一条链上质押。 示例： Arbitrum 上的 USDC → Ethereum 上的 wstETH（Lido）

const quote = await getQuote({
  fromChain: 42161,                                             // Arbitrum
  toChain: 1,                                                   // Ethereum
  fromToken: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',     // USDC on Arbitrum
  toToken: '0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0',       // wstETH on Ethereum
  fromAmount: '1000000000',                                     // 1000 USDC
  fromAddress: '0xYOUR_WALLET_ADDRESS',
});

底层可能发生的事：

将 USDC 从 Arbitrum 桥接到 Ethereum
在 Ethereum 上将 USDC → ETH 交换
通过 Lido 质押 ETH，包装为 wstETH
用户收到 wstETH

如果找到更优路径，路由引擎可能选择不同的序列（例如先在 Arbitrum 上交换，再桥接 ETH）。

Status Tracking

跨链转移需要状态轮询。源链交易确认后，轮询 GET /v1/status 直到转移达到 DONE 或 FAILED。

TypeScript

const pollStatus = async (
  txHash: string,
  fromChain: number,
  toChain: number,
) => {
  let status;
  do {
    const { data } = await axios.get("https://li.quest/v1/status", {
      params: { txHash, fromChain, toChain },
    });
    status = data;
    console.log(`Status: ${status.status} (${status.substatus || ""})`);

    if (status.status !== "DONE" && status.status !== "FAILED") {
      await new Promise((r) => setTimeout(r, 5000));
    }
  } while (status.status !== "DONE" && status.status !== "FAILED");

  return status;
};

如需完整的 status 与 substatus 参考，参见 Transaction Status Tracking。

Partial Failure Handling

跨链 flow 是最终一致的。在极少数情况下，桥接步骤成功但目标存入失败。发生这种情况时：

用户在目标链上收到桥接后的代币，而非 vault 代币
源链代币不受风险影响
gas 费用被消耗

请构建你的 UI 以处理 FAILED 状态，并在跨链转移未完成时提示用户检查其目标链余额。

Next Steps

API Integration

含同链与跨链示例的完整 API 集成指南

SDK Integration

使用 LI.FI TypeScript SDK 的托管式跨链执行

Deposit Recipes

常见协议与链的可复制粘贴 recipe

Supported Protocols

可用于跨链存入的协议

简介

通过 Composer API 集成

通过 LI.FI API 集成

资源

Cross-Chain Composer

How It Works

Cross-Chain vs. Same-Chain

Example 1: ETH (Ethereum) → Morpho Vault (Base)

Example 2: USDC (Arbitrum) → Morpho Vault (Base)

Swap + Bridge + Deposit

Bridge + Swap + Stake

Status Tracking

Partial Failure Handling

Next Steps

API Integration

SDK Integration

Deposit Recipes

Supported Protocols

​How It Works

​Cross-Chain vs. Same-Chain

​Example 1: ETH (Ethereum) → Morpho Vault (Base)

​Example 2: USDC (Arbitrum) → Morpho Vault (Base)

​Swap + Bridge + Deposit

​Bridge + Swap + Stake

​Status Tracking

​Partial Failure Handling

​Next Steps

API Integration

SDK Integration

Deposit Recipes

Supported Protocols

How It Works

Cross-Chain vs. Same-Chain

Example 1: ETH (Ethereum) → Morpho Vault (Base)

Example 2: USDC (Arbitrum) → Morpho Vault (Base)

Swap + Bridge + Deposit

Bridge + Swap + Stake

Status Tracking

Partial Failure Handling

Next Steps