> ## Documentation Index
> Fetch the complete documentation index at: https://docs.li.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# 什么是 Composer？

> 跨任意链的一键式 DeFi 操作。将兑换、跨链、存款和质押打包成单笔交易。

LI.FI Composer 将多个链上操作（兑换、跨链、存款、质押）打包成**单笔交易**。用户无需导航多个协议并签署数十笔交易，只需一次点击即可完成复杂的 DeFi 工作流程。

<Note>
  **无需自定义集成。** Composer 与 LI.FI API、SDK 和 Widget 开箱即用。如果您已经在使用 LI.FI，那么您已经拥有 Composer。
</Note>

***

## 为什么使用 Composer？

* **单笔交易执行** — 多个操作在一笔交易中完成。用户只需签署一次，支付一次 gas。
* **更低的 Gas 成本** — 批量操作消除了每个步骤的交易费用。
* **执行前模拟** — 整个执行路径在提交到链上之前会进行模拟，防止交易失败并让用户对结果有确定性。
* **原子性（同链）** — 同链组合执行具有原子性：要么所有步骤都成功，要么都不成功。
* **跨链可组合性** — Composer 接入 LI.FI 的完整路由引擎，实现跨链兑换 + 跨链 + 存款流程。
* **随处可用** — 通过 API、SDK 和 Widget 提供，无需额外集成。

***

## 试试看

使用单次 API 调用将 1 USDC 存入 Base 上的 Morpho 金库：

<CodeGroup>
  ```bash curl theme={"system"}
  curl -X GET 'https://li.quest/v1/quote?fromChain=8453&toChain=8453&fromToken=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&toToken=0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A&fromAddress=YOUR_WALLET_ADDRESS&toAddress=YOUR_WALLET_ADDRESS&fromAmount=1000000'
  ```

  ```ts TypeScript theme={"system"}
  import axios from 'axios';

  const quote = await axios.get('https://li.quest/v1/quote', {
    params: {
      fromChain: 8453,           // Base
      toChain: 8453,             // Base (同链)
      fromToken: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // Base 上的 USDC
      toToken: '0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A',   // Morpho 金库代币
      fromAddress: 'YOUR_WALLET_ADDRESS',
      toAddress: 'YOUR_WALLET_ADDRESS',
      fromAmount: '1000000',     // 1 USDC (6 位小数)
    },
  });

  console.log(quote.data);
  ```
</CodeGroup>

将 `toToken` 设置为[支持的协议](/composer/reference/supported-protocols)代币地址，Composer 会自动激活。无需额外参数或配置。

<Card title="执行您的第一笔 Composer 交易" icon="rocket" href="/composer/quickstart">
  按照分步快速入门，在 5 分钟内执行您的第一笔 Composer 交易。
</Card>

***

## 选择您的集成路径

<CardGroup cols={3}>
  <Card title="API" icon="code" href="/composer/guides/api-integration">
    直接 REST API 集成，完全控制 Composer 流程。
  </Card>

  <Card title="SDK" icon="cube" href="/composer/guides/sdk-integration">
    使用 LI.FI TypeScript SDK 进行托管执行、状态跟踪和错误处理。
  </Card>

  <Card title="Widget" icon="window" href="/composer/guides/widget-integration">
    即插即用 UI 组件 — Composer 自动工作，无需额外代码。
  </Card>
</CardGroup>

***

## 工作原理

Composer 使用两个核心组件：

1. **链上 VM（执行引擎）** — 一个可以调用任何其他链上协议或协议系列的智能合约，处理所有执行而无需用户理解区块链交互。

2. **eDSL 和编译器** — 一个专门构建的领域特定语言，用于在 TypeScript 中表达合约交互。这会被编译成 VM 在链上执行的字节码。

当您使用金库代币作为 `toToken` 请求报价时，LI.FI 的路由引擎会自动：

* 识别最优路径（兑换、跨链或两者兼有）
* 编译 Composer 指令
* 模拟完整执行路径
* 返回准备签署的交易

