Back to Details

migrator-uniswap-v3

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
Source References: Use Doppler deployments as the contract source of truth for deployed addresses and revisions.
来源参考：请以Doppler部署文件作为已部署合约地址和版本的权威源码。

Uniswap V3 Migrator

Uniswap V3 迁移器

When to use

使用场景

  • The target network is legacy and does not support Uniswap V4.
  • Custom fee requirements make V3 migration necessary for this launch.
  • You need to verify Airlock-to-migrator handoff for a V3 destination.
  • 目标网络为旧版网络，不支持Uniswap V4。
  • 自定义手续费要求使得本次启动必须使用V3迁移方案。
  • 您需要验证针对V3目标地址的Airlock到迁移器的交接流程。

Prerequisites

前提条件

  • Confirm V4 is unavailable on the target network.
  • Confirm custom fee requirements are explicit and approved.
  • Confirm 
    liquidityMigrator
    points to the intended V3 migrator implementation.
  • 确认目标网络不支持V4。
  • 确认自定义手续费要求明确且已获批准。
  • 确认
    liquidityMigrator
    指向预期的V3迁移器实现合约。

Core workflow

核心流程

  1. Validate V3-only + custom-fee gating decision.
  2. Trace 
    Airlock.migrate(asset)
    into migrator handoff.
  3. Verify V3 destination position/pool state after migration.
  4. Validate recipient/locker ownership and post-migration balances.
  1. 验证“仅V3网络+自定义手续费”的准入决策。
  2. 追踪
    Airlock.migrate(asset)
    到迁移器的交接流程。
  3. 验证迁移完成后V3目标仓位/资金池的状态。
  4. 验证接收方/锁定合约的所有权及迁移后的余额。

Quick facts

关键信息

ItemDetail
Entrypoint caller
Airlock.migrate(asset)
Handoff call
liquidityMigrator.migrate(...)
Canonical source file
doppler/src/migrators/UniswapV3Migrator.sol
Policy postureConditional fallback: v3-only network + custom fees required
项目详情
入口调用方
Airlock.migrate(asset)
交接调用
liquidityMigrator.migrate(...)
标准源码文件
doppler/src/migrators/UniswapV3Migrator.sol
策略定位条件回退方案：仅适用于纯V3网络且需要自定义手续费的场景

Failure modes

失败场景

  • Selecting V3 while V4 is available.
  • Selecting V3 without a strict custom-fee requirement.
  • Wrong V3 fee-tier/tick-spacing assumptions for destination liquidity.
  • Token orientation mismatch between Airlock output and V3 destination setup.
  • 在V4可用的情况下选择V3方案。
  • 无明确自定义手续费要求时选择V3方案。
  • 对目标流动性的V3手续费层级/刻度间距做出错误假设。
  • Airlock输出的代币方向与V3目标设置不匹配。

References

参考资料

  • OVERVIEW.md
  • INTERFACE.md
  • VERIFICATION.md
  • liquidity-migration
  • airlock
  • verification
  • OVERVIEW.md
  • INTERFACE.md
  • VERIFICATION.md
  • liquidity-migration
  • airlock
  • verification