核心功能
本技能提供完整的 Uniswap V3/V4 流动性池链上分析能力，基于 viem 框架实现高效可靠的数据获取。
主要用法
1. 池状态查询
- 通过
slot0读取实时价格（sqrtPriceX96 编码）、当前 tick、预言机状态等核心参数 - 直接获取
liquidity值了解活跃流动性规模
2. 价格转换计算
- sqrtPriceX96 → 实际价格：
(sqrtPriceX96 / 2^96)^2，需处理代币精度差异 - Tick → 价格：
1.0001^tick，每个 tick 代表 0.01% 的价格变动
3. 流动性分布分析
- 遍历
tickBitmap定位初始化 tick - 读取
ticks()获取各价格点净流动性变化（liquidityNet） - 累积计算全区间流动性分布，支持可视化 TVL 热力图
4. 多链兼容
- 通过
chainId参数无缝切换 Ethereum、Arbitrum、Base 等网络 - 自动解析工厂地址、预言机合约等配置
显著优势
- 数据权威性：直接读取链上合约，杜绝 API 延迟或篡改风险
- 计算精确性：原生处理 bigint 与大数运算，避免 JavaScript 精度丢失
- 架构灵活性：模块化设计支持 V3/V4 双版本及未来升级
局限与风险
| 类别 | 说明 |
|------|------|
| 数据覆盖 | 仅获取当前快照，历史流动性变化需额外索引事件日志 |
| 计算成本 | 全 tick 遍历在流动性密集池（如 USDC/ETH 0.05%）可能产生数百次 RPC 调用 |
| 预言机依赖 | 价格数据源自链上最新状态，非 TWAP，极端行情下易受瞬时操纵 |
| 精度边界 | 极低流动性池的价格计算可能因除数过小而失真 |
适用人群
- DeFi 策略研究员与量化交易员
- 流动性提供者（LP）进行无常损失预估
- 审计与安全团队监控异常池状态
- 开发者构建收益聚合器或套利机器人
常规风险提示
- RPC 可靠性：建议配置多节点 fallback，防止单点故障导致数据中断
- Gas 优化：批量查询合约时使用 multicall 减少网络往返
- 价格验证：关键决策应交叉比对链下预言机（如 Chainlink）与链上报价