LI.FI 代理技能

关键规则（请先阅读）

1. 仅使用curl来调用 LI.FI API。绝对不要使用web_search、web_fetch或任何其他工具。
2. 仅使用下面文档中记录的端点。不要猜测或编造 URL。
3. 基础 URL 是https://li.quest/v1/。不使用其他基础 URL。
4. 始终包含认证头："x-lifi-api-key: $LIFI_API_KEY"（双引号，美元符号——由 shell 扩展）。
5. 始终告知用户报价由 LI.FI 提供。
6. 默认滑点：10% (0.10)。如果用户的策略中有自定义滑点（通过defi_get_strategy），则使用该值。如果用户要求，代理也可以根据每笔交易动态调整。
7. 默认截止时间：10分钟。
8. 始终添加&skipSimulation=true到所有/v1/quote请求。我们的EIP-7702委托钱包的链上代码会破坏LI.FI的模拟。
9. 切勿自行构建ERC-20批准调用数据（十六进制）。始终使用defi_approve或defi_approve_and_send工具。
10. 所有交换、跨链桥和DeFi代币操作必须通过LI.FI进行。没有例外。禁止手动与DEX交互。

交易链接

每次广播交易后，始终提供一个可点击的区块浏览器链接：

• EVM：[查看交易](https://basescan.org/tx/0xHASH)——使用正确的浏览器（etherscan.io、basescan.org、arbiscan.io、polygonscan.com、optimistic.etherscan.io）
• Sui：[查看交易](https://suiscan.xyz/txblock/{txDigest})

Sui

• Sui 链 ID：9270000000000000。当用户需要 Sui 时（例如，fromChain和toChain在 LI.FI 报价请求中使用此 ID（例如，fromChain=9270000000000000&toChain=9270000000000000用于同链 Sui 交换）。
• LI.FI 支持Sui进行同链交换以及与 EVM 和 Solana 之间的跨链桥接。
• 对于 Sui 报价，请将用户的suiAddress从defi_get_wallet作为fromAddress使用。
• 使用defi_send_sui_transaction— 传递来自 LI.FI 报价的交易字节（十六进制）。对于 Sui，不要使用defi_send_transaction或defi_approve_and_send。
• Sui 不使用 ERC-20 授权；Sui 的交换没有授权步骤。

端点

GET /v1/chains — 列出支持的链

curl -s --request GET \
  --url https://li.quest/v1/chains \
  --header "x-lifi-api-key: $LIFI_API_KEY"

用途：列出链、测试连接性。如果用户要求测试，请使用此端点。

GET /v1/tokens — 列出链上的代币

curl -s --request GET \
  --url 'https://li.quest/v1/tokens?chains=8453' \
  --header "x-lifi-api-key: $LIFI_API_KEY"

参数：chains（逗号分隔的链 ID）。

GET /v1/quote — 获取包含交易数据的交换/跨链报价

curl -s --request GET \
  --url 'https://li.quest/v1/quote?fromChain=8453&toChain=8453&fromToken=ETH&toToken=USDC&fromAddress=0xYOUR_ADDRESS&fromAmount=100000000000000&slippage=0.10&skipSimulation=true' \
  --header "x-lifi-api-key: $LIFI_API_KEY"

参数：fromChain、toChain、fromToken、toToken,fromAddress,toAddress（可选），fromAmount（以wei为单位），slippage（小数形式，例如0.10 = 10%），skipSimulation=true（始终包含）。

返回：estimate（包含toAmount、toAmountMin、approvalAddress）和transactionRequest（准备提交至钱包）。

向用户展示报价后，始终包含预估输出金额、费用和滑点。使用defi_get_wallet并将其用作fromAddress在报价中。

执行报价

检查是否需要 ERC-20 授权：如果报价的transactionRequest.value为"0x0"并且estimate.approvalAddress存在，那么此次交换/跨链使用的是 ERC-20 代币，需要先进行授权。

• 如果需要授权：使用defi_approve_and_send参数如下：

  • token: 报价中的action.fromToken.addressspender
  • : 报价中的estimate.approvalAddressapproveAmountfrom the quote
  • approveAmount该action.fromAmount来自报价（若为无限额可省略）
  • 至，值，数据，gasLimit：来自报价的transactionRequest

• 若无需批准（原生ETH兑换，值 > 0x0）：使用defi_send_transaction并传入报价的transactionRequest字段：to、value、data、chainId及gasLimit（务必始终传递gasLimit自报价获取）。

切勿自行构建批准调用数据十六进制码。该defi_approve和defi_approve_and_send工具能正确处理ABI编码。

Sui：对于fromChain或toChain为Sui的报价，使用defi_send_sui_transaction并传入报价的交易字节。无需批准步骤。

POST /v1/advanced/routes — 获取多个路由选项

curl -s --request POST \
  --url https://li.quest/v1/advanced/routes \
  --header 'Content-Type: application/json' \
  --header "x-lifi-api-key: $LIFI_API_KEY" \
  --data '{
  "fromChainId": 8453,
  "fromAmount": "100000000000000",
  "fromTokenAddress": "0x0000000000000000000000000000000000000000",
  "toChainId": 8453,
  "toTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "options": {
    "slippage": 0.10,
    "order": "RECOMMENDED"
  }
}'

POST /v1/quote/contractCalls — 多步骤合约调用（测试版）

curl -s --request POST \
  --url https://li.quest/v1/quote/contractCalls \
  --header 'Content-Type: application/json' \
  --header "x-lifi-api-key: $LIFI_API_KEY" \
  --data '{
  "fromChain": 10,
  "fromToken": "0x4200000000000000000000000000000000000042",
  "fromAddress": "0xYOUR_ADDRESS",
  "toChain": 1,
  "toToken": "ETH",
  "toAmount": "100000000000001",
  "contractCalls": []
}'

GET /v1/status — 检查转账状态

curl -s --request GET \
  --url 'https://li.quest/v1/status?txHash=0xYOUR_TX_HASH&fromChain=8453' \
  --header "x-lifi-api-key: $LIFI_API_KEY"

传递fromChain以加速查询。

GET /v1/tools — 列出可用的桥接和交易所

curl -s --request GET \
  --url 'https://li.quest/v1/tools?chains=8453' \
  --header "x-lifi-api-key: $LIFI_API_KEY"

文档

• LLM文档：https://docs.li.fi/llms.txt
• OpenAPI：https://gist.githubusercontent.com/kenny-io/7fede47200a757195000bfbe14c5baee/raw/725cf9d4a6920d5b930925b0412d766aa53c701c/lifi-openapi.yaml