核心用法
Uniswap V4 技能提供完整的链上 DeFi 交易基础设施，支持代币兑换、池子状态读取、报价查询等核心功能。技能采用模块化脚本设计，通过 npx tsx 直接执行，无需复杂配置。
读取操作（无需私钥）：使用 pool-info.ts 获取任意池子的实时状态，包括价格、流动性、手续费等关键指标；quote.ts 通过链上 V4Quoter 合约模拟交易，返回预期输出金额和 gas 估算。
写入操作（需私钥）：approve.ts 执行双步 Permit2 授权流程（ERC20 → Permit2 → Universal Router）；swap.ts 执行精确输入兑换，内置自动报价和滑点保护机制。支持 --auto-approve 首次代币自动授权。
技能严格区分主网（Base 8453、Ethereum 1）和测试网（Base Sepolia 84532），所有合约地址均来自官方 Uniswap 文档并经验证。
显著优点
1. 安全架构卓越：私钥仅通过 PRIVATE_KEY 环境变量获取，CLI 明确拒绝 --private-key 参数，CI 测试防止密钥泄露至日志。
2. 输入验证严格：地址格式校验、金额 BigInt 边界检查、滑点范围限制（0-10000 bps），杜绝常见攻击向量。
3. 代码质量优秀：TypeScript 严格类型、无危险函数（eval/exec）、依赖单一可信库 ethers.js v6，静态分析得分 85。
4. 用户体验友好：自动识别最优流动性池、支持 ETH 原生输入、JSON 输出便于集成，错误处理表格覆盖常见失败场景。
5. 官方合约保障：所有 PoolManager、UniversalRouter、V4Quoter 等地址直接引用 Uniswap 官方文档，附带字节码验证防止钓鱼。
潜在缺点与局限性
- 网络依赖性强：必须配置可靠 RPC 节点，公共节点存在延迟和限速风险，建议用户自备 Alchemy/Infura 私有节点。
- 仅限 EVM 链：当前仅支持 Base 和 Ethereum，不支持 Solana、Cosmos 等非 EVM 生态。
- V4 生态早期：部分代币对可能尚未创建 V4 池子，需回退至 V3/V2 或其他 DEX，技能会明确返回
No V4 pool found错误。
- Gas 成本波动：链上交易费用随网络拥堵变化，大额兑换建议先通过
quote.ts预估成本。
适合的目标群体
- 专业 DeFi 交易者：需要程序化执行套利、流动性管理策略
- 量化开发团队：构建自动化交易系统，依赖标准化 CLI 接口
- Web3 项目方：集成代币兑换功能到自有产品，降低智能合约开发成本
- 安全敏感型用户：重视私钥管理、审计完整的机构级需求
使用风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 私钥泄露 | 环境变量配置错误或被日志记录 | 严格遵循 SECURITY 章节指引，使用专用密钥管理服务 |
| 合约风险 | 与 Uniswap V4 协议交互，虽经审计但仍存智能合约漏洞可能 | 控制单笔交易金额，分散持仓 |
| 滑点损失 | 极端行情下实际成交价偏离预期 | 合理设置 `--slippage` 参数，紧急情况提高容忍度 |
| RPC 故障 | 节点不可用或返回错误数据 | 配置多节点 fallback，优先使用私有 RPC |
| 依赖过时 | ethers.js 未来版本可能存在兼容性问题 | 关注官方更新，锁定 package.json 版本 |
建议新用户先在 Base Sepolia 测试网完成全流程验证，再迁移至主网操作。