@whetstone-research/doppler-sdk 1.0.25 → 1.0.27

package/dist/evm/index.cjs

@@ -124,6 +124,33 @@ var GENERATED_DOPPLER_DEPLOYMENTS = {
     NoOpGovernanceFactory: "0xddAE8B3eD08184682f7Bc32B74d943cEEfEab638",
     NoOpMigrator: "0x233A71A7bB928b1357A1Ebf454298320989Ca5B5"
   },
+  "4663": {
+    Airlock: "0xeb7C034704eF8Dcd2D32324c1545f62fB4aD0862",
+    Bundler: "0xEdE0B5fae363232c396724Fa962250Fa197cc5a1",
+    DN404Factory: "0x37A9Fa204a4d3A429FDED7e3469ab076C854Bc9d",
+    DopplerCreateXDeployer: "0x103004E50Bed65DFBa30dD9c264B6BdF5e529B83",
+    DopplerDeployer: "0x4389AD34938B14F25cff7ED983c53f5a42A2573f",
+    DopplerERC20V1: "0x3Be8B97Fd0e713B5aBE0649Fa830223B6B4BC599",
+    DopplerERC20V1Factory: "0x1B37D3a72082029c44B35B604Ea473617580b69a",
+    DopplerHookInitializer: "0x4e3468951D49f2EEa976eD0D6e75fFCb44a9a544",
+    DopplerHookMigrator: "0x7BF319d8e969f7596B1Bc171Da9ce322f67Ae0c4",
+    DopplerLensQuoter: "0xf4c22465532f64777FfcD7770831AEca38F35c04",
+    GovernanceFactory: "0xDeb0447DAE3EB177c4dbA8bBCCCa25c8F273B7ef",
+    LaunchpadGovernanceFactory: "0xdb036746D65DD52126b1915f1AdF555e6C5237Cf",
+    LockableUniswapV3Initializer: "0xde8886A0019Ea060B8378Ee37b8A23b8117F29A3",
+    NoOpGovernanceFactory: "0x85f37f74Ef2478A770318bc810177a9835911aD7",
+    NoOpMigrator: "0xba2F330EDb16cD8056f5988d8CE19BbC63475A0e",
+    Quoter: "0x7232686FC954f12079cadFC5e9F755a9fEAeb3Ca",
+    RehypeDopplerHookInitializer: "0x6f02324d20CC679d0E585290CAa6b16baCbC0F77",
+    RehypeDopplerHookMigrator: "0x1a0f286bB7f5967AE89c13D3425D5ce04C34cd27",
+    StreamableFeesLockerV2: "0x7B6147AC3F615bdb764e7EbD5f517dac1AD163B8",
+    SwapRestrictorDopplerHook: "0xC16c826F75338A5Ea626f94f8992191B4ce5abA2",
+    TimelockFactory: "0x6076fdDFCaC0dD980e0350dfF5239feC3f86C578",
+    TopUpDistributor: "0x46adee7595d48b1Ec53090e9bc78e1E69Fa0eF06",
+    UniswapV2Locker: "0x63f6Efe03F25A8C6650b38d05C5a454051d642a5",
+    UniswapV2MigratorSplit: "0xB05046cEa797c993FB5b583098B1c4682e9Da333",
+    UniswapV4Initializer: "0x6cce158B6D1747617fc218592B4D60B239B957ea"
+  },
   "4801": {
     Airlock: "0x5F3bA43D44375286296Cb85F1EA2EBfa25dde731",
     GovernanceFactory: "0x136191B46478cAB023cbC01a36160C4Aad81677a",
@@ -227,6 +254,8 @@ var GENERATED_DOPPLER_DEPLOYMENTS = {
     CloneERC20VotesFactory: "0x9a497a9fB78e49984B9d260abA1F4AD6321D4D92",
     DecayMulticurveInitializer: "0xD59cE43E53D69F190E15d9822Fb4540dCcc91178",
     DecayMulticurveInitializerHook: "0xbB7784A4d481184283Ed89619A3e3ed143e1Adc0",
+    DN404Factory: "0x98b0Aa2e0f134dbB3eb157b5646D387E6D55243a",
+    DopplerCreateXDeployer: "0x0000000000f13Ab5b685F03A412A26719aB6bE60",
     DopplerDeployer: "0xb35469ee64A87Afd19B31615094fE3962d73e421",
     DopplerERC20V1: "0xDB7B520bb5C3a2C5d4871198081911359f93be87",
     DopplerERC20V1Factory: "0x89C261C05B5F9b6BcBA07C199b8DeE7cFaD45292",
@@ -375,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);
@@ -435,6 +464,7 @@ var CHAIN_IDS = {
   BASE: 8453,
   BASE_SEPOLIA: 84532,
   INK: 57073,
+  ROBINHOOD: 4663,
   UNICHAIN: 130,
   UNICHAIN_SEPOLIA: 1301,
   MONAD_TESTNET: 10143,
@@ -706,6 +736,55 @@ var ADDRESSES = {
     weth: "0x4200000000000000000000000000000000000006",
     uniswapV4Quoter: "0x3972c00f7ed4885e145823eb7c655375d275a1c5"
   },
+  [CHAIN_IDS.ROBINHOOD]: {
+    airlock: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].Airlock,
+    tokenFactory: ZERO_ADDRESS,
+    dopplerERC20V1Factory: getGeneratedAddress(
+      CHAIN_IDS.ROBINHOOD,
+      "DopplerERC20V1Factory"
+    ),
+    dopplerERC20V1Implementation: getGeneratedAddress(
+      CHAIN_IDS.ROBINHOOD,
+      "DopplerERC20V1"
+    ),
+    doppler404Factory: getGeneratedAddress(CHAIN_IDS.ROBINHOOD, "DN404Factory"),
+    v3Initializer: ZERO_ADDRESS,
+    v3Quoter: "0x33e885ed0ec9bf04ecfb19341582aadcb4c8a9e7",
+    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.ROBINHOOD
+    ),
+    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.ROBINHOOD].UniswapV2MigratorSplit,
+    v4Migrator: ZERO_ADDRESS,
+    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.ROBINHOOD,
+      "StreamableFeesLockerV2"
+    ),
+    topUpDistributor: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].TopUpDistributor,
+    universalRouter: "0x8876789976decbfcbbbe364623c63652db8c0904",
+    permit2: "0x000000000022D473030F116dDEE9F6B43aC78BA3",
+    bundler: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ROBINHOOD].Bundler,
+    weth: "0x0bd7d308f8e1639fab988df18a8011f41eacad73",
+    uniswapV2Factory: "0x8bceaa40b9acdfaedf85adf4ff01f5ad6517937f",
+    uniswapV3Factory: "0x1f7d7550b1b028f7571e69a784071f0205fd2efa",
+    uniswapV4Quoter: "0x8dc178efb8111bb0973dd9d722ebeff267c98f94"
+  },
   [CHAIN_IDS.UNICHAIN]: {
     airlock: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.UNICHAIN].Airlock,
     tokenFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.UNICHAIN].TokenFactory,
@@ -6598,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;
@@ -6633,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,
@@ -6641,6 +6823,7 @@ var NO_OP_ENABLED_CHAIN_IDS = [
   CHAIN_IDS.BASE_SEPOLIA,
   CHAIN_IDS.UNICHAIN,
   CHAIN_IDS.UNICHAIN_SEPOLIA,
+  CHAIN_IDS.ROBINHOOD,
   CHAIN_IDS.MONAD_TESTNET,
   CHAIN_IDS.MONAD_MAINNET
 ];
@@ -6651,6 +6834,7 @@ var LAUNCHPAD_ENABLED_CHAIN_IDS = [
   CHAIN_IDS.MAINNET,
   CHAIN_IDS.BASE,
   CHAIN_IDS.BASE_SEPOLIA,
+  CHAIN_IDS.ROBINHOOD,
   CHAIN_IDS.MONAD_MAINNET
 ];
 function isLaunchpadEnabledChain(chainId) {
@@ -7235,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;
@@ -7931,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(
         [
           {
@@ -8015,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,
@@ -8437,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
@@ -9767,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" },
@@ -9798,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;
@@ -9839,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";
@@ -10247,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";
@@ -10730,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");
     }
@@ -10777,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];
@@ -11315,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) {
@@ -11328,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."
           );
@@ -11494,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`);
     }
   }
@@ -18491,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
         });
@@ -18554,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."
@@ -19382,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;
@@ -19410,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;