v4-multicurve-auction

Original🇺🇸 English
Translated

Reference for Doppler V4 multicurve auctions across base, scheduled, and decay variants; covers shares-based curve allocation, locked vs migrable pools, and migration constraints.

1installs
Added on

NPX Install

npx skill4agent add rustydotwtf/doppler-skills v4-multicurve-auction
Source References: Code citations link to raw GitHub files pinned to commit
46bad16d
.

V4 Multicurve Auction

When to use

  • You are configuring or debugging multicurve launches on V4
  • You need curve share math and position distribution behavior
  • You need locked vs migrable pool semantics

Prerequisites

  • Confirm curve set and share total (
    WAD
    exact)
  • Decide variant:
    • Base multicurve (
      UniswapV4MulticurveInitializer
      )
    • Scheduled multicurve (
      UniswapV4ScheduledMulticurveInitializer
      )
    • Decay multicurve (
      DecayMulticurveInitializer
      )

Core workflow

  1. Build
    Curve[]
    and validate shares/tick spacing.
  2. Initialize pool with selected variant.
  3. Confirm status path:
    • Initialized
      (migrable, no beneficiaries)
    • Locked
      (beneficiaries configured)
  4. Track progression to far-tick exit (for migrable pools).
  5. If locked, use fee collection paths instead of migration exits.

Quick facts

ItemDetail
Main contracts
UniswapV4MulticurveInitializer
,
UniswapV4ScheduledMulticurveInitializer
,
DecayMulticurveInitializer
Allocation modelShares-based across independent curves
RebalancingNone (static positions)
Hook variantsScheduled start-time hook, decay fee-schedule hook

Failure modes

  • Curve shares not summing to
    WAD
  • Tick spacing misalignment
  • Treating locked pools as migrable
  • Wrong assumptions about scheduled start or decaying fee behavior

References

  • PARAMETERS.md
  • FLOW.md
  • FORMULAS.md
  • GOTCHAS.md
  • VARIANTS.md

Related skills

  • v4-dynamic-auction
  • doppler-hook-initializer
  • fee-architecture
  • verification