🎯

v4-multicurve-auction

🎯Skill

from rustydotwtf/doppler-skills

What it does

Distributes tokens across multiple independent curves with static, shares-based allocation using Uniswap V4 multicurve auction mechanics.

📦

Part of

rustydotwtf/doppler-skills(8 items)

v4-multicurve-auction

Installation

Quick InstallInstall with npx

npx skills add rustydotwtf/doppler-skills

📖 Extracted from docs: rustydotwtf/doppler-skills

Need more details? View full documentation on GitHub →

1Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Reference for Doppler V4 multicurve auctions. Use when working with multiple independent curves, shares-based allocation, Migrable vs Locked pools, or static V4 position distribution. Covers curve configuration, beneficiaries, and log-normal distribution.

Overview

> Source References: Code citations link to raw GitHub files pinned to commit 988dab4. To fetch specific lines: curl -s "" | sed -n 'START,ENDp'

# V4 Multicurve Auction

A V4 multicurve auction distributes tokens across multiple independent curves with shares-based allocation. Unlike V4 dynamic auctions, multicurve positions are static (no rebalancing). Supports both Migrable and Locked pool modes.

Key Contracts

| Contract | Path | Purpose |

|----------|------|---------|

| UniswapV4MulticurveInitializer | src/initializers/UniswapV4MulticurveInitializer.sol | Main multicurve initializer |

| Multicurve | src/libraries/Multicurve.sol | Position/curve calculations (library) |

| UniswapV4MulticurveMigrator | src/migrators/UniswapV4MulticurveMigrator.sol | Migration with offset adjustment |

Multicurve vs V4 Dynamic (Comparison)

| Aspect | V4 Multicurve | V4 Dynamic |

|--------|---------------|------------|

| Curves | Multiple independent | Single with 3 slugs |

| Rebalancing | None (static) | Every epoch |

| Configuration | Shares-based | Gamma/epoch-based |

| Position count | Fixed at init | Variable |

| Tick tracker | None | tickAccumulator |

| Exit condition | Price at far tick | Proceeds thresholds |

| Locked mode | With beneficiaries | N/A |

Quick Facts

| Fact | Value | Source |

|------|-------|--------|

| Precision constant | WAD = 1e18 | Multicurve.sol:16 |

| Share validation | Sum must equal WAD exactly | Multicurve.sol:99 |

| Position salt | curveIndex * numPositions + positionIndex | Multicurve.sol:219 |

| Pool status enum | Uninitialized, Initialized, Locked, Exited | UniswapV4MulticurveInitializer.sol:57-62 |

Curve Structure

```solidity

struct Curve {

int24 tickLower;

int24 tickUpper;

uint16 numPositions;

uint256 shares; // Must sum to WAD across all curves

}

```

[Source: Multicurve.sol](https://raw.githubusercontent.com/whetstoneresearch/doppler/988dab4/src/libraries/Multicurve.sol) (lines 29-34)

Two Pool Modes

|------|-----------|--------------|----------|

[Source: UniswapV4MulticurveInitializer.sol](https://raw.githubusercontent.com/whetstoneresearch/doppler/988dab4/src/initializers/UniswapV4MulticurveInitializer.sol) (lines 189)

Parameters Quick Reference

| Parameter | Type | Description |

|-----------|------|-------------|

| curves[] | Curve[] | Array of independent curve configs |

| curves[i].shares | uint256 | WAD fraction (all must sum to 1e18) |

| curves[i].numPositions | uint16 | Positions within this curve |

| beneficiaries[] | BeneficiaryData[] | If empty: Migrable; if set: Locked |

| fee | uint24 | Pool fee tier |

| tickSpacing | int24 | Pool tick spacing |

[Detailed parameters](references/PARAMETERS.md)

Pool Status States

| Status | Condition | Exit Allowed |

|--------|-----------|--------------|

| Uninitialized | Before init | N/A |

| Initialized | No beneficiaries | Yes (at far tick) |

| Locked | With beneficiaries | No (permanent) |

| Exited | After exitLiquidity | N/A |

[Source: UniswapV4MulticurveInitializer.sol](https://raw.githubusercontent.com/whetstoneresearch/doppler/988dab4/src/initializers/UniswapV4MulticurveInitializer.sol) (lines 57-62)

Common Tasks

Understanding parameters: See [PARAMETERS.md](references/PARAMETERS.md)
Understanding the lifecycle: See [FLOW.md](references/FLOW.md)
Understanding the math: See [FORMULAS.md](references/FORMULAS.md)
Avoiding pitfalls: See [GOTCHAS.md](references/GOTCHAS.md)

Related Skills

[fee-architecture](../fee-architecture/SKILL.md) - Fee collection and beneficiary distribution
[token-lifecycle](../token-lifecycle/SKILL.md) - Vesting and inflation mechanics
[v4-dynamic-auction](../v4-dynamic-auction/SKILL.md) - Dynamic V4 auctions with epoch rebalancing
[uniswap-fundamentals](../uniswap-fundamentals/SKILL.md) - Tick math and V4 architecture

More from this repository7

🎯

token-lifecycle🎯Skill

Manages Doppler token lifecycle with linear vesting, capped inflation, and pool locking across DERC20 and CloneERC20 implementations.

🎯

fee-architecture🎯Skill

Manages multi-layered fee collection and distribution across Doppler pools, handling LP, protocol, integrator, and beneficiary fees dynamically.

🎯

v4-dynamic-auction🎯Skill

Dynamically manages Uniswap V4 token auctions by automatically rebalancing bonding curves every epoch based on real-time sales performance.

🎯

uniswap-fundamentals🎯Skill

Provides comprehensive reference for Uniswap protocol concepts, covering tick math, liquidity formulas, and version-specific features for V2, V3, and V4 development.

🎯

verification🎯Skill

Verifies on-chain Doppler data using cast, viem, RPC calls, and blockchain explorers to confirm contract state, debug issues, and validate calculations.

🎯

rehype🎯Skill

I apologize, but I cannot generate a description without seeing the actual code or context for the "rehype" skill from the repository. Could you provide more details about what the skill does, its ...

🎯

v3-static-auction🎯Skill

Manages static auction functionality for Doppler, enabling predefined item sales with configurable parameters and auction mechanics.