Back to Details

v4-multicurve-auction

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
Source References: Code citations link to raw GitHub files pinned to commit 
46bad16d
.
来源参考：代码引用链接指向固定在提交
46bad16d
的GitHub原始文件。

V4 Multicurve Auction

V4多曲线拍卖

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
  • 您正在配置或调试V4上的多曲线启动流程
  • 您需要了解曲线份额计算和头寸分配机制
  • 您需要明确锁定池与可迁移池的语义差异

Prerequisites

前置条件

  • Confirm curve set and share total (
    WAD
    exact)
  • Decide variant:
    • Base multicurve (
      UniswapV4MulticurveInitializer
      )
    • Scheduled multicurve (
      UniswapV4ScheduledMulticurveInitializer
      )
    • Decay multicurve (
      DecayMulticurveInitializer
      )
  • 确认曲线集合和总份额（精确到
    WAD
    ）
  • 选择变体类型：
    • 基础多曲线（
      UniswapV4MulticurveInitializer
      ）
    • 定时多曲线（
      UniswapV4ScheduledMulticurveInitializer
      ）
    • 衰减多曲线（
      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.
  1. 构建
    Curve[]
    并验证份额/ tick间距。
  2. 使用选定的变体初始化池。
  3. 确认状态路径： 
    • Initialized
      （可迁移，无受益人）
    • Locked
      （已配置受益人）
  4. 跟踪可迁移池到远端tick退出的进度。
  5. 如果是锁定池，使用费用归集路径而非迁移退出。

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
项目详情
核心合约
UniswapV4MulticurveInitializer
、
UniswapV4ScheduledMulticurveInitializer
、
DecayMulticurveInitializer
分配模型基于份额的独立曲线分配
再平衡机制无（头寸固定）
Hook变体定时启动Hook、衰减费率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
  • 曲线份额总和不等于
    WAD
  • Tick间距不匹配
  • 将锁定池误当作可迁移池处理
  • 对定时启动或衰减费率行为存在错误假设

References

参考文档

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

Related skills

相关技能

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