LI.FI Skill

核心功能

LI.FI 是领先的跨链流动性聚合协议，通过单一 API 整合 27 座跨链桥（Across、Stargate、Hop 等）与 31 个 DEX（Uniswap、1inch、Curve 等），为 AI Agent 提供完整的链间资产流动解决方案。该技能覆盖四大核心能力：

1. 链与资产发现

• /chains 与 /tokens 端点支持查询 58+ 条链的元数据及代币价格
• 原生代币统一使用零地址 0x000...000 标识，简化人机交互

2. 智能路由报价

• /quote 返回含 transactionRequest 的完整可执行交易对象
• /advanced/routes 提供多路线比价，支持按速度（FASTEST）或成本（CHEAPEST）优化
• 自动处理滑点保护（slippage）、价格冲击（maxPriceImpact）与费用透明化拆分

3. 交易构建与执行

• 输出字段直接兼容 EIP-1559 交易格式（value, to, data, gasLimit）
• 原生支持与 openclast-wallet 等工具集成，通过 wallet_send 完成签名广播

4. 状态追踪

• /status 端点实时追踪跨链交易状态（PENDING → DONE/FAILED）
• 提供 LI.FI 官方浏览器链接与原子级事件日志

显著优势

• 聚合深度：无需逐个对接桥协议，单一 API 覆盖 90%+ 主流跨链路径
• 多链兼容：EVM、SVM（Solana）、UTXO（Bitcoin）、MVM（Sui）统一抽象
• 报价即执行：/quote 直接返回链上可执行的 calldata，减少二次交互
• 费用透明：feeCosts/gasCosts 字段拆分 integratorFee、lifiFee 与网络费

局限性与风险

• 时效约束：报价约 60 秒过期，需及时执行或重新获取
• API 依赖：高频调用需 LIFI_API_KEY，否则面临速率限制
• 桥接风险：底层桥协议（如 Nomad、Multichain 历史事件）存在智能合约与托管风险，LI.FI 仅作聚合不承保资产损失
• 滑点与 MEV：高波动资产在跨链过程中可能遭遇夹心攻击或预言机延迟

适用人群

• 开发跨链 DeFi 应用的 AI Agent 与自动化策略
• 需要统一多链流动性入口的钱包与交易平台
• 构建跨链支付、套利或再平衡机器人的开发者

安全建议

• 生产环境务必配置 LIFI_API_KEY 并监控速率使用情况
• 大额交易前通过 /connections 预验证路线可用性
• 启用 maxPriceImpact 限制避免极端市场条件下的意外损失

核心用法

LI.FI 是一个去中心化跨链聚合协议，通过统一 API 实现多链资产桥接与兑换。核心工作流程遵循「查询-报价-执行-追踪」四步模式：

1. 网络与资产发现

• 调用 /chains 获取支持的区块链网络（EVM、Solana、Bitcoin、Sui 等）
• 调用 /tokens 查询指定链上的可用代币，包含合约地址、精度、实时价格

2. 路由报价

• /quote：获取单一最优路径的完整交易数据（推荐常规场景）
• /advanced/routes：获取多路径对比选项，支持桥接/DEX 白名单过滤
• 关键参数：链 ID、代币地址、金额（最小单位）、滑点容忍度、发送地址

3. 交易构建与执行

• 报价返回的 transactionRequest 包含可直接签名的交易对象（to/data/value/gasLimit）
• 若为 ERC20 代币，需先向 estimate.approvalAddress 完成授权
• 结合钱包工具（如 openclast-wallet）完成签名广播

4. 状态追踪

• /status 通过源链交易哈希实时监控跨链进度
• 状态映射：PENDING → DONE(COMPLETED/PARTIAL/REFUNDED) / FAILED
• 提供 LI.FI Explorer 可视化追踪链接

显著优点

• 聚合深度：整合 27+ 跨链桥与 31+ DEX，自动选择最优路径
• 多链覆盖：支持 58+ 主流网络，涵盖 EVM、非 EVM 异构链
• 实时透明：完整费用拆解（桥接费、Gas 费、价格影响），60 秒报价有效期
• 开发者友好：OpenAPI 规范文档、LLM 优化文本、curl 即用示例
• 安全合规：纯文档型 Skill，无本地代码执行，API Key 环境变量管理

潜在局限

• API 依赖：核心功能完全依赖 LI.FI 中心化服务可用性
• 密钥门槛：生产环境需申请 LIFI_API_KEY，否则受速率限制
• 时效约束：报价约 60 秒过期，复杂市场波动下可能频繁重新报价
• 滑点风险：跨链桥流动性碎片化，大额交易可能触发较高价格影响
• Gas 波动：目标链 Gas 价格变化可能导致实际到账与预估偏差

适合人群

• DeFi 开发者：构建跨链钱包、DEX 聚合器、收益优化策略
• 交易机器人：需要程序化执行多链套利、再平衡、清算策略
• Web3 应用：为 DApp 提供无缝跨链兑换体验，无需自建桥接基础设施
• 机构运营：管理多链财库，执行大额、低频、低滑点资产迁移

常规风险

| 风险类型 | 说明 | 缓释建议 |

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

| 桥接合约风险 | 底层桥接协议（Across、Stargate 等）可能存在智能合约漏洞 | 优先选择经过审计、TVL 较高的桥接方案 |

| 价格滑点 | 大额兑换或低流动性代币可能产生意外损失 | 设置保守的 `maxPriceImpact` 参数，分笔执行 |

| 交易失败 | 目标链拥堵或桥接流动性不足导致交易卡住 | 监控 `substatus`，必要时触发退款流程 |

| API 服务中断 | 中心化服务不可用导致无法报价或追踪 | 实现指数退避重试，备用路由方案 |

| 授权额度管理 | ERC20 授权给聚合合约存在潜在风险 | 遵循最小授权原则，定期撤销闲置授权 |