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.