LI.FI Skill

核心用法

LI.FI 是 DeFi 领域的流动性聚合基础设施，通过单一 API 整合 Across、Stargate、Hop 等 27 个跨链桥与 Uniswap、1inch 等 31 个 DEX，为 AI Agent 提供标准化的跨链交易能力。

主要功能流程

1. 链与资产查询：调用 /v1/chains 获取支持的 58+ 条链（EVM、Solana、Bitcoin、Sui），/v1/tokens 查询各链代币列表与实时价格
2. 报价获取：/v1/quote 返回单条最优路径，包含完整的 transactionRequest 对象（可直接签名执行）；/v1/advanced/routes 返回多路径对比
3. 交易执行：使用返回的 transactionRequest 字段（to/data/value/gasLimit/gasPrice）构建钱包调用，原生代币地址为 0x0000...0000
4. 状态追踪：/v1/status 通过源链 txHash 实时监控跨链状态，支持 DONE/COMPLETED、PARTIAL、REFUNDED 等终态判断

显著优点

• 深度聚合：无需单独对接多个桥/DEX，统一接口覆盖主流跨链场景
• 开箱即用：transactionRequest 直接返回可执行 calldata，Agent 无需自行构造交易
• 智能路由：支持按 FASTEST/CHEAPEST 排序，自动计算 slippage 保护与最小到账金额
• 多链兼容：同时支持 EVM、Solana(SVM)、Bitcoin(UTXO)、Sui(MVM) 四类异构链

局限性与风险

• 报价时效：Quote 约 60 秒过期，需及时执行或重新获取
• API 限制：公开访问有速率限制，生产环境需 LIFI_API_KEY
• 跨链延迟：不同桥的最终性时间差异大（数分钟至数小时），需向用户明确预期
• 合约风险：依赖底层桥/DEX 的智能合约安全，历史曾发生桥合约被盗事件
• 滑点与 MEV：大额交易仍受 AMM 滑点与跨链 MEV 影响

适合人群

• 构建跨链钱包、DeFi Agent、交易机器人的开发者
• 需要整合多链流动性但不想维护多个 SDK 的团队
• 追求交易路径最优化的量化策略与聚合前端

常规风险管控建议

• 大额交易前通过 /v1/connections 预检路由可用性
• 启用 maxPriceImpact 参数限制价格冲击
• 交易后持续轮询 /v1/status 直至终态，异常情况及时通知用户
• 建议用户小额测试后再执行大额跨链操作

核心用法

LI.FI 是领先的跨链流动性聚合协议，本 Skill 提供完整的 API 集成指南，支持以下核心场景：

1. 交易报价获取

• 调用 /v1/quote 获取包含 transactionRequest 的完整交易数据，可直接用于钱包签名
• 使用 /v1/advanced/routes 获取多路由对比，支持 FASTEST/CHEAPEST 排序偏好
• 自动聚合 Across、Stargate、Hop 等 27 个跨链桥与 Uniswap、1inch 等 31 个 DEX

2. 链与代币验证

• /v1/chains 获取 58+ 支持的区块链网络（EVM/SVM/UTXO/MVM）
• /v1/tokens 查询指定链的代币列表，包含价格、精度等元数据
• /v1/connections 验证特定链对/代币对的可用性

3. 交易执行与追踪

• /v1/status 实时追踪跨链交易状态（PENDING → DONE:COMPLETED）
• 提供 LI.FI Explorer 链接可视化交易进度

4. 钱包集成（Openclast）

• 解析 transactionRequest 字段自动填充 wallet_contract_call 参数
• 支持 gasLimit、gasPrice、maxFeePerGas 等 EIP-1559 参数透传

显著优点

• 深度聚合：单一 API 接入全行业跨链基础设施，无需单独集成多个桥
• 执行就绪：返回的 transactionRequest 可直接提交，无需本地构建 calldata
• 智能路由：自动优化路径（桥+DEX 组合），支持滑点保护与价格影响限制
• 广泛覆盖：支持 Ethereum、Solana、Bitcoin、Sui 等多类型链
• 生产级：知名 DeFi 协议，TVL 与交易量经市场验证

潜在局限

• 报价时效：报价约 60 秒过期，需及时执行
• API 限制：公开访问有速率限制，需 LIFI_API_KEY 解锁生产级配额
• 费用结构：包含 LIFI 固定费用（约 0.25%）+ 桥/DEX 底层费用
• 依赖外部：最终结算依赖底层桥的安全性与可用性
• 复杂性：多步交易（includedSteps）需按序执行，状态管理较复杂

适合人群

• 构建跨链钱包、DeFi 聚合器、交易机器人的开发者
• 需要统一跨链流动性接入的 dApp 团队
• 寻求替代手动桥接操作的高级用户（通过 Agent 自动化）

常规风险

| 风险类型 | 说明 | 缓解措施 |

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

| 智能合约风险 | 底层桥/DEX 合约漏洞 | 选择知名桥，关注审计报告 |

| 价格滑点 | 大额交易价格影响 | 设置 `maxPriceImpact` 参数 |

| 交易失败 | 报价过期或链上状态变化 | 快速执行，失败时重新报价 |

| API 密钥泄露 | `LIFI_API_KEY` 环境变量暴露 | 使用安全密钥管理服务 |

| 钓鱼域名 | 误访问伪造的 li.quest | 验证 HTTPS 证书与域名拼写 |