<Card title="深入了解 Composer 架构" icon="diagram-project" href="/composer/composer-101">
  了解链上 VM、eDSL 编译器、动态调用数据注入和完整的交易生命周期。
</Card>

***

## 支持的协议

Composer 目前支持以下协议。团队基于技术可行性和社区反馈接受集成请求。

| 协议                    | 类型      | 操作     | 链接                                                         |
| --------------------- | ------- | ------ | ---------------------------------------------------------- |
| Morpho V1 & V2        | 借贷 / 金库 | 存款, 取款 | [morpho.org](https://morpho.org/)                          |
| Aave V3               | 借贷      | 存款, 取款 | [aave.com](https://aave.com/)                              |
| Euler                 | 借贷      | 存款, 取款 | [euler.finance](https://www.euler.finance/)                |
| Pendle                | 收益      | 存款, 取款 | [pendle.finance](https://www.pendle.finance/)              |
| Lido wstETH           | 流性质押    | 存款, 取款 | [lido.fi](https://stake.lido.fi/wrap)                      |
| EtherFi               | 流性质押    | 存款, 取款 | [ether.fi](https://www.ether.fi/)                          |
| Ethena                | 收益      | 存款     | [ethena.fi](https://ethena.fi/)                            |
| Kinetiq               | 质押      | 存款     | [kinetiq.xyz](https://kinetiq.xyz/)                        |
| Kinetiq Earn (vkHYPE) | 收益      | 存款     | [kinetiq.xyz](https://kinetiq.xyz/stake-hype#kinetiq-earn) |
| Felix Vanilla         | 金库      | 存款, 取款 | [usefelix.xyz](https://www.usefelix.xyz/)                  |
| HyperLend             | 借贷      | 存款, 取款 | [hyperlend.finance](https://hyperlend.finance/)            |
| Maple                 | 借贷      | 存款     | [maple.finance](https://maple.finance/)                    |
| Neverland             | 金库      | 存款, 取款 | [neverland.money](https://neverland.money/)                |
| USDai                 | 收益      | 存款, 取款 | [usd.ai](https://usd.ai/)                                  |
| Seamless              | 借贷      | 存款, 取款 | [seamlessprotocol.com](https://seamlessprotocol.com/)      |

<Card title="完整协议参考" icon="list" href="/composer/reference/supported-protocols">
  查看所有支持的协议、它们的类型、操作和链接。
</Card>

***

## Composer 适合谁？

<AccordionGroup>
  <Accordion title="钱包和 DeFi 平台">
    在您的应用中直接为用户提供复杂的链上操作。Composer 减少用户摩擦，同时扩展您的平台支持的 DeFi 操作范围。创建用户参与活动 — 例如，"存入新协议"推广。
  </Accordion>

  <Accordion title="链上协议（借贷、质押、金库）">
    启用一键跨链存款到您的协议。任何支持链上的资产用户都可以在不离开当前应用的情况下存入您的协议。
  </Accordion>

  <Accordion title="协议团队">
    将您的协议集成为 Composer 目标，以扩展用户可访问性和采用率。合作伙伴协议可以被邀请到 Composer 后端代码库。参见[协议团队指南](/composer/for-protocols/integration-guide)。
  </Accordion>
</AccordionGroup>

***

## 当前限制

* **仅支持 EVM 链** — 暂不支持 Solana 或非 EVM 链
* **仅支持代币化头寸** — Composer 目标必须返回代币（例如，金库代币、LP 代币、LST）

***

## 下一步

<CardGroup cols={2}>
  <Card title="快速入门" icon="rocket" href="/composer/quickstart">
    在 5 分钟内执行您的第一笔 Composer 交易
  </Card>

  <Card title="工作原理" icon="diagram-project" href="/composer/composer-101">
    了解架构、VM 和交易生命周期
  </Card>

  <Card title="API 集成指南" icon="code" href="/composer/guides/api-integration">
    直接 API 集成的完整指南
  </Card>

  <Card title="用例配方" icon="book" href="/composer/recipes/vault-deposits">
    常见 Composer 工作流程的复制粘贴配方
  </Card>
</CardGroup>