核心用法
/lifi 是一个跨链流动性聚合工具，通过单一 API 实现多链资产的无缝流转。核心功能包括：
1. 跨链兑换与桥接
- 支持 35+ 条区块链（EVM 及 Solana）
- 自动聚合 Stargate、Hop、Across、CCTP 等 20+ 跨链桥
- 集成 Uniswap、SushiSwap、1inch、Curve 等 DEX 进行末端兑换
- 智能路由算法按 RECOMMENDED（推荐）、FASTEST（最快）、CHEAPEST（最便宜）、SAFEST（最安全）四维度优化
2. 高级路由比较/advanced/routes 端点可同时返回多条可行路径，用户可对比输出金额、费用、耗时后自主选择。
3. 异步交易追踪
跨链操作非原子性，需通过 /status 轮询追踪。状态包括：PENDING（进行中）、DONE+COMPLETED（完成）、DONE+PARTIAL（部分完成，需手动兑换）、DONE+REFUNDED（已退款）、FAILED（失败）。
4. Zap 一键式 DeFi 组合quote/contractCalls 支持桥接+兑换+质押/存款等复杂操作一次性签名执行，如"ETH 跨链到 Polygon 并存入 Aave"。
显著优点
- 深度聚合：单点接入覆盖全市场流动性，无需逐个对比桥与 DEX
- 路径透明：每笔交易展示完整路由步骤与预估费用
- 灵活排序：可按速度、成本、安全性自定义偏好
- 无许可：基础功能无需 API Key，公开可用
- 原生代币支持：统一用零地址（0x0000...0000）表示各链原生资产
潜在缺点与局限性
- 非原子风险：跨链桥依赖第三方中继，存在资金在途风险；历史上跨链桥是黑客重灾区（2022 年跨链桥被盗超 20 亿美元）
- 依赖外部桥安全性：LI.FI 本身不托管资金，但路由选择的桥（如 Stargate、Hop）各自有智能合约风险
- 部分完成复杂性：PARTIAL 状态需要用户手动处理末端兑换，对新手不友好
- gas 与滑点管理：需自行设置滑点容忍度，高波动市场可能出现滑点错误
- 退款延迟：失败交易退款可能耗时数小时至数天
适合人群
- 频繁跨链的 DeFi 活跃用户
- 追求最优汇率的交易者
- 需要一键完成复杂多步操作的高级用户
- 多链投资组合管理者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 智能合约风险 | 所经过的桥与 DEX 合约被攻击 |
| 预言机/价格操纵 | 小众代币在 DEX 上流动性浅薄，易被三明治攻击 |
| 中继器风险 | 跨链消息传递依赖第三方验证者 |
| MEV 攻击 | 公开 mempool 的交易可能被抢跑 |
| 滑点损失 | 市场波动导致实际收到的代币数量低于预期 |
| API 依赖 | 429 限流可能影响紧急交易；建议配置 LIFI_API_KEY |
安全建议
1. 大额交易前先用小额测试完整路径
2. 优先选择 SAFEST 排序选项降低桥风险
3. 跨链后立即追踪状态，确认到账再执行下游操作
4. 对 PARTIAL 状态保持警觉，准备手动完成末端兑换
5. 定期关注 LI.FI 及所使用桥的安全公告
---
来源：LI.FI 官方文档 (li.quest/v1)