> ## 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.

# 可用工具

> LI.FI Intents MCP Server 所暴露的全部工具的完整参考

LI.FI Intents MCP Server 暴露的工具分为两类。没有 API 密钥时，只有集成方工具可用。有了解算器 API 密钥后，所有工具都会启用。

## 集成方工具

这些工具人人可用——无需身份验证。

### get-supported-routes

发现可用的链 + 代币对，包括费用和活跃状态。在请求报价之前，用它来验证路由的可用性。

| 参数  | 是否必需 | 说明         |
| --- | ---- | ---------- |
| *无* | —    | 返回所有受支持的路由 |

### request-quote

获取跨链交换的报价。在内部处理 EIP-7930 编码——你可以使用普通的 `0x` 地址和人类可读的金额。

| 参数            | 是否必需 | 说明           |
| ------------- | ---- | ------------ |
| `fromChain`   | 是    | 源链 ID 或名称    |
| `toChain`     | 是    | 目标链 ID 或名称   |
| `fromToken`   | 是    | 源代币地址或符号     |
| `toToken`     | 是    | 目标代币地址或符号    |
| `fromAmount`  | 是    | 要交换的金额（人类可读） |
| `fromAddress` | 是    | 发送方钱包地址      |

<Tip>
  响应中包含一个引导性的 `message`，建议下一步应调用的工具——通常是 `prepare-order`。
</Tip>

### prepare-order

从报价构造一个 `StandardOrder`，可选择通过 EIP-712 对其签名。如果服务器没有签名密钥，则返回一个未签名的订单结构。

| 参数        | 是否必需 | 说明                          |
| --------- | ---- | --------------------------- |
| `quoteId` | 是    | 来自 `request-quote` 响应的报价 ID |

### submit-order

将已签名的订单提交到 LI.FI 订单服务器。

| 参数                 | 是否必需 | 说明                       |
| ------------------ | ---- | ------------------------ |
| `order`            | 是    | 来自 `prepare-order` 的订单对象 |
| `sponsorSignature` | 是    | 来自订单赞助方的 EIP-712 签名      |

<Note>
  解算器覆盖情况各不相同——已提交的订单可能不会立即被接手，或者取决于该路由上可用的解算器，可能根本不会被接手。
</Note>

### track-order

检查订单状态、解算器地址和交易哈希。状态推进：`Submitted -> Open -> Signed -> Delivered -> Settled`。

| 参数        | 是否必需 | 说明        |
| --------- | ---- | --------- |
| `orderId` | 是    | 要追踪的订单 ID |

### list-orders

按状态、用户、链和分页对订单进行筛选列出。

| 参数       | 是否必需 | 说明       |
| -------- | ---- | -------- |
| `status` | 否    | 按订单状态筛选  |
| `user`   | 否    | 按用户地址筛选  |
| `chain`  | 否    | 按链 ID 筛选 |
| `limit`  | 否    | 每页结果数量   |
| `offset` | 否    | 分页偏移量    |

## 解算器工具

这些工具需要通过 `x-api-key` 请求头传入有效的解算器 API 密钥。

### get-solver-identities

查看已注册的解算器地址和声誉追踪数据。

| 参数  | 是否必需 | 说明          |
| --- | ---- | ----------- |
| *无* | —    | 返回已验证解算器的身份 |

### get-quote-inventory

查看某个特定路由已上传的报价。标记出需要刷新的已过期报价。

| 参数          | 是否必需 | 说明     |
| ----------- | ---- | ------ |
| `fromChain` | 是    | 源链 ID  |
| `toChain`   | 是    | 目标链 ID |
| `fromToken` | 否    | 源代币地址  |
| `toToken`   | 否    | 目标代币地址 |

### submit-standing-quotes

批量提交或更新定价报价——每次调用最多 20 万条报价。

| 参数       | 是否必需 | 说明                  |
| -------- | ---- | ------------------- |
| `quotes` | 是    | 包含路由、价格和过期时间的报价对象数组 |

### debug-order

深入检查一个订单的完整生命周期，包括交易哈希和解算器信息。

| 参数        | 是否必需 | 说明        |
| --------- | ---- | --------- |
| `orderId` | 是    | 要调试的订单 ID |

### check-route-health

综合诊断工具：检查路由支持情况 + 报价库存 + 近期活动。

| 参数          | 是否必需 | 说明     |
| ----------- | ---- | ------ |
| `fromChain` | 是    | 源链 ID  |
| `toChain`   | 是    | 目标链 ID |
| `fromToken` | 否    | 源代币地址  |
| `toToken`   | 否    | 目标代币地址 |

### unregister-solver

移除一个已注册的解算器地址。这是一项破坏性操作——该工具在继续之前需要确认。

| 参数        | 是否必需 | 说明       |
| --------- | ---- | -------- |
| `address` | 是    | 要注销的钱包地址 |

<Warning>
  注销一个解算器地址会将其从声誉追踪中永久移除。此操作无法撤销。
</Warning>

## 即将推出

这些工具已在计划中，但尚未完全支持。

### register-solver

注册一个用于声誉追踪的钱包地址。注册流程需要一个多步骤过程：从 Order Server 获取一条注册消息，用你的解算器钱包（ECDSA 或 EIP-1271）对其签名，然后将已签名的消息提交回去。

| 参数          | 是否必需 | 说明       |
| ----------- | ---- | -------- |
| `address`   | 是    | 要注册的钱包地址 |
| `signature` | 是    | 所有权证明签名  |
