LI.FI Skill

核心用法

LI.FI 是一个跨链流动性聚合协议，通过单一 API 整合 27 个跨链桥和 31 个去中心化交易所，为 AI Agent 提供完整的跨链与链内兑换能力。

主要功能

• 路由报价：调用 /v1/quote 获取实时兑换路径，包含预估输出金额、gas 成本、滑点保护及可直接签名的交易数据
• 多桥比价：通过 /v1/advanced/routes 获取多个备选路径，支持按速度或成本排序
• 状态追踪：使用 /v1/status 实时监控跨链交易进度，识别完成、部分到账或退款状态
• 链/代币验证：/chains 和 /tokens 端点支持 58+ 网络（EVM、Solana、Bitcoin、Sui）及数千种代币的元数据查询

显著优点

• 深度聚合：无需单独对接每个桥接协议，一次集成覆盖主流跨链基础设施
• 交易即服务：返回的 transactionRequest 包含完整的交易参数（to/data/value/gas），可直接提交钱包执行
• 灵活筛选：支持白名单/黑名单指定桥接器、DEX，以及最大价格影响控制
• LLM 友好：提供结构化文档索引（https://docs.li.fi/llms.txt）和 OpenAPI 规范，便于 AI 解析

潜在局限

• 报价时效性：报价约 60 秒过期，需及时执行
• API 限流：免费层级有速率限制，生产环境需配置 LIFI_API_KEY
• 复杂度门槛：多步骤路由需分别获取每一步的交易数据
• 链上风险：依赖底层桥接协议的安全性，LI.FI 本身不担保资金到账

适合人群

• 构建多链 DeFi 策略的 AI Agent 开发者
• 需要自动化跨链资金调度的机构或 DAO
• 希望简化跨链集成的钱包或交易应用

常规风险

• 桥接风险：底层桥接合约可能存在漏洞或中心化风险
• 滑点与 MEV：市场波动可能导致实际到账低于预估
• Gas 波动：网络拥堵时交易可能失败或成本超支
• API 依赖：服务中断或响应延迟可能影响交易时机

核心功能

LI.FI Agent Skill 是面向 AI 代理的跨链流动性聚合工具，通过标准化 API 接口实现多链资产的无缝转移与兑换。该 Skill 本质上是一份详尽的 API 集成指南，无本地可执行代码，完全依赖 LI.FI 官方服务（https://li.quest）完成核心操作。

显著优点

1. 极致的多链覆盖能力

• 支持 58+ 条区块链网络，涵盖 EVM（以太坊、Arbitrum、Base 等）、SVM（Solana）、UTXO（Bitcoin）、MVM（Sui）四大链类型
• 聚合 27+ 桥接协议（Across、Stargate、Hop 等）与 31+ DEX（Uniswap、1inch、Curve 等）
• 自动选择最优路由，支持 FASTEST 与 CHEAPEST 两种优化策略

2. 完整的功能闭环

• 链/代币发现：/chains、/tokens 端点提供标准化的链配置与代币元数据
• 智能报价：/quote 返回包含完整 transactionRequest 的可执行交易数据
• 状态追踪：/status 提供跨链交易全生命周期监控，支持 PENDING、DONE、FAILED 等状态
• 高级路由：/advanced/routes 支持多路径对比，/advanced/stepTransaction 分步构建复杂交易

3. 生产级集成设计

• 支持 API 密钥认证（LIFI_API_KEY）获取更高限流
• 与 Openclast Wallet 深度集成，提供从报价到签名的完整工作流
• 详尽的 OpenAPI 规范与 LLM 友好文档（https://docs.li.fi/llms.txt）

4. 安全与透明

• 费用完全透明：feeCosts 拆分平台费与桥接费，gasCosts 预估精确到 limit/price
• 滑点保护机制：toAmountMin 保证最小接收量，slippage 参数可配置
• 报价有效期约 60 秒，防止陈旧交易

潜在局限与风险

1. 外部服务强依赖

• 纯文档型 Skill，无本地执行能力，完全依赖 LI.FI 基础设施可用性
• 若 LI.FI API 变更、限流或中断，功能立即失效
• GitHub Gist 托管的 OpenAPI 规范存在单点故障风险

2. DeFi 固有风险

• 智能合约风险：桥接协议与 DEX 合约可能存在未披露漏洞
• 市场波动风险：跨链确认期间价格波动可能导致实际收益低于预期
• 交易失败风险：目标链拥堵可能导致 PENDING 状态持续数小时，极端情况下触发退款

3. 使用门槛

• 需要理解 fromAmount 的最小单位转换（如 USDC 需 ×10⁶）
• slippage 参数为 decimal 格式（0.005 = 0.5%），易与百分比混淆
• 跨链交易涉及多步骤签名，新手用户可能产生困惑

4. API 密钥管理负担

• 生产环境需配置 LIFI_API_KEY，密钥泄露可能导致未授权使用与费用损失
• 公共访问存在严格限流，不适合高频场景

适合人群

• 多链 DeFi 用户：需要在以太坊、Layer2、Solana 等网络间快速转移资产
• 量化交易团队：寻求程序化跨链套利与流动性优化的自动化方案
• 钱包开发者：需要集成标准化跨链功能的第三方钱包应用
• DAO 财库管理：执行跨链资金调度与多元化资产配置

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 外部 API 依赖 | 中 | 服务中断直接导致功能失效 |

| 智能合约风险 | 中 | 桥接/DEX 合约漏洞可能造成资金损失 |

| 密钥泄露风险 | 低-中 | API 密钥管理不当导致未授权访问 |

| 交易失败风险 | 低 | 跨链确认延迟或失败，资金原路返还 |

| 价格波动风险 | 低-中 | 大额交易滑点或确认期价格变动 |

建议用户：小额测试验证路径、仔细核对 transactionRequest 参数、监控交易状态、使用官方 LI.FI Explorer 交叉验证。