Uniswap V4 是去中心化金融（DeFi）领域的最新协议版本，由知名自动化做市商（AMM）平台 Uniswap 推出。该版本引入了高度模块化的架构设计，通过一个名为 Universal Router 的统一路由合约，实现了跨池交易、灵活费用结构和可编程钩子（hooks）等创新功能。目前，Uniswap V4 已在 Base 主网（8453）、以太坊主网（1）以及 Base Sepolia 测试网上部署，为开发者与用户提供更高效的链上交易体验。其核心亮点在于简化了流动性提供者的配置流程，同时支持更复杂的交易策略和定制化逻辑。 该工具集提供了一套完整的 TypeScript 脚本集合，用于与 Uniswap V4 协议进行交互。用户可以通过这些脚本读取池状态、获取实时报价、设置代币授权或直接执行兑换操作。所有脚本均基于命令行运行，支持环境变量配置，无需硬编码敏感信息。特别地，读操作如查询池信息或获取报价完全免费且无需私钥，而写操作如授权或交换则需要用户提供 `PRIVATE_KEY` 并通过安全方式注入。整个系统强调安全性与易用性，避免在日志或终端中泄露私钥，并严格限制输入验证以防止溢出或格式错误。 Uniswap V4 的设计理念是“单一池管理器 + 多池共存”，即所有流动性池由一个全局 PoolManager 合约管理，而每个池由其唯一的 Pool ID 标识——该 ID 由币种对、手续费等级、tick 间距及可选钩子地址共同决定。这种结构使得协议具备极高的扩展性和灵活性，允许第三方开发者通过自定义钩子实现如动态费用调整、闪电贷集成等功能。此外，V4 引入了 Permit2 授权机制，将 ERC20 代币的授权拆分为两步：从代币到 Permit2 再到 Universal Router，从而提升安全性并支持更精细的权限控制。
核心功能特点
- 支持读取 Uniswap V4 池状态，包括价格、流动性、手续费等信息，无需支付 Gas 费用
- 通过链上 V4Quoter 合约获取精确兑换报价，模拟交易结果但不实际执行
- 使用 Universal Router 执行单笔或多笔代币兑换，支持滑点控制和自动授权处理
- 采用 Permit2 两阶段授权机制，确保 ERC20 代币授权过程安全可靠
- 模块化脚本设计，涵盖池查询、报价、授权与交易全流程，适配开发者和普通用户
适用场景
Uniswap V4 工具特别适合需要快速接入或测试新流动性池的开发者。例如，当你在 Base 网络上部署了一个新的代币，并希望验证其与 ETH 或其他主流资产（如 USDC）之间的流动性深度时，可以使用 `pool-info.ts` 脚本来自动检测最优池并返回关键参数，如当前 tick、sqrtPriceX96 和总流动性，帮助你判断是否值得添加资金。对于量化交易团队而言，该工具提供的 `quote.ts` 接口极为实用，它利用链上 Quoter 合约模拟任意输入金额的输出结果，可用于构建套利模型或实时监控市场深度变化，而不会产生任何成本。 在日常 DeFi 使用中，普通用户也能受益于这套工具的简洁性与安全性。比如，当你想将持有的 WETH 兑换成 Base 生态内的稳定币 USDC，但又担心滑点过高导致损失，可以先运行 `quote.ts` 查看预期输出数量，再结合 `–slippage` 参数设定可接受的最大偏差（如 50 bps 表示 0.5%），最后通过 `swap.ts` 完成交易。若涉及首次使用某个 ERC20 代币，系统还会提示是否需要先运行 `approve.ts` 设置 Permit2 授权，整个过程透明可控。此外，借助 `–auto-approve` 选项，用户可在一次命令中完成授权与兑换，极大提升了操作效率。 对于审计人员或安全研究员来说，理解 Uniswap V4 的底层架构至关重要。PoolManager 作为唯一存储池数据的合约，其状态通过 StateView 公开可读；而每次 Swap 操作均由 Universal Router 发起，遵循 SWAP_EXACT_IN_SINGLE → SETTLE_ALL → TAKE_ALL 的动作序列。这种标准化流程不仅便于追踪交易路径，也为构建跨协议分析工具提供了清晰依据。无论是分析大额交易对市场的影响，还是验证自定义钩子的行为是否符合预期，这套工具都能提供可靠的数据入口和技术支撑。