@whetstone-research/doppler-sdk 1.0.26 → 1.0.27

package/README.md

@@ -444,9 +444,9 @@ console.log('Token address:', presetResult.tokenAddress);
 
 The preset helper seeds three curated curve buckets sized for ~1B token supply targets:
 
-- `low`: ~5% of the sale allocated to a $7.5k-$30k market cap window.
-- `medium`: ~12.5% targeting roughly $50k-$150k market caps.
-- `high`: ~20% aimed at $250k-$750k market caps.
+- `low`: 50% of the sale allocated to a $0-$3M market cap window.
+- `medium`: 25% targeting roughly $1k-$40M market caps.
+- `high`: 24% aimed at $100k-$1B market caps.
 
 Pass `presets` to pick a subset (e.g. `['medium', 'high']`) or provide `overrides` to adjust ticks, positions, or shares for a specific tier. When the selected presets sum to less than 100%, the builder automatically appends a filler curve (using the highest selected tier's shape) so liquidity always covers the full sale. Shares must stay within 0-1e18 and the helper will throw if the total ever exceeds 100%.
 
@@ -914,6 +914,8 @@ import { Derc20 } from '@whetstone-research/doppler-sdk/evm';
 const tokenDirect = new Derc20(publicClient, walletClient, tokenAddress);
 ```
 
+For a runnable release-focused example covering legacy DERC20, DERC20 V2 schedules, and DopplerERC20V1 partial releases, see [examples/vesting-release.ts](./examples/vesting-release.ts).
+
 ### DopplerERC20V1 Tokens
 
 Use the newer DopplerERC20V1 token template by either setting `type: 'dopplerERC20V1'` explicitly or by passing fields such as `maxBalanceLimit` with `balanceLimitEnd`, `controller`, or `excludedFromBalanceLimit`. When selected, the SDK uses the configured `dopplerERC20V1Factory` by default. `withTokenFactory(address)` is a generic factory override and takes precedence, but it must point to a factory compatible with the selected token path and token data ABI. `controller` is optional and defaults to the zero address, set it only if early balance-limit disable should be possible. Standard configs without the specific fields still use the legacy `standard` path, where cliff/allocation vesting routes to legacy DERC20 V2. Keep explicit `type: 'dopplerERC20V1'` when you want its behavior but have no specific fields to infer from.
@@ -1427,6 +1429,10 @@ for (const id of SUPPORTED_CHAIN_IDS) {
 }
 ```
 
+Robinhood Chain is available as `CHAIN_IDS.ROBINHOOD` (`4663`). The SDK exposes
+addresses and support checks for it, but does not export a viem chain definition;
+use your application's chain/client setup when constructing clients.
+
 ## Advanced Usage
 
 ### Custom Vesting Configuration
@@ -1782,7 +1788,7 @@ pnpm dev
 
 The SDK includes comprehensive tests covering:
 
-- **Airlock Whitelisting**: Verifies that all modules are properly whitelisted on Ethereum Mainnet, Monad Mainnet, Base Mainnet, and Base Sepolia
+- **Airlock Whitelisting**: Verifies that all modules are properly whitelisted on Ethereum Mainnet, Monad Mainnet, Base Mainnet, Base Sepolia, and Robinhood Chain
 - **Multicurve Functionality**: Tests multicurve auction creation and quoting
 - **Token Address Mining**: Tests for generating optimized token addresses
 
@@ -1796,10 +1802,10 @@ pnpm test:whitelisting
 ALCHEMY_API_KEY=your_key_here pnpm test:whitelisting
 
 # Limit to specific whitelist-audit chains when needed
-TEST_CHAINS=mainnet,base,base-sepolia,monad-mainnet pnpm test:whitelisting
+TEST_CHAINS=mainnet,base,base-sepolia,monad-mainnet,robinhood pnpm test:whitelisting
 ```
 
-The whitelisting suite is scoped to the release-audit chains: Ethereum Mainnet, Monad Mainnet, Base Mainnet, and Base Sepolia.
+The whitelisting suite is scoped to the release-audit chains: Ethereum Mainnet, Monad Mainnet, Base Mainnet, Base Sepolia, and Robinhood Chain.
 
 Whitelisting test RPC priority is:
 
@@ -1833,7 +1839,7 @@ If you're migrating from `doppler-v3-sdk` or `doppler-v4-sdk`, see our [Migratio
 
 ## Contributing
 
-Contributions are welcome! Please see our [Contributing Guide](../../CONTRIBUTING.md) for details.
+Contributions are welcome! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.
 
 ## License
 

package/dist/evm/index.cjs

@@ -404,23 +404,23 @@ var DEFAULT_OPENING_DOPPLER_NUM_PD_SLUGS = DEFAULT_PD_SLUGS;
 var DEFAULT_OPENING_DOPPLER_FEE = FEE_TIERS.HIGH;
 var DEFAULT_OPENING_DOPPLER_TICK_SPACING = DOPPLER_MAX_TICK_SPACING;
 var DEFAULT_MULTICURVE_LOWER_TICKS = [
-  -202100,
-  -183100,
-  -167e3
+  -887200,
+  -222200,
+  -176200
 ];
 var DEFAULT_MULTICURVE_UPPER_TICKS = [
-  -188200,
-  -172100,
-  -156e3
+  -142200,
+  -116300,
+  -84100
 ];
 var DEFAULT_MULTICURVE_NUM_POSITIONS = [11, 11, 11];
 var DEFAULT_MULTICURVE_MAX_SUPPLY_SHARES = [
-  viem.parseEther("0.05"),
-  // 5% for LOW tier
-  viem.parseEther("0.125"),
-  // 12.5% for MEDIUM tier
-  viem.parseEther("0.2")
-  // 20% for HIGH tier
+  viem.parseEther("0.5"),
+  // 50% for LOW tier
+  viem.parseEther("0.25"),
+  // 25% for MEDIUM tier
+  viem.parseEther("0.24")
+  // 24% for HIGH tier
 ];
 var BASIS_POINTS = 1e4;
 var FLAG_MASK = BigInt(16383);
@@ -464,7 +464,7 @@ var CHAIN_IDS = {
   BASE: 8453,
   BASE_SEPOLIA: 84532,
   INK: 57073,
-  TEMP: 4663,
+  ROBINHOOD: 4663,
   UNICHAIN: 130,
   UNICHAIN_SEPOLIA: 1301,
   MONAD_TESTNET: 10143,
@@ -736,48 +736,50 @@ var ADDRESSES = {
     weth: "0x4200000000000000000000000000000000000006",
     uniswapV4Quoter: "0x3972c00f7ed4885e145823eb7c655375d275a1c5"
   },
-  [CHAIN_IDS.TEMP]: {
-    airlock: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].Airlock,
+  [CHAIN_IDS.ROBINHOOD]: {
+    airlock: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].Airlock,
     tokenFactory: ZERO_ADDRESS,
     dopplerERC20V1Factory: getGeneratedAddress(
-      CHAIN_IDS.TEMP,
+      CHAIN_IDS.ROBINHOOD,
       "DopplerERC20V1Factory"
     ),
     dopplerERC20V1Implementation: getGeneratedAddress(
-      CHAIN_IDS.TEMP,
+      CHAIN_IDS.ROBINHOOD,
       "DopplerERC20V1"
     ),
-    doppler404Factory: getGeneratedAddress(CHAIN_IDS.TEMP, "DN404Factory"),
+    doppler404Factory: getGeneratedAddress(CHAIN_IDS.ROBINHOOD, "DN404Factory"),
     v3Initializer: ZERO_ADDRESS,
     v3Quoter: "0x33e885ed0ec9bf04ecfb19341582aadcb4c8a9e7",
-    lockableV3Initializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].LockableUniswapV3Initializer,
-    v4Initializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].UniswapV4Initializer,
-    dopplerHookInitializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].DopplerHookInitializer,
+    lockableV3Initializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].LockableUniswapV3Initializer,
+    v4Initializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].UniswapV4Initializer,
+    dopplerHookInitializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].DopplerHookInitializer,
     rehypeDopplerHookInitializer: getRehypeDopplerHookInitializerAddress(
-      CHAIN_IDS.TEMP
+      CHAIN_IDS.ROBINHOOD
     ),
-    rehypeDopplerHook: getRehypeDopplerHookInitializerAddress(CHAIN_IDS.TEMP),
-    dopplerLens: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].DopplerLensQuoter,
-    dopplerDeployer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].DopplerDeployer,
+    rehypeDopplerHook: getRehypeDopplerHookInitializerAddress(
+      CHAIN_IDS.ROBINHOOD
+    ),
+    dopplerLens: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].DopplerLensQuoter,
+    dopplerDeployer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].DopplerDeployer,
     poolManager: "0x8366a39cc670b4001a1121b8f6a443a643e40951",
     v2Migrator: ZERO_ADDRESS,
-    v2MigratorSplit: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].UniswapV2MigratorSplit,
+    v2MigratorSplit: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].UniswapV2MigratorSplit,
     v4Migrator: ZERO_ADDRESS,
-    dopplerHookMigrator: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].DopplerHookMigrator,
-    rehypeDopplerHookMigrator: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].RehypeDopplerHookMigrator,
-    noOpMigrator: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].NoOpMigrator,
-    governanceFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].GovernanceFactory,
-    noOpGovernanceFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].NoOpGovernanceFactory,
-    launchpadGovernanceFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].LaunchpadGovernanceFactory,
+    dopplerHookMigrator: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].DopplerHookMigrator,
+    rehypeDopplerHookMigrator: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].RehypeDopplerHookMigrator,
+    noOpMigrator: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].NoOpMigrator,
+    governanceFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].GovernanceFactory,
+    noOpGovernanceFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].NoOpGovernanceFactory,
+    launchpadGovernanceFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].LaunchpadGovernanceFactory,
     streamableFeesLocker: ZERO_ADDRESS,
     streamableFeesLockerV2: getGeneratedAddress(
-      CHAIN_IDS.TEMP,
+      CHAIN_IDS.ROBINHOOD,
       "StreamableFeesLockerV2"
     ),
-    topUpDistributor: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].TopUpDistributor,
+    topUpDistributor: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].TopUpDistributor,
     universalRouter: "0x8876789976decbfcbbbe364623c63652db8c0904",
     permit2: "0x000000000022D473030F116dDEE9F6B43aC78BA3",
-    bundler: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.TEMP].Bundler,
+    bundler: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].Bundler,
     weth: "0x0bd7d308f8e1639fab988df18a8011f41eacad73",
     uniswapV2Factory: "0x8bceaa40b9acdfaedf85adf4ff01f5ad6517937f",
     uniswapV3Factory: "0x1f7d7550b1b028f7571e69a784071f0205fd2efa",
@@ -6675,6 +6677,92 @@ function getLiquidityForAmount1(sqrtRatioAX96, sqrtRatioBX96, amount1) {
   return amount1 * Q96 / diff;
 }
 
+// src/evm/utils/multicurveLiquidity.ts
+var MAX_UINT128 = (1n << 128n) - 1n;
+function getMaxLiquiditySafeMulticurveTickUpper(params) {
+  if (params.tickUpper <= params.tickLower) {
+    throw new Error(
+      `Unable to find a uint128-safe multicurve max tick below ${params.tickUpper}`
+    );
+  }
+  if (isCanonicalCurveLiquiditySafe(params)) return params.tickUpper;
+  for (let candidate = params.tickUpper - params.tickSpacing; candidate > params.tickLower; candidate -= params.tickSpacing) {
+    if (isCanonicalCurveLiquiditySafe({ ...params, tickUpper: candidate })) {
+      return candidate;
+    }
+  }
+  throw new Error(
+    `Unable to find a uint128-safe multicurve max tick below ${params.tickUpper}`
+  );
+}
+function isCanonicalCurveLiquiditySafe(params) {
+  return isAdjustedCurveLiquiditySafe({
+    ...params,
+    isToken0: true
+  }) && isAdjustedCurveLiquiditySafe({
+    ...params,
+    tickLower: -params.tickUpper,
+    tickUpper: -params.tickLower,
+    isToken0: false
+  });
+}
+function isAdjustedCurveLiquiditySafe(params) {
+  if (params.numPositions <= 0 || params.tickSpacing <= 0) {
+    throw new Error("Multicurve positions and tick spacing must be positive");
+  }
+  const amountPerPosition = params.curveSupply / BigInt(params.numPositions);
+  if (amountPerPosition <= 1n) return true;
+  const amount = amountPerPosition - 1n;
+  const maxLiquidityPerTick = getMaxLiquidityPerTick(params.tickSpacing);
+  const liquidityByTick = /* @__PURE__ */ new Map();
+  const farTick = params.isToken0 ? params.tickUpper : params.tickLower;
+  const closeTick = params.isToken0 ? params.tickLower : params.tickUpper;
+  const spread = params.tickUpper - params.tickLower;
+  const farSqrtPriceX96 = getSqrtRatioAtTick(farTick);
+  for (let i = 0; i < params.numPositions; i++) {
+    const tickDelta = Number(
+      BigInt(i) * BigInt(spread) / BigInt(params.numPositions)
+    );
+    const unalignedTick = params.isToken0 ? closeTick + tickDelta : closeTick - tickDelta;
+    const startingTick = alignMulticurveTick(
+      params.isToken0,
+      unalignedTick,
+      params.tickSpacing
+    );
+    if (startingTick === farTick) continue;
+    const startingSqrtPriceX96 = getSqrtRatioAtTick(startingTick);
+    const liquidity = params.isToken0 ? getLiquidityForAmount0(startingSqrtPriceX96, farSqrtPriceX96, amount) : getLiquidityForAmount1(farSqrtPriceX96, startingSqrtPriceX96, amount);
+    if (liquidity > maxLiquidityPerTick) return false;
+    const tickA = Math.min(farTick, startingTick);
+    const tickB = Math.max(farTick, startingTick);
+    if (!addTickLiquidity(liquidityByTick, tickA, liquidity, maxLiquidityPerTick)) {
+      return false;
+    }
+    if (!addTickLiquidity(liquidityByTick, tickB, liquidity, maxLiquidityPerTick)) {
+      return false;
+    }
+  }
+  return true;
+}
+function getMaxLiquidityPerTick(tickSpacing) {
+  const minTick = Math.trunc(MIN_TICK / tickSpacing) * tickSpacing;
+  const maxTick = Math.trunc(MAX_TICK / tickSpacing) * tickSpacing;
+  const numTicks = BigInt((maxTick - minTick) / tickSpacing + 1);
+  return MAX_UINT128 / numTicks;
+}
+function addTickLiquidity(liquidityByTick, tick, liquidity, maxLiquidityPerTick) {
+  const updatedLiquidity = (liquidityByTick.get(tick) ?? 0n) + liquidity;
+  if (updatedLiquidity > maxLiquidityPerTick) return false;
+  liquidityByTick.set(tick, updatedLiquidity);
+  return true;
+}
+function alignMulticurveTick(isToken0, tick, tickSpacing) {
+  if (isToken0) {
+    return tick < 0 ? Math.trunc((tick - tickSpacing + 1) / tickSpacing) * tickSpacing : Math.trunc(tick / tickSpacing) * tickSpacing;
+  }
+  return tick < 0 ? Math.trunc(tick / tickSpacing) * tickSpacing : Math.trunc((tick + tickSpacing - 1) / tickSpacing) * tickSpacing;
+}
+
 // src/evm/utils/computeOptimalGamma.ts
 function computeOptimalGamma(startTick, endTick, duration, epochLength, tickSpacing) {
   const totalEpochs = duration / epochLength;
@@ -6710,6 +6798,23 @@ function isToken0Expected(numeraire) {
   }
 }
 
+// src/evm/utils/beneficiaries.ts
+function sortBeneficiaries(beneficiaries) {
+  const sorted = [...beneficiaries].sort((a, b) => {
+    const aAddr = a.beneficiary.toLowerCase();
+    const bAddr = b.beneficiary.toLowerCase();
+    return aAddr < bAddr ? -1 : aAddr > bAddr ? 1 : 0;
+  });
+  for (let i = 1; i < sorted.length; i++) {
+    if (sorted[i].beneficiary.toLowerCase() === sorted[i - 1].beneficiary.toLowerCase()) {
+      throw new Error(
+        `Duplicate beneficiary address: ${sorted[i].beneficiary}. Each beneficiary address must be unique \u2014 the contract requires strictly ascending addresses and reverts with UnorderedBeneficiaries() otherwise. Merge the entries into a single beneficiary with the combined shares.`
+      );
+    }
+  }
+  return sorted;
+}
+
 // src/evm/types.ts
 var NO_OP_ENABLED_CHAIN_IDS = [
   CHAIN_IDS.MAINNET,
@@ -6718,7 +6823,7 @@ var NO_OP_ENABLED_CHAIN_IDS = [
   CHAIN_IDS.BASE_SEPOLIA,
   CHAIN_IDS.UNICHAIN,
   CHAIN_IDS.UNICHAIN_SEPOLIA,
-  CHAIN_IDS.TEMP,
+  CHAIN_IDS.ROBINHOOD,
   CHAIN_IDS.MONAD_TESTNET,
   CHAIN_IDS.MONAD_MAINNET
 ];
@@ -6729,7 +6834,7 @@ var LAUNCHPAD_ENABLED_CHAIN_IDS = [
   CHAIN_IDS.MAINNET,
   CHAIN_IDS.BASE,
   CHAIN_IDS.BASE_SEPOLIA,
-  CHAIN_IDS.TEMP,
+  CHAIN_IDS.ROBINHOOD,
   CHAIN_IDS.MONAD_MAINNET
 ];
 function isLaunchpadEnabledChain(chainId) {
@@ -7314,7 +7419,7 @@ function buildCurvesFromPresets(params) {
 }
 
 // src/evm/entities/DopplerFactory.ts
-var MAX_UINT128 = (1n << 128n) - 1n;
+var MAX_UINT1282 = (1n << 128n) - 1n;
 var MAX_PROCEEDS_SPLIT_SHARE = WAD / 2n;
 var DERC20_V1_MAX_PREMINT_WAD = WAD * 8n / 10n;
 var ONE_MILLION = 1000000n;
@@ -8010,11 +8115,7 @@ var DopplerFactory = class {
     const hasBeneficiaries = params.pool.beneficiaries && params.pool.beneficiaries.length > 0;
     let poolInitializerData;
     if (hasBeneficiaries) {
-      const sortedBeneficiaries = params.pool.beneficiaries.slice().sort((a, b) => {
-        const aAddr = a.beneficiary.toLowerCase();
-        const bAddr = b.beneficiary.toLowerCase();
-        return aAddr < bAddr ? -1 : aAddr > bAddr ? 1 : 0;
-      });
+      const sortedBeneficiaries = sortBeneficiaries(params.pool.beneficiaries);
       poolInitializerData = viem.encodeAbiParameters(
         [
           {
@@ -8094,14 +8195,20 @@ var DopplerFactory = class {
     const poolInitializerAddress = (() => {
       if (hasBeneficiaries) {
         const lockableInitializer = params.modules?.lockableV3Initializer ?? addresses.lockableV3Initializer;
-        if (!lockableInitializer) {
+        if (!lockableInitializer || lockableInitializer === ZERO_ADDRESS) {
           throw new Error(
             "Lockable V3 initializer address not configured on this chain. Required when using beneficiaries."
           );
         }
         return lockableInitializer;
       }
-      return params.modules?.v3Initializer ?? addresses.v3Initializer;
+      const standardInitializer = params.modules?.v3Initializer ?? addresses.v3Initializer;
+      if (!standardInitializer || standardInitializer === ZERO_ADDRESS) {
+        throw new Error(
+          "UniswapV3Initializer address not configured on this chain. Use beneficiaries for lockable V3 support, provide an override via builder.withV3Initializer(...), or use a chain with standard V3 initializer support."
+        );
+      }
+      return standardInitializer;
     })();
     const liquidityMigratorAddress = this.getMigratorAddress(
       params.migration,
@@ -8516,6 +8623,11 @@ var DopplerFactory = class {
       addresses
     });
     const poolInitializerAddress = params.modules?.v4Initializer ?? addresses.v4Initializer;
+    if (!poolInitializerAddress || poolInitializerAddress === ZERO_ADDRESS) {
+      throw new Error(
+        "UniswapV4Initializer address not configured on this chain. Provide an override via builder.withV4Initializer(...) or use a chain with dynamic auction support."
+      );
+    }
     const liquidityMigratorAddress = this.getMigratorAddress(
       params.migration,
       params.modules
@@ -9846,13 +9958,7 @@ var DopplerFactory = class {
         if (!streamableFees) {
           return "0x";
         }
-        const beneficiaryData = [...streamableFees.beneficiaries].sort(
-          (a, b) => {
-            const addrA = a.beneficiary.toLowerCase();
-            const addrB = b.beneficiary.toLowerCase();
-            return addrA < addrB ? -1 : addrA > addrB ? 1 : 0;
-          }
-        );
+        const beneficiaryData = sortBeneficiaries(streamableFees.beneficiaries);
         return viem.encodeAbiParameters(
           [
             { type: "uint24" },
@@ -9877,12 +9983,8 @@ var DopplerFactory = class {
           ]
         );
       case "uniswapV4Split": {
-        const beneficiaryData2 = [...config.streamableFees.beneficiaries].sort(
-          (a, b) => {
-            const addrA = a.beneficiary.toLowerCase();
-            const addrB = b.beneficiary.toLowerCase();
-            return addrA < addrB ? -1 : addrA > addrB ? 1 : 0;
-          }
+        const beneficiaryData2 = sortBeneficiaries(
+          config.streamableFees.beneficiaries
         );
         const proceedsRecipient = config.proceedsSplit?.recipient ?? ZERO_ADDRESS;
         const proceedsShare = config.proceedsSplit?.share ?? 0n;
@@ -9918,12 +10020,8 @@ var DopplerFactory = class {
             "dopplerHook migration cannot set both hook and rehype config. Use exactly one hook mode."
           );
         }
-        const beneficiaries = [...dopplerHookConfig.beneficiaries].sort(
-          (a, b) => {
-            const addrA = a.beneficiary.toLowerCase();
-            const addrB = b.beneficiary.toLowerCase();
-            return addrA < addrB ? -1 : addrA > addrB ? 1 : 0;
-          }
+        const beneficiaries = sortBeneficiaries(
+          dopplerHookConfig.beneficiaries
         );
         let dopplerHookAddress = ZERO_ADDRESS;
         let onInitializationCalldata = "0x";
@@ -10326,15 +10424,12 @@ var DopplerFactory = class {
     }
     const normalizedCurves = this.normalizeMulticurveCurves(
       params.pool.curves,
-      params.pool.tickSpacing
+      params.pool.tickSpacing,
+      params.sale.numTokensToSell
     );
     const addresses = getAddresses(this.chainId);
-    const sortedBeneficiaries = (params.pool.beneficiaries ?? []).slice().sort(
-      (a, b) => {
-        const aAddr = a.beneficiary.toLowerCase();
-        const bAddr = b.beneficiary.toLowerCase();
-        return aAddr < bAddr ? -1 : aAddr > bAddr ? 1 : 0;
-      }
+    const sortedBeneficiaries = sortBeneficiaries(
+      params.pool.beneficiaries ?? []
     );
     const initializerMode = this.resolveMulticurveInitializerMode(params);
     const useScheduledInitializer = initializerMode.type === "scheduled";
@@ -10809,7 +10904,7 @@ var DopplerFactory = class {
   /**
    * Normalize user-provided multicurve positions and ensure they satisfy SDK constraints
    */
-  normalizeMulticurveCurves(curves, tickSpacing) {
+  normalizeMulticurveCurves(curves, tickSpacing, numTokensToSell) {
     if (tickSpacing <= 0) {
       throw new Error("Tick spacing must be positive");
     }
@@ -10856,25 +10951,19 @@ var DopplerFactory = class {
     if (fallbackTickLower === void 0) {
       throw new Error("Unable to determine fallback multicurve tick range");
     }
-    const fallbackTickUpper = this.roundMaxTickDown(tickSpacing);
-    if (fallbackTickLower >= fallbackTickUpper) {
-      const adjustedLower = fallbackTickUpper - tickSpacing;
-      if (adjustedLower < fallbackTickLower) {
-        return sanitizedCurves;
-      }
-      const fallbackCurve2 = {
-        tickLower: adjustedLower,
-        tickUpper: fallbackTickUpper,
-        numPositions: sanitizedCurves[sanitizedCurves.length - 1]?.numPositions ?? 1,
-        shares: missingShare
-      };
-      return [...sanitizedCurves, fallbackCurve2];
-    }
+    const fallbackNumPositions = sanitizedCurves[sanitizedCurves.length - 1]?.numPositions ?? 1;
+    const fallbackTickUpper = getMaxLiquiditySafeMulticurveTickUpper({
+      tickLower: fallbackTickLower,
+      tickUpper: this.roundMaxTickDown(tickSpacing),
+      tickSpacing,
+      numPositions: fallbackNumPositions,
+      curveSupply: numTokensToSell * missingShare / WAD
+    });
     const fallbackCurve = {
       // Extend from the most positive user tick out to the maximum supported tick bucket
       tickLower: fallbackTickLower,
       tickUpper: fallbackTickUpper,
-      numPositions: sanitizedCurves[sanitizedCurves.length - 1]?.numPositions ?? 1,
+      numPositions: fallbackNumPositions,
       shares: missingShare
     };
     return [...sanitizedCurves, fallbackCurve];
@@ -11394,8 +11483,15 @@ var DopplerFactory = class {
   getMigratorAddress(config, overrides) {
     const addresses = getAddresses(this.chainId);
     switch (config.type) {
-      case "uniswapV2":
-        return overrides?.v2Migrator ?? addresses.v2Migrator;
+      case "uniswapV2": {
+        const v2Address = overrides?.v2Migrator ?? addresses.v2Migrator;
+        if (!v2Address || v2Address === ZERO_ADDRESS) {
+          throw new Error(
+            "UniswapV2Migrator not deployed on this chain. Use uniswapV2Split migration or provide override via modules.v2Migrator."
+          );
+        }
+        return v2Address;
+      }
       case "uniswapV2Split": {
         const v2SplitAddress = overrides?.v2MigratorSplit ?? addresses.v2MigratorSplit;
         if (!v2SplitAddress || v2SplitAddress === ZERO_ADDRESS) {
@@ -11407,7 +11503,7 @@ var DopplerFactory = class {
       }
       case "uniswapV4": {
         const v4Address = overrides?.v4Migrator ?? addresses.v4Migrator;
-        if (v4Address === "0x0000000000000000000000000000000000000000") {
+        if (!v4Address || v4Address === ZERO_ADDRESS) {
           throw new Error(
             "UniswapV4Migrator not deployed on this chain. Use uniswapV2 migration or provide override via modules.v4Migrator."
           );
@@ -11573,7 +11669,7 @@ var DopplerFactory = class {
     if (!allowZero && value === 0n) {
       throw new Error(`${paramName} must be greater than zero`);
     }
-    if (value > MAX_UINT128) {
+    if (value > MAX_UINT1282) {
       throw new Error(`${paramName} exceeds uint128 range`);
     }
   }
@@ -18570,9 +18666,16 @@ var MulticurveBuilder = class _MulticurveBuilder {
           tokenDecimals: config.tokenDecimals ?? 18,
           numeraireDecimals: config.numeraireDecimals ?? 18
         });
+        const curveSupply = this.sale.numTokensToSell * curve.shares / WAD;
+        const tickUpper = curve.marketCap.end === "max" ? getMaxLiquiditySafeMulticurveTickUpper({
+          ...curveTicks,
+          tickSpacing,
+          numPositions: curve.numPositions,
+          curveSupply
+        }) : curveTicks.tickUpper;
         curves.push({
           tickLower: curveTicks.tickLower,
-          tickUpper: curveTicks.tickUpper,
+          tickUpper,
           numPositions: curve.numPositions,
           shares: curve.shares
         });
@@ -18633,7 +18736,7 @@ var MulticurveBuilder = class _MulticurveBuilder {
       }
       dopplerHook = { ...dopplerHook, farTick };
     }
-    const initializer = this.initializer ?? (dopplerHook ? { type: "rehype", config: dopplerHook } : this.schedule ? { type: "scheduled", startTime: this.schedule.startTime } : { type: "standard" });
+    const initializer = this.initializer?.type === "rehype" && dopplerHook ? { type: "rehype", config: dopplerHook } : this.initializer ?? (dopplerHook ? { type: "rehype", config: dopplerHook } : this.schedule ? { type: "scheduled", startTime: this.schedule.startTime } : { type: "standard" });
     if (initializer.type === "scheduled" && dopplerHook) {
       throw new Error(
         "Cannot combine scheduled multicurve with rehype initializer. Use exactly one initializer mode."
@@ -19461,6 +19564,7 @@ exports.getAmount0ForLiquidity = getAmount0ForLiquidity;
 exports.getAmount1ForLiquidity = getAmount1ForLiquidity;
 exports.getLiquidityForAmount0 = getLiquidityForAmount0;
 exports.getLiquidityForAmount1 = getLiquidityForAmount1;
+exports.getMaxLiquiditySafeMulticurveTickUpper = getMaxLiquiditySafeMulticurveTickUpper;
 exports.getMaxTickRounded = getMaxTickRounded;
 exports.getNearestUsableTick = getNearestUsableTick;
 exports.getSqrtRatioAtTick = getSqrtRatioAtTick;
@@ -19489,6 +19593,7 @@ exports.ratioToTick = ratioToTick;
 exports.rehypeDopplerHookAbi = rehypeDopplerHookAbi;
 exports.rehypeDopplerHookMigratorAbi = rehypeDopplerHookMigratorAbi;
 exports.resolveGasEstimate = resolveGasEstimate;
+exports.sortBeneficiaries = sortBeneficiaries;
 exports.sqrtPriceX96ToPrice = sqrtPriceX96ToPrice;
 exports.streamableFeesLockerAbi = streamableFeesLockerAbi;
 exports.streamableFeesLockerV2Abi = streamableFeesLockerV2Abi;