migrator-uniswap-v3
Source References: Use Doppler deployments as the contract source of truth for deployed addresses and revisions.
Uniswap V3 Migrator
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.
Prerequisites
- Confirm V4 is unavailable on the target network.
- Confirm custom fee requirements are explicit and approved.
- Confirm
liquidityMigratorpoints to the intended V3 migrator implementation.
Core workflow
- Validate V3-only + custom-fee gating decision.
- Trace
Airlock.migrate(asset)into migrator handoff. - Verify V3 destination position/pool state after migration.
- Validate recipient/locker ownership and post-migration balances.
Quick facts
| Item | Detail |
|---|---|
| Entrypoint caller | Airlock.migrate(asset) |
| Handoff call | liquidityMigrator.migrate(...) |
| Canonical source file | doppler/src/migrators/UniswapV3Migrator.sol |
| Policy posture | Conditional fallback: v3-only network + custom fees required |
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.
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