Source References: Code citations link to raw GitHub files pinned to commit 46bad16d.

V4 Dynamic Auction

When to use

• Tasks involving src/initializers/Doppler.sol or src/initializers/UniswapV4Initializer.sol
• Questions about epoch rebalancing, gamma, tick accumulator, slug mechanics, or proceeds thresholds
• Debugging why a dynamic auction rebalanced, exited early, or entered insufficient-proceeds mode

Prerequisites

• Understand token0 < token1 ordering and tick direction
• Know the sale asset and numeraire for the target pool
• Have access to Foundry (forge, cast) and a V4-capable RPC endpoint

Core workflow

1. Decode the initialization config (startingTick, endingTick, gamma, epochLength, numTokensToSell, proceeds bounds).
2. Confirm epoch state (lastEpoch, tickAccumulator, totalTokensSold, totalProceeds).
3. Evaluate rebalance mode for the current epoch:
   • Max adjustment (no/low sales)