migrator-uniswap-v4
Source References: Use Doppler deployments as the contract source of truth for deployed addresses and revisions.
Uniswap V4 Migrator
When to use
- You are integrating Doppler's preferred migration destination (Uniswap V4).
- You need to reason about V4 standard migration vs split migration behavior.
- You are validating migrator outputs after
Airlock.migrate(asset).
Prerequisites
- Confirm
liquidityMigratorpoints to the intended V4 migrator path. - Confirm whether split distribution is required (
UniswapV4MigratorSplit). - Confirm asset/numeraire orientation and recipient/locker settings.
Core workflow
- Trace
Airlock.migrate(asset)through initializer exit and migrator handoff. - Validate selected V4 migrator path:
UniswapV4MulticurveMigratorUniswapV4MigratorSplit
- Verify destination V4 liquidity state and recipient/locker outcomes.
- If split mode is active, verify split recipient payout and top-up pull-up behavior.
Quick facts
| Item | Detail |
|---|---|
| Entrypoint caller | Airlock.migrate(asset) |
| Handoff call | liquidityMigrator.migrate(...) |
| Core contracts | UniswapV4MulticurveMigrator, UniswapV4MigratorSplit |
| Preferred posture | Canonical migration path for v4-capable deployments |
Failure modes
- Misconfigured V4 migrator wiring in Airlock.
- Wrong migrator selection for expected split/non-split behavior.
- Incorrect
isToken0orientation in split configuration. - Assuming split/top-up hooks are active without explicit split migrator 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