migrator-uniswap-v2
Source References: Use Doppler deployments as the contract source of truth for deployed addresses and revisions.
Uniswap V2 Migrator
When to use
- You are integrating a legacy migration destination based on Uniswap V2 pools.
- You need to verify Airlock-to-migrator handoff behavior for the V2 path.
- You are auditing compatibility behavior on networks where V4 migration is not used.
Prerequisites
- Confirm
liquidityMigratoris configured to the V2 migrator implementation. - Confirm migration policy allows V2 for this launch.
- Confirm asset/numeraire token ordering and destination recipient assumptions.
Core workflow
- Trace
Airlock.migrate(asset)up to migrator handoff. - Verify post-fee balances sent by Airlock to the V2 migrator path.
- Verify V2 destination liquidity state after migration.
- Validate recipient/locker ownership of migrated liquidity.
Quick facts
| Item | Detail |
|---|---|
| Entrypoint caller | Airlock.migrate(asset) |
| Handoff call | liquidityMigrator.migrate(...) |
| Canonical source file | doppler/src/migrators/UniswapV2Migrator.sol |
| Policy posture | Compatibility path, not the preferred default |
Failure modes
- Wrong
liquidityMigratorwiring for a V2 target. - Migrating to V2 when a preferred V4 path is available for the same launch policy.
- Token orientation mismatch between Airlock output and destination pool assumptions.
- Assuming V4-only features (split/top-up hooks) exist on the V2 path.
References
More from rustydotwtf/doppler-skills
fee-architecture
Reference for Doppler fee collection, distribution, and configuration across Airlock, FeesManager, locker contracts, and hook-based fee paths.
9token-lifecycle
Reference for Doppler token creation, vesting, inflation, and factory selection across DERC20, DERC2080, CloneERC20, and CloneDERC20VotesV2 paths.
9uniswap-fundamentals
Reference for Uniswap V3/V4 concepts used in Doppler development, including tick math, sqrtPriceX96, concentrated liquidity formulas, and V4 hooks/singleton architecture.
9verification
Verify on-chain Doppler behavior with cast, viem, RPC, and explorers for dynamic auctions, multicurve launches, hook initializer state, and migration flows.
8proceeds-split-migration
Configure and verify migration-time proceeds split flows using `ProceedsSplitter`, `TopUpDistributor`, `UniswapV4MigratorSplit`, and `UniswapV4MigratorSplitHook`.
7rehype
Operate, configure, test, and deploy Doppler's Rehype V4 hook for buybacks, beneficiary fees, and airlock-owner fee claims.
4