@whetstone-research/doppler-sdk 1.0.4 → 1.0.6

package/dist/evm/index.cjs

@@ -299,6 +299,14 @@ var ADDRESSES = {
   [CHAIN_IDS.MAINNET]: {
     airlock: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.MAINNET].Airlock,
     tokenFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.MAINNET].CloneERC20Factory,
+    derc20V2Factory: getGeneratedAddress(
+      CHAIN_IDS.MAINNET,
+      "CloneDERC20VotesV2Factory"
+    ),
+    derc20V2Implementation: getGeneratedAddress(
+      CHAIN_IDS.MAINNET,
+      "CloneDERC20VotesV2"
+    ),
     v3Initializer: ZERO_ADDRESS,
     v3Quoter: ZERO_ADDRESS,
     v4Initializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.MAINNET].UniswapV4Initializer,
@@ -331,6 +339,14 @@ var ADDRESSES = {
   [CHAIN_IDS.ETH_SEPOLIA]: {
     airlock: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ETH_SEPOLIA].Airlock,
     tokenFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ETH_SEPOLIA].CloneERC20Factory,
+    derc20V2Factory: getGeneratedAddress(
+      CHAIN_IDS.ETH_SEPOLIA,
+      "CloneDERC20VotesV2Factory"
+    ),
+    derc20V2Implementation: getGeneratedAddress(
+      CHAIN_IDS.ETH_SEPOLIA,
+      "CloneDERC20VotesV2"
+    ),
     v3Initializer: ZERO_ADDRESS,
     v3Quoter: ZERO_ADDRESS,
     v4Initializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.ETH_SEPOLIA].UniswapV4Initializer,
@@ -361,6 +377,14 @@ var ADDRESSES = {
   [CHAIN_IDS.BASE]: {
     airlock: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.BASE].Airlock,
     tokenFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.BASE].TokenFactory80,
+    derc20V2Factory: getGeneratedAddress(
+      CHAIN_IDS.BASE,
+      "CloneDERC20VotesV2Factory"
+    ),
+    derc20V2Implementation: getGeneratedAddress(
+      CHAIN_IDS.BASE,
+      "CloneDERC20VotesV2"
+    ),
     v3Initializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.BASE].UniswapV3Initializer,
     v3Quoter: "0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a",
     lockableV3Initializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.BASE].LockableUniswapV3Initializer,
@@ -399,6 +423,14 @@ var ADDRESSES = {
   [CHAIN_IDS.BASE_SEPOLIA]: {
     airlock: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.BASE_SEPOLIA].Airlock,
     tokenFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.BASE_SEPOLIA].TokenFactory80,
+    derc20V2Factory: getGeneratedAddress(
+      CHAIN_IDS.BASE_SEPOLIA,
+      "CloneDERC20VotesV2Factory"
+    ),
+    derc20V2Implementation: getGeneratedAddress(
+      CHAIN_IDS.BASE_SEPOLIA,
+      "CloneDERC20VotesV2"
+    ),
     doppler404Factory: "0xdd8cea2890f1b3498436f19ec8da8fecc2cb7af7",
     v3Initializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.BASE_SEPOLIA].UniswapV3Initializer,
     v3Quoter: "0xC5290058841028F1614F3A6F0F5816cAd0df5E27",
@@ -441,6 +473,14 @@ var ADDRESSES = {
   [CHAIN_IDS.INK]: {
     airlock: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.INK].Airlock,
     tokenFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.INK].TokenFactory,
+    derc20V2Factory: getGeneratedAddress(
+      CHAIN_IDS.INK,
+      "CloneDERC20VotesV2Factory"
+    ),
+    derc20V2Implementation: getGeneratedAddress(
+      CHAIN_IDS.INK,
+      "CloneDERC20VotesV2"
+    ),
     v3Initializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.INK].UniswapV3Initializer,
     v3Quoter: "0x96b572D2d880cf2Fa2563651BD23ADE6f5516652",
     v4Initializer: "0xC99b485499f78995C6F1640dbB1413c57f8BA684",
@@ -464,6 +504,14 @@ var ADDRESSES = {
   [CHAIN_IDS.UNICHAIN]: {
     airlock: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.UNICHAIN].Airlock,
     tokenFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.UNICHAIN].TokenFactory,
+    derc20V2Factory: getGeneratedAddress(
+      CHAIN_IDS.UNICHAIN,
+      "CloneDERC20VotesV2Factory"
+    ),
+    derc20V2Implementation: getGeneratedAddress(
+      CHAIN_IDS.UNICHAIN,
+      "CloneDERC20VotesV2"
+    ),
     v3Initializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.UNICHAIN].UniswapV3Initializer,
     v3Quoter: "0x385A5cf5F83e99f7BB2852b6A19C3538b9FA7658",
     v4Initializer: "0x2F2BAcd46d3F5c9EE052Ab392b73711dB89129DB",
@@ -487,6 +535,14 @@ var ADDRESSES = {
   [CHAIN_IDS.UNICHAIN_SEPOLIA]: {
     airlock: "0x651ab94B4777e2e4cdf96082d90C65bd947b73A4",
     tokenFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.UNICHAIN_SEPOLIA].TokenFactory,
+    derc20V2Factory: getGeneratedAddress(
+      CHAIN_IDS.UNICHAIN_SEPOLIA,
+      "CloneDERC20VotesV2Factory"
+    ),
+    derc20V2Implementation: getGeneratedAddress(
+      CHAIN_IDS.UNICHAIN_SEPOLIA,
+      "CloneDERC20VotesV2"
+    ),
     v3Initializer: "0x7Fb9a622186B4660A5988C223ebb9d3690dD5007",
     v3Quoter: "0x6Dd37329A1A225a6Fca658265D460423DCafBF89",
     v4Initializer: "0x992375478626E67F4e639d3298EbCAaE51C3dF0b",
@@ -510,6 +566,14 @@ var ADDRESSES = {
   [CHAIN_IDS.MONAD_TESTNET]: {
     airlock: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.MONAD_TESTNET].Airlock,
     tokenFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.MONAD_TESTNET].TokenFactory80,
+    derc20V2Factory: getGeneratedAddress(
+      CHAIN_IDS.MONAD_TESTNET,
+      "CloneDERC20VotesV2Factory"
+    ),
+    derc20V2Implementation: getGeneratedAddress(
+      CHAIN_IDS.MONAD_TESTNET,
+      "CloneDERC20VotesV2"
+    ),
     v3Initializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.MONAD_TESTNET].UniswapV3Initializer,
     v3Quoter: ZERO_ADDRESS,
     v4Initializer: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.MONAD_TESTNET].UniswapV4Initializer,
@@ -534,6 +598,14 @@ var ADDRESSES = {
   [CHAIN_IDS.MONAD_MAINNET]: {
     airlock: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.MONAD_MAINNET].Airlock,
     tokenFactory: GENERATED_DOPPLER_DEPLOYMENTS[CHAIN_IDS.MONAD_MAINNET].TokenFactory80,
+    derc20V2Factory: getGeneratedAddress(
+      CHAIN_IDS.MONAD_MAINNET,
+      "CloneDERC20VotesV2Factory"
+    ),
+    derc20V2Implementation: getGeneratedAddress(
+      CHAIN_IDS.MONAD_MAINNET,
+      "CloneDERC20VotesV2"
+    ),
     v3Initializer: ZERO_ADDRESS,
     v3Quoter: "0x66266174564170519409d8853898f065c719536b",
     v4Initializer: ZERO_ADDRESS,
@@ -1774,6 +1846,87 @@ var derc20Abi = [
     ]
   }
 ];
+var derc20V2Abi = [
+  ...derc20Abi,
+  {
+    type: "function",
+    name: "computeAvailableVestedAmount",
+    inputs: [
+      { name: "beneficiary", type: "address", internalType: "address" },
+      { name: "scheduleId", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getScheduleIdsOf",
+    inputs: [{ name: "beneficiary", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "uint256[]", internalType: "uint256[]" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "release",
+    inputs: [{ name: "scheduleId", type: "uint256", internalType: "uint256" }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "releaseFor",
+    inputs: [
+      { name: "beneficiary", type: "address", internalType: "address" },
+      { name: "scheduleId", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "releaseFor",
+    inputs: [{ name: "beneficiary", type: "address", internalType: "address" }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "totalAllocatedOf",
+    inputs: [{ name: "beneficiary", type: "address", internalType: "address" }],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "vestingOf",
+    inputs: [
+      { name: "beneficiary", type: "address", internalType: "address" },
+      { name: "scheduleId", type: "uint256", internalType: "uint256" }
+    ],
+    outputs: [
+      { name: "totalAmount", type: "uint256", internalType: "uint256" },
+      { name: "releasedAmount", type: "uint256", internalType: "uint256" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "vestingScheduleCount",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "vestingSchedules",
+    inputs: [{ name: "", type: "uint256", internalType: "uint256" }],
+    outputs: [
+      { name: "cliff", type: "uint64", internalType: "uint64" },
+      { name: "duration", type: "uint64", internalType: "uint64" }
+    ],
+    stateMutability: "view"
+  }
+];
 var uniswapV4InitializerAbi = [
   {
     type: "function",
@@ -4319,6 +4472,22 @@ var STANDARD_TOKEN_DATA_ABI = [
   { type: "uint256[]" },
   { type: "string" }
 ];
+var STANDARD_TOKEN_V2_DATA_ABI = [
+  { type: "string" },
+  { type: "string" },
+  { type: "uint256" },
+  {
+    type: "tuple[]",
+    components: [
+      { type: "uint64", name: "cliff" },
+      { type: "uint64", name: "duration" }
+    ]
+  },
+  { type: "address[]" },
+  { type: "uint256[]" },
+  { type: "uint256[]" },
+  { type: "string" }
+];
 var DOPPLER404_TOKEN_DATA_ABI = [
   { type: "string" },
   { type: "string" },
@@ -4376,6 +4545,13 @@ function computeCreate2AddressFast(buffer) {
   const hash = viem.keccak256(bytesToHex(buffer));
   return "0x" + hash.slice(-40).toLowerCase();
 }
+function computeSoladyCloneInitCodeHash(implementation) {
+  return viem.keccak256(
+    `0x602c3d8160093d39f33d3d3d3d363d3d37363d73${implementation.slice(
+      2
+    )}5af43d3d93803e602a57fd5bf3`
+  );
+}
 function buildTokenInitHash(params) {
   const {
     variant,
@@ -4384,7 +4560,8 @@ function buildTokenInitHash(params) {
     initialSupply,
     recipient,
     owner,
-    customBytecode
+    customBytecode,
+    v2Implementation
   } = params;
   if (variant === "doppler404") {
     const [name2, symbol2, baseURI] = viem.decodeAbiParameters(
@@ -4409,6 +4586,15 @@ function buildTokenInitHash(params) {
       )
     );
   }
+  if (variant === "standard-v2") {
+    viem.decodeAbiParameters(STANDARD_TOKEN_V2_DATA_ABI, tokenData);
+    if (!v2Implementation) {
+      throw new Error(
+        "TokenAddressMiner: v2Implementation is required for standard-v2 tokens"
+      );
+    }
+    return computeSoladyCloneInitCodeHash(v2Implementation);
+  }
   const [
     name,
     symbol,
@@ -4489,7 +4675,8 @@ function mineTokenAddress(params) {
     initialSupply,
     recipient,
     owner,
-    customBytecode
+    customBytecode,
+    v2Implementation: params.v2Implementation
   });
   const hookConfig = hook ? {
     deployer: hook.deployer,
@@ -5094,6 +5281,8 @@ var erc20BalanceOfAbi = [
   }
 ];
 var TOKEN_FACTORY_80_ADDRESS2 = "0xf0b5141dd9096254b2ca624dff26024f46087229";
+var DERC20_V2_MIN_VESTING_DURATION = 24 * 60 * 60;
+var MAX_UINT64 = (1n << 64n) - 1n;
 var DopplerFactory = class {
   publicClient;
   walletClient;
@@ -5105,6 +5294,285 @@ var DopplerFactory = class {
     this.walletClient = walletClient;
     this.chainId = chainId;
   }
+  hasCustomV2Schedules(vesting) {
+    return (vesting?.schedules?.length ?? 0) > 0 || (vesting?.scheduleIds?.length ?? 0) > 0;
+  }
+  usesDerc20V2Vesting(vesting) {
+    if (!vesting) {
+      return false;
+    }
+    return this.hasCustomV2Schedules(vesting) || (vesting.cliffDuration ?? 0) > 0;
+  }
+  resolveVestingAllocations(args) {
+    if (!args.vesting) {
+      return { recipients: [], amounts: [] };
+    }
+    if (args.vesting.recipients && args.vesting.amounts) {
+      return {
+        recipients: args.vesting.recipients,
+        amounts: args.vesting.amounts
+      };
+    }
+    return {
+      recipients: [args.userAddress],
+      amounts: [args.sale.initialSupply - args.sale.numTokensToSell]
+    };
+  }
+  normalizeV2ScheduleId(scheduleId, label) {
+    if (!Number.isFinite(scheduleId) || !Number.isInteger(scheduleId)) {
+      throw new Error(`${label} must be an integer`);
+    }
+    if (!Number.isSafeInteger(scheduleId)) {
+      throw new Error(`${label} must be a safe integer`);
+    }
+    if (scheduleId < 0) {
+      throw new Error(`${label} cannot be negative`);
+    }
+    return BigInt(scheduleId);
+  }
+  validateUint64LikeNumber(value, fieldPath, options = {}) {
+    const { allowZero = true } = options;
+    if (!Number.isFinite(value) || !Number.isInteger(value)) {
+      throw new Error(`${fieldPath} must be a finite integer`);
+    }
+    if (!Number.isSafeInteger(value)) {
+      throw new Error(`${fieldPath} must be a safe integer`);
+    }
+    if (value < 0) {
+      throw new Error(`${fieldPath} cannot be negative`);
+    }
+    if (!allowZero && value === 0) {
+      throw new Error(`${fieldPath} must be greater than zero`);
+    }
+    if (BigInt(value) > MAX_UINT64) {
+      throw new Error(`${fieldPath} must fit in uint64`);
+    }
+  }
+  resolveV2VestingSchedules(args) {
+    if (!args.vesting) {
+      return { schedules: [], scheduleIds: [] };
+    }
+    if (!this.hasCustomV2Schedules(args.vesting)) {
+      return {
+        schedules: [
+          {
+            cliff: BigInt(args.vesting.cliffDuration ?? 0),
+            duration: BigInt(args.vesting.duration ?? 0)
+          }
+        ],
+        scheduleIds: Array.from({ length: args.recipientCount }, () => 0n)
+      };
+    }
+    const schedules = args.vesting.schedules?.map((schedule) => ({
+      cliff: BigInt(schedule.cliffDuration ?? 0),
+      duration: BigInt(schedule.duration ?? 0)
+    })) ?? [];
+    const explicitScheduleIds = args.vesting.scheduleIds;
+    if (explicitScheduleIds && explicitScheduleIds.length > 0) {
+      return {
+        schedules,
+        scheduleIds: explicitScheduleIds.map(
+          (scheduleId, index) => this.normalizeV2ScheduleId(
+            scheduleId,
+            `Vesting scheduleIds[${index}]`
+          )
+        )
+      };
+    }
+    if (schedules.length === 1) {
+      return {
+        schedules,
+        scheduleIds: Array.from({ length: args.recipientCount }, () => 0n)
+      };
+    }
+    if (schedules.length === args.recipientCount) {
+      return {
+        schedules,
+        scheduleIds: schedules.map((_, index) => BigInt(index))
+      };
+    }
+    throw new Error(
+      "Vesting schedules must either contain exactly one shared schedule or one schedule per recipient when scheduleIds are omitted"
+    );
+  }
+  resolveStandardTokenFactoryMode(args) {
+    if (this.usesDerc20V2Vesting(args.vesting)) {
+      return "v2";
+    }
+    const v2Factory = args.addresses.derc20V2Factory;
+    if (v2Factory && args.tokenFactory.toLowerCase() === v2Factory.toLowerCase()) {
+      return "v2";
+    }
+    return "legacy";
+  }
+  assertStandardTokenFactoryCompatibility(args) {
+    if (this.isDoppler404Token(args.token) || !this.usesDerc20V2Vesting(args.vesting)) {
+      return;
+    }
+    const v2Factory = args.addresses.derc20V2Factory;
+    if (!v2Factory || v2Factory === ZERO_ADDRESS2) {
+      throw new Error(
+        "Cliff vesting requires the DERC20 V2 factory, but no V2 factory is configured for this chain."
+      );
+    }
+    if (args.tokenFactory.toLowerCase() !== v2Factory.toLowerCase()) {
+      throw new Error(
+        "Cliff vesting requires the DERC20 V2 factory. Remove the tokenFactory override or point it at the chain DERC20 V2 factory."
+      );
+    }
+  }
+  buildStandardTokenFactoryData(args) {
+    const { recipients, amounts } = this.resolveVestingAllocations(args);
+    const yearlyMintRate = args.token.yearlyMintRate ?? DEFAULT_V4_YEARLY_MINT_RATE;
+    const mode = this.resolveStandardTokenFactoryMode({
+      vesting: args.vesting,
+      tokenFactory: args.tokenFactory,
+      addresses: args.addresses
+    });
+    if (mode === "v2") {
+      const implementation = args.addresses.derc20V2Implementation;
+      if (!implementation || implementation === ZERO_ADDRESS2) {
+        throw new Error(
+          "DERC20 V2 implementation address not configured for this chain."
+        );
+      }
+      const { schedules, scheduleIds } = this.resolveV2VestingSchedules({
+        vesting: args.vesting,
+        recipientCount: recipients.length
+      });
+      return {
+        kind: "v2",
+        name: args.token.name,
+        symbol: args.token.symbol,
+        initialSupply: args.sale.initialSupply,
+        airlock: args.airlock,
+        yearlyMintRate,
+        schedules,
+        beneficiaries: recipients,
+        scheduleIds,
+        amounts,
+        tokenURI: args.token.tokenURI,
+        implementation
+      };
+    }
+    return {
+      kind: "legacy",
+      name: args.token.name,
+      symbol: args.token.symbol,
+      initialSupply: args.sale.initialSupply,
+      airlock: args.airlock,
+      yearlyMintRate,
+      vestingDuration: BigInt(args.vesting?.duration ?? 0),
+      recipients,
+      amounts,
+      tokenURI: args.token.tokenURI
+    };
+  }
+  encodeStandardTokenFactoryData(tokenFactoryData) {
+    if (tokenFactoryData.kind === "v2") {
+      return viem.encodeAbiParameters(
+        [
+          { type: "string" },
+          { type: "string" },
+          { type: "uint256" },
+          {
+            type: "tuple[]",
+            components: [
+              { type: "uint64", name: "cliff" },
+              { type: "uint64", name: "duration" }
+            ]
+          },
+          { type: "address[]" },
+          { type: "uint256[]" },
+          { type: "uint256[]" },
+          { type: "string" }
+        ],
+        [
+          tokenFactoryData.name,
+          tokenFactoryData.symbol,
+          tokenFactoryData.yearlyMintRate,
+          tokenFactoryData.schedules.map((schedule) => ({
+            cliff: schedule.cliff,
+            duration: schedule.duration
+          })),
+          tokenFactoryData.beneficiaries,
+          tokenFactoryData.scheduleIds,
+          tokenFactoryData.amounts,
+          tokenFactoryData.tokenURI
+        ]
+      );
+    }
+    return viem.encodeAbiParameters(
+      [
+        { type: "string" },
+        { type: "string" },
+        { type: "uint256" },
+        { type: "uint256" },
+        { type: "address[]" },
+        { type: "uint256[]" },
+        { type: "string" }
+      ],
+      [
+        tokenFactoryData.name,
+        tokenFactoryData.symbol,
+        tokenFactoryData.yearlyMintRate,
+        tokenFactoryData.vestingDuration,
+        tokenFactoryData.recipients,
+        tokenFactoryData.amounts,
+        tokenFactoryData.tokenURI
+      ]
+    );
+  }
+  computeSoladyCloneInitCodeHash(implementation) {
+    return viem.keccak256(
+      `0x602c3d8160093d39f33d3d3d3d363d3d37363d73${implementation.slice(
+        2
+      )}5af43d3d93803e602a57fd5bf3`
+    );
+  }
+  computeStandardTokenInitHash(tokenFactoryData, tokenFactory) {
+    if (tokenFactoryData.kind === "v2") {
+      return this.computeSoladyCloneInitCodeHash(
+        tokenFactoryData.implementation
+      );
+    }
+    const initData = viem.encodeAbiParameters(
+      [
+        { type: "string" },
+        { type: "string" },
+        { type: "uint256" },
+        { type: "address" },
+        { type: "address" },
+        { type: "uint256" },
+        { type: "uint256" },
+        { type: "address[]" },
+        { type: "uint256[]" },
+        { type: "string" }
+      ],
+      [
+        tokenFactoryData.name,
+        tokenFactoryData.symbol,
+        tokenFactoryData.initialSupply,
+        tokenFactoryData.airlock,
+        tokenFactoryData.airlock,
+        tokenFactoryData.yearlyMintRate,
+        tokenFactoryData.vestingDuration,
+        tokenFactoryData.recipients,
+        tokenFactoryData.amounts,
+        tokenFactoryData.tokenURI
+      ]
+    );
+    const isTokenFactory802 = tokenFactory.toLowerCase() === TOKEN_FACTORY_80_ADDRESS2;
+    return viem.keccak256(
+      viem.encodePacked(
+        ["bytes", "bytes"],
+        [
+          isTokenFactory802 ? derc2080_default : derc20_default,
+          initData
+        ]
+      )
+    );
+  }
   /**
    * Set a custom migration data encoder function
    * @param encoder Custom function to encode migration data
@@ -5189,6 +5657,18 @@ var DopplerFactory = class {
       numeraire: params.sale.numeraire,
       overrides: params.modules
     });
+    const resolvedTokenFactory = params.modules?.tokenFactory ?? (this.isDoppler404Token(params.token) ? addresses.doppler404Factory : this.usesDerc20V2Vesting(params.vesting) ? addresses.derc20V2Factory : addresses.tokenFactory);
+    if (!resolvedTokenFactory || resolvedTokenFactory === ZERO_ADDRESS2) {
+      throw new Error(
+        "Token factory address not configured. Provide an explicit address via builder.withTokenFactory(...) or ensure chain config includes a valid factory."
+      );
+    }
+    this.assertStandardTokenFactoryCompatibility({
+      token: params.token,
+      vesting: params.vesting,
+      tokenFactory: resolvedTokenFactory,
+      addresses
+    });
     let tokenFactoryData;
     if (this.isDoppler404Token(params.token)) {
       const token404 = params.token;
@@ -5204,41 +5684,17 @@ var DopplerFactory = class {
         [params.token.name, params.token.symbol, baseURI, unit]
       );
     } else {
-      const tokenStd = params.token;
-      const vestingDuration = params.vesting?.duration ?? BigInt(0);
-      const yearlyMintRate = tokenStd.yearlyMintRate ?? DEFAULT_V4_YEARLY_MINT_RATE;
-      let vestingRecipients = [];
-      let vestingAmounts = [];
-      if (params.vesting) {
-        if (params.vesting.recipients && params.vesting.amounts) {
-          vestingRecipients = params.vesting.recipients;
-          vestingAmounts = params.vesting.amounts;
-        } else {
-          vestingRecipients = [params.userAddress];
-          vestingAmounts = [
-            params.sale.initialSupply - params.sale.numTokensToSell
-          ];
-        }
-      }
-      tokenFactoryData = viem.encodeAbiParameters(
-        [
-          { type: "string" },
-          { type: "string" },
-          { type: "uint256" },
-          { type: "uint256" },
-          { type: "address[]" },
-          { type: "uint256[]" },
-          { type: "string" }
-        ],
-        [
-          tokenStd.name,
-          tokenStd.symbol,
-          yearlyMintRate,
-          BigInt(vestingDuration),
-          vestingRecipients,
-          vestingAmounts,
-          tokenStd.tokenURI
-        ]
+      const standardTokenFactoryData = this.buildStandardTokenFactoryData({
+        token: params.token,
+        sale: params.sale,
+        vesting: params.vesting,
+        userAddress: params.userAddress,
+        airlock: params.modules?.airlock ?? addresses.airlock,
+        tokenFactory: resolvedTokenFactory,
+        addresses
+      });
+      tokenFactoryData = this.encodeStandardTokenFactoryData(
+        standardTokenFactoryData
       );
     }
     const governanceFactoryData = (() => {
@@ -5293,12 +5749,6 @@ var DopplerFactory = class {
       }
       return resolved;
     })();
-    const resolvedTokenFactory = params.modules?.tokenFactory ?? (this.isDoppler404Token(params.token) ? addresses.doppler404Factory : addresses.tokenFactory);
-    if (!resolvedTokenFactory || resolvedTokenFactory === ZERO_ADDRESS2) {
-      throw new Error(
-        "Token factory address not configured. Provide an explicit address via builder.withTokenFactory(...) or ensure chain config includes a valid factory."
-      );
-    }
     const baseCreateParams = {
       initialSupply: params.sale.initialSupply,
       numTokensToSell: params.sale.numTokensToSell,
@@ -5584,7 +6034,18 @@ var DopplerFactory = class {
         );
       }
     }
-    const vestingDuration = params.vesting?.duration ?? BigInt(0);
+    const resolvedTokenFactoryDyn = params.modules?.tokenFactory ?? (this.isDoppler404Token(params.token) ? addresses.doppler404Factory : this.usesDerc20V2Vesting(params.vesting) ? addresses.derc20V2Factory : addresses.tokenFactory);
+    if (!resolvedTokenFactoryDyn || resolvedTokenFactoryDyn === ZERO_ADDRESS2) {
+      throw new Error(
+        "Token factory address not configured. Provide an explicit address via builder.withTokenFactory(...) or ensure chain config includes a valid factory."
+      );
+    }
+    this.assertStandardTokenFactoryCompatibility({
+      token: params.token,
+      vesting: params.vesting,
+      tokenFactory: resolvedTokenFactoryDyn,
+      addresses
+    });
     const tokenFactoryData = this.isDoppler404Token(params.token) ? (() => {
       const t = params.token;
       return {
@@ -5593,39 +6054,15 @@ var DopplerFactory = class {
         baseURI: t.baseURI,
         unit: t.unit !== void 0 ? BigInt(t.unit) : 1000n
       };
-    })() : (() => {
-      const t = params.token;
-      let vestingRecipients = [];
-      let vestingAmounts = [];
-      if (params.vesting) {
-        if (params.vesting.recipients && params.vesting.amounts) {
-          vestingRecipients = params.vesting.recipients;
-          vestingAmounts = params.vesting.amounts;
-        } else {
-          vestingRecipients = [params.userAddress];
-          vestingAmounts = [
-            params.sale.initialSupply - params.sale.numTokensToSell
-          ];
-        }
-      }
-      return {
-        name: t.name,
-        symbol: t.symbol,
-        initialSupply: params.sale.initialSupply,
-        airlock: addresses.airlock,
-        yearlyMintRate: t.yearlyMintRate ?? DEFAULT_V4_YEARLY_MINT_RATE,
-        vestingDuration: BigInt(vestingDuration),
-        recipients: vestingRecipients,
-        amounts: vestingAmounts,
-        tokenURI: t.tokenURI
-      };
-    })();
-    const resolvedTokenFactoryDyn = params.modules?.tokenFactory ?? (this.isDoppler404Token(params.token) ? addresses.doppler404Factory : addresses.tokenFactory);
-    if (!resolvedTokenFactoryDyn || resolvedTokenFactoryDyn === ZERO_ADDRESS2) {
-      throw new Error(
-        "Token factory address not configured. Provide an explicit address via builder.withTokenFactory(...) or ensure chain config includes a valid factory."
-      );
-    }
+    })() : this.buildStandardTokenFactoryData({
+      token: params.token,
+      sale: params.sale,
+      vesting: params.vesting,
+      userAddress: params.userAddress,
+      airlock: params.modules?.airlock ?? addresses.airlock,
+      tokenFactory: resolvedTokenFactoryDyn,
+      addresses
+    });
     const [
       salt,
       hookAddress,
@@ -5952,7 +6389,18 @@ var DopplerFactory = class {
         );
       }
     }
-    const vestingDuration = params.vesting?.duration ?? BigInt(0);
+    const resolvedTokenFactory = params.modules?.tokenFactory ?? (this.isDoppler404Token(params.token) ? addresses.doppler404Factory : this.usesDerc20V2Vesting(params.vesting) ? addresses.derc20V2Factory : addresses.tokenFactory);
+    if (!resolvedTokenFactory || resolvedTokenFactory === ZERO_ADDRESS2) {
+      throw new Error(
+        "Token factory address not configured. Provide an explicit address via builder.withTokenFactory(...) or ensure chain config includes a valid factory."
+      );
+    }
+    this.assertStandardTokenFactoryCompatibility({
+      token: params.token,
+      vesting: params.vesting,
+      tokenFactory: resolvedTokenFactory,
+      addresses
+    });
     const tokenFactoryData = this.isDoppler404Token(params.token) ? (() => {
       const t = params.token;
       return {
@@ -5961,39 +6409,15 @@ var DopplerFactory = class {
         baseURI: t.baseURI,
         unit: t.unit !== void 0 ? BigInt(t.unit) : 1000n
       };
-    })() : (() => {
-      const t = params.token;
-      let vestingRecipients = [];
-      let vestingAmounts = [];
-      if (params.vesting) {
-        if (params.vesting.recipients && params.vesting.amounts) {
-          vestingRecipients = params.vesting.recipients;
-          vestingAmounts = params.vesting.amounts;
-        } else {
-          vestingRecipients = [params.userAddress];
-          vestingAmounts = [
-            params.sale.initialSupply - params.sale.numTokensToSell
-          ];
-        }
-      }
-      return {
-        name: t.name,
-        symbol: t.symbol,
-        initialSupply: params.sale.initialSupply,
-        airlock: params.modules?.airlock ?? addresses.airlock,
-        yearlyMintRate: t.yearlyMintRate ?? DEFAULT_V4_YEARLY_MINT_RATE,
-        vestingDuration: BigInt(vestingDuration),
-        recipients: vestingRecipients,
-        amounts: vestingAmounts,
-        tokenURI: t.tokenURI
-      };
-    })();
-    const resolvedTokenFactory = params.modules?.tokenFactory ?? (this.isDoppler404Token(params.token) ? addresses.doppler404Factory : addresses.tokenFactory);
-    if (!resolvedTokenFactory || resolvedTokenFactory === ZERO_ADDRESS2) {
-      throw new Error(
-        "Token factory address not configured. Provide an explicit address via builder.withTokenFactory(...) or ensure chain config includes a valid factory."
-      );
-    }
+    })() : this.buildStandardTokenFactoryData({
+      token: params.token,
+      sale: params.sale,
+      vesting: params.vesting,
+      userAddress: params.userAddress,
+      airlock: params.modules?.airlock ?? addresses.airlock,
+      tokenFactory: resolvedTokenFactory,
+      addresses
+    });
     const auctionTokens = params.sale.numTokensToSell * BigInt(params.openingAuction.shareToAuctionBps) / 10000n;
     if (auctionTokens <= 0n) {
       throw new Error("Opening auction token allocation rounds to zero");
@@ -6767,69 +7191,23 @@ var DopplerFactory = class {
         ["bytes", "bytes"],
         [openingAuction_default, initHashData]
       )
-    );
-    const encodedTokenFactoryData = params.tokenVariant === "doppler404" ? (() => {
-      const t = params.tokenFactoryData;
-      return viem.encodeAbiParameters(
-        [
-          { type: "string" },
-          { type: "string" },
-          { type: "string" },
-          { type: "uint256" }
-        ],
-        [t.name, t.symbol, t.baseURI, t.unit ?? 1000n]
-      );
-    })() : (() => {
-      const t = params.tokenFactoryData;
-      return viem.encodeAbiParameters(
-        [
-          { type: "string" },
-          { type: "string" },
-          { type: "uint256" },
-          { type: "uint256" },
-          { type: "address[]" },
-          { type: "uint256[]" },
-          { type: "string" }
-        ],
-        [
-          t.name,
-          t.symbol,
-          t.yearlyMintRate,
-          t.vestingDuration,
-          t.recipients,
-          t.amounts,
-          t.tokenURI
-        ]
-      );
-    })();
-    let tokenInitHash;
-    if (params.tokenVariant === "doppler404") {
-      const t = params.tokenFactoryData;
-      const initData = viem.encodeAbiParameters(
-        [
-          { type: "string" },
-          { type: "string" },
-          { type: "uint256" },
-          { type: "address" },
-          { type: "address" },
-          { type: "string" }
-        ],
-        [
-          t.name,
-          t.symbol,
-          params.initialSupply,
-          params.airlock,
-          params.airlock,
-          t.baseURI
-        ]
-      );
-      tokenInitHash = viem.keccak256(
-        viem.encodePacked(
-          ["bytes", "bytes"],
-          [dopplerDN404_default, initData]
-        )
+    );
+    const encodedTokenFactoryData = params.tokenVariant === "doppler404" ? (() => {
+      const t = params.tokenFactoryData;
+      return viem.encodeAbiParameters(
+        [
+          { type: "string" },
+          { type: "string" },
+          { type: "string" },
+          { type: "uint256" }
+        ],
+        [t.name, t.symbol, t.baseURI, t.unit ?? 1000n]
       );
-    } else {
+    })() : this.encodeStandardTokenFactoryData(
+      params.tokenFactoryData
+    );
+    let tokenInitHash;
+    if (params.tokenVariant === "doppler404") {
       const t = params.tokenFactoryData;
       const initData = viem.encodeAbiParameters(
         [
@@ -6838,10 +7216,6 @@ var DopplerFactory = class {
           { type: "uint256" },
           { type: "address" },
           { type: "address" },
-          { type: "uint256" },
-          { type: "uint256" },
-          { type: "address[]" },
-          { type: "uint256[]" },
           { type: "string" }
         ],
         [
@@ -6850,23 +7224,20 @@ var DopplerFactory = class {
           params.initialSupply,
           params.airlock,
           params.airlock,
-          t.yearlyMintRate,
-          t.vestingDuration,
-          t.recipients,
-          t.amounts,
-          t.tokenURI
+          t.baseURI
         ]
       );
-      const isTokenFactory802 = params.tokenFactory.toLowerCase() === TOKEN_FACTORY_80_ADDRESS2;
       tokenInitHash = viem.keccak256(
         viem.encodePacked(
           ["bytes", "bytes"],
-          [
-            isTokenFactory802 ? derc2080_default : derc20_default,
-            initData
-          ]
+          [dopplerDN404_default, initData]
         )
       );
+    } else {
+      tokenInitHash = this.computeStandardTokenInitHash(
+        params.tokenFactoryData,
+        params.tokenFactory
+      );
     }
     const isToken0 = isToken0Expected(params.numeraire);
     const numeraireBigInt = BigInt(params.numeraire);
@@ -7542,6 +7913,18 @@ var DopplerFactory = class {
         ]
       );
     }
+    const resolvedTokenFactory = params.modules?.tokenFactory ?? (this.isDoppler404Token(params.token) ? addresses.doppler404Factory : this.usesDerc20V2Vesting(params.vesting) ? addresses.derc20V2Factory : addresses.tokenFactory);
+    if (!resolvedTokenFactory || resolvedTokenFactory === ZERO_ADDRESS2) {
+      throw new Error(
+        "Token factory address not configured. Provide an explicit address or ensure chain config includes a valid factory."
+      );
+    }
+    this.assertStandardTokenFactoryCompatibility({
+      token: params.token,
+      vesting: params.vesting,
+      tokenFactory: resolvedTokenFactory,
+      addresses
+    });
     let tokenFactoryData;
     if (this.isDoppler404Token(params.token)) {
       const token404 = params.token;
@@ -7556,41 +7939,17 @@ var DopplerFactory = class {
         [token404.name, token404.symbol, token404.baseURI, unit]
       );
     } else {
-      const tokenStd = params.token;
-      const vestingDuration = params.vesting?.duration ?? BigInt(0);
-      const yearlyMintRate = tokenStd.yearlyMintRate ?? DEFAULT_V4_YEARLY_MINT_RATE;
-      let vestingRecipients = [];
-      let vestingAmounts = [];
-      if (params.vesting) {
-        if (params.vesting.recipients && params.vesting.amounts) {
-          vestingRecipients = params.vesting.recipients;
-          vestingAmounts = params.vesting.amounts;
-        } else {
-          vestingRecipients = [params.userAddress];
-          vestingAmounts = [
-            params.sale.initialSupply - params.sale.numTokensToSell
-          ];
-        }
-      }
-      tokenFactoryData = viem.encodeAbiParameters(
-        [
-          { type: "string" },
-          { type: "string" },
-          { type: "uint256" },
-          { type: "uint256" },
-          { type: "address[]" },
-          { type: "uint256[]" },
-          { type: "string" }
-        ],
-        [
-          tokenStd.name,
-          tokenStd.symbol,
-          yearlyMintRate,
-          BigInt(vestingDuration),
-          vestingRecipients,
-          vestingAmounts,
-          tokenStd.tokenURI
-        ]
+      const standardTokenFactoryData = this.buildStandardTokenFactoryData({
+        token: params.token,
+        sale: params.sale,
+        vesting: params.vesting,
+        userAddress: params.userAddress,
+        airlock: params.modules?.airlock ?? addresses.airlock,
+        tokenFactory: resolvedTokenFactory,
+        addresses
+      });
+      tokenFactoryData = this.encodeStandardTokenFactoryData(
+        standardTokenFactoryData
       );
     }
     const governanceFactoryData = (() => {
@@ -7619,12 +7978,6 @@ var DopplerFactory = class {
       );
     })();
     const salt = this.generateRandomSalt(params.userAddress);
-    const resolvedTokenFactory = params.modules?.tokenFactory ?? (this.isDoppler404Token(params.token) ? addresses.doppler404Factory : addresses.tokenFactory);
-    if (!resolvedTokenFactory || resolvedTokenFactory === ZERO_ADDRESS2) {
-      throw new Error(
-        "Token factory address not configured. Provide an explicit address or ensure chain config includes a valid factory."
-      );
-    }
     const resolvedInitializer = (() => {
       if (useDopplerHookInitializer) {
         return params.modules?.dopplerHookInitializer ?? addresses.dopplerHookInitializer;
@@ -7877,6 +8230,109 @@ var DopplerFactory = class {
     const rounded = Math.floor(MAX_TICK / tickSpacing) * tickSpacing;
     return rounded;
   }
+  validateVestingConfig(sale, vesting) {
+    if (!vesting) {
+      return;
+    }
+    const cliffDuration = vesting.cliffDuration ?? 0;
+    const duration = vesting.duration ?? 0;
+    const hasCustomSchedules = this.hasCustomV2Schedules(vesting);
+    if (hasCustomSchedules && (cliffDuration > 0 || duration > 0)) {
+      throw new Error(
+        "Use vesting.schedules instead of top-level duration/cliffDuration when configuring multiple vesting schedules"
+      );
+    }
+    if (vesting.recipients && vesting.amounts) {
+      if (vesting.recipients.length !== vesting.amounts.length) {
+        throw new Error(
+          "Vesting recipients and amounts arrays must have the same length"
+        );
+      }
+      if (vesting.recipients.length === 0) {
+        throw new Error("Vesting recipients array cannot be empty");
+      }
+      const totalVested = vesting.amounts.reduce((sum, amt) => sum + amt, 0n);
+      const availableForVesting = sale.initialSupply - sale.numTokensToSell;
+      if (totalVested > availableForVesting) {
+        throw new Error(
+          `Total vesting amount (${totalVested}) exceeds available tokens (${availableForVesting})`
+        );
+      }
+    } else {
+      const vestedAmount = sale.initialSupply - sale.numTokensToSell;
+      if (vestedAmount <= 0n) {
+        throw new Error("No tokens available for vesting");
+      }
+    }
+    if (hasCustomSchedules) {
+      const schedules = vesting.schedules;
+      if (!schedules || schedules.length === 0) {
+        throw new Error(
+          "Vesting schedules are required when using scheduleIds or multiple vesting schedules"
+        );
+      }
+      const recipientCount = vesting.recipients && vesting.amounts ? vesting.recipients.length : 1;
+      if (vesting.scheduleIds) {
+        if (vesting.scheduleIds.length !== recipientCount) {
+          throw new Error(
+            "Vesting scheduleIds array must have the same length as vesting recipients"
+          );
+        }
+        for (const [index, scheduleId] of vesting.scheduleIds.entries()) {
+          this.validateUint64LikeNumber(
+            scheduleId,
+            `Vesting scheduleIds[${index}]`
+          );
+          if (scheduleId >= schedules.length) {
+            throw new Error(
+              `Vesting scheduleIds[${index}] references missing schedule ${scheduleId}`
+            );
+          }
+        }
+      } else if (schedules.length !== 1 && schedules.length !== recipientCount) {
+        throw new Error(
+          "Vesting schedules must either contain exactly one shared schedule or one schedule per recipient when scheduleIds are omitted"
+        );
+      }
+      for (const [index, schedule] of schedules.entries()) {
+        const scheduleCliff = schedule.cliffDuration ?? 0;
+        const scheduleDuration = schedule.duration ?? 0;
+        this.validateUint64LikeNumber(
+          scheduleCliff,
+          `Vesting schedules[${index}].cliffDuration`
+        );
+        this.validateUint64LikeNumber(
+          scheduleDuration,
+          `Vesting schedules[${index}].duration`
+        );
+        if (scheduleCliff > scheduleDuration) {
+          throw new Error(
+            `Vesting schedules[${index}].cliffDuration cannot exceed duration`
+          );
+        }
+        if (scheduleCliff > 0 && scheduleDuration > 0 && scheduleDuration < DERC20_V2_MIN_VESTING_DURATION) {
+          throw new Error(
+            `Vesting schedules[${index}].duration must be 0 or at least ${DERC20_V2_MIN_VESTING_DURATION} seconds when using cliffs`
+          );
+        }
+      }
+      return;
+    }
+    if (cliffDuration < 0) {
+      throw new Error("Vesting cliff duration cannot be negative");
+    }
+    if (duration < 0) {
+      throw new Error("Vesting duration cannot be negative");
+    }
+    if (cliffDuration > duration) {
+      throw new Error("Vesting cliff duration cannot exceed vesting duration");
+    }
+    if (cliffDuration > 0 && duration > 0 && duration < DERC20_V2_MIN_VESTING_DURATION) {
+      throw new Error(
+        `Vesting duration must be 0 or at least ${DERC20_V2_MIN_VESTING_DURATION} seconds when using cliffs`
+      );
+    }
+  }
   validateStaticAuctionParams(params) {
     if (!params.token.name || params.token.name.trim().length === 0) {
       throw new Error("Token name is required");
@@ -7914,33 +8370,7 @@ var DopplerFactory = class {
     if (params.sale.numTokensToSell > params.sale.initialSupply) {
       throw new Error("Cannot sell more tokens than initial supply");
     }
-    if (params.vesting) {
-      if (params.vesting.recipients && params.vesting.amounts) {
-        if (params.vesting.recipients.length !== params.vesting.amounts.length) {
-          throw new Error(
-            "Vesting recipients and amounts arrays must have the same length"
-          );
-        }
-        if (params.vesting.recipients.length === 0) {
-          throw new Error("Vesting recipients array cannot be empty");
-        }
-        const totalVested = params.vesting.amounts.reduce(
-          (sum, amt) => sum + amt,
-          BigInt(0)
-        );
-        const availableForVesting = params.sale.initialSupply - params.sale.numTokensToSell;
-        if (totalVested > availableForVesting) {
-          throw new Error(
-            `Total vesting amount (${totalVested}) exceeds available tokens (${availableForVesting})`
-          );
-        }
-      } else {
-        const vestedAmount = params.sale.initialSupply - params.sale.numTokensToSell;
-        if (vestedAmount <= BigInt(0)) {
-          throw new Error("No tokens available for vesting");
-        }
-      }
-    }
+    this.validateVestingConfig(params.sale, params.vesting);
     if (params.migration.type === "dopplerHook") {
       throw new Error(
         "dopplerHook migration is only supported for dynamic auctions"
@@ -8005,6 +8435,7 @@ var DopplerFactory = class {
     if (params.sale.numTokensToSell > params.sale.initialSupply) {
       throw new Error("Cannot sell more tokens than initial supply");
     }
+    this.validateVestingConfig(params.sale, params.vesting);
     if (params.auction.duration <= 0) {
       throw new Error("Auction duration must be positive");
     }
@@ -8233,28 +8664,7 @@ var DopplerFactory = class {
       throw new Error("Cannot sell more tokens than initial supply");
     }
     this.resolveMulticurveInitializerMode(params);
-    if (params.vesting) {
-      if (params.vesting.recipients && params.vesting.amounts) {
-        if (params.vesting.recipients.length !== params.vesting.amounts.length) {
-          throw new Error(
-            "Vesting recipients and amounts arrays must have the same length"
-          );
-        }
-        if (params.vesting.recipients.length === 0) {
-          throw new Error("Vesting recipients array cannot be empty");
-        }
-        const totalVested = params.vesting.amounts.reduce(
-          (sum, amt) => sum + amt,
-          BigInt(0)
-        );
-        const availableForVesting = params.sale.initialSupply - params.sale.numTokensToSell;
-        if (totalVested > availableForVesting) {
-          throw new Error(
-            `Total vesting amount (${totalVested}) exceeds available tokens (${availableForVesting})`
-          );
-        }
-      }
-    }
+    this.validateVestingConfig(params.sale, params.vesting);
     if (params.pool.beneficiaries && params.pool.beneficiaries.length > 0) {
       const beneficiaries = params.pool.beneficiaries;
       const totalShares = beneficiaries.reduce((sum, b) => sum + b.shares, 0n);
@@ -8654,37 +9064,9 @@ var DopplerFactory = class {
         ],
         [t.name, t.symbol, t.baseURI, t.unit ?? 1000n]
       );
-    })() : (() => {
-      const {
-        name,
-        symbol,
-        yearlyMintRate,
-        vestingDuration,
-        recipients,
-        amounts,
-        tokenURI
-      } = params.tokenFactoryData;
-      return viem.encodeAbiParameters(
-        [
-          { type: "string" },
-          { type: "string" },
-          { type: "uint256" },
-          { type: "uint256" },
-          { type: "address[]" },
-          { type: "uint256[]" },
-          { type: "string" }
-        ],
-        [
-          name,
-          symbol,
-          yearlyMintRate,
-          vestingDuration,
-          recipients,
-          amounts,
-          tokenURI
-        ]
-      );
-    })();
+    })() : this.encodeStandardTokenFactoryData(
+      params.tokenFactoryData
+    );
     let tokenInitHash;
     if (params.tokenVariant === "doppler404") {
       const { name, symbol, baseURI } = params.tokenFactoryData;
@@ -8707,47 +9089,45 @@ var DopplerFactory = class {
         )
       );
     } else {
-      const {
-        name,
-        symbol,
-        yearlyMintRate,
-        vestingDuration,
-        recipients,
-        amounts,
-        tokenURI
-      } = params.tokenFactoryData;
-      const { airlock, initialSupply } = params;
-      const initHashData = viem.encodeAbiParameters(
-        [
-          { type: "string" },
-          { type: "string" },
-          { type: "uint256" },
-          { type: "address" },
-          { type: "address" },
-          { type: "uint256" },
-          { type: "uint256" },
-          { type: "address[]" },
-          { type: "uint256[]" },
-          { type: "string" }
-        ],
-        [
-          name,
-          symbol,
-          initialSupply,
-          airlock,
-          airlock,
-          yearlyMintRate,
-          vestingDuration,
-          recipients,
-          amounts,
-          tokenURI
-        ]
-      );
-      const isTokenFactory802 = params.tokenFactory.toLowerCase() === TOKEN_FACTORY_80_ADDRESS2;
-      const bytecode = isTokenFactory802 ? derc2080_default : params.customDerc20Bytecode ?? derc20_default;
-      tokenInitHash = viem.keccak256(
-        viem.encodePacked(["bytes", "bytes"], [bytecode, initHashData])
-      );
+      const standardTokenFactoryData = params.tokenFactoryData;
+      if (standardTokenFactoryData.kind === "v2") {
+        tokenInitHash = this.computeStandardTokenInitHash(
+          standardTokenFactoryData,
+          params.tokenFactory
+        );
+      } else {
+        const initHashData = viem.encodeAbiParameters(
+          [
+            { type: "string" },
+            { type: "string" },
+            { type: "uint256" },
+            { type: "address" },
+            { type: "address" },
+            { type: "uint256" },
+            { type: "uint256" },
+            { type: "address[]" },
+            { type: "uint256[]" },
+            { type: "string" }
+          ],
+          [
+            standardTokenFactoryData.name,
+            standardTokenFactoryData.symbol,
+            standardTokenFactoryData.initialSupply,
+            standardTokenFactoryData.airlock,
+            standardTokenFactoryData.airlock,
+            standardTokenFactoryData.yearlyMintRate,
+            standardTokenFactoryData.vestingDuration,
+            standardTokenFactoryData.recipients,
+            standardTokenFactoryData.amounts,
+            standardTokenFactoryData.tokenURI
+          ]
+        );
+        const isTokenFactory802 = params.tokenFactory.toLowerCase() === TOKEN_FACTORY_80_ADDRESS2;
+        const bytecode = isTokenFactory802 ? derc2080_default : params.customDerc20Bytecode ?? derc20_default;
+        tokenInitHash = viem.keccak256(
+          viem.encodePacked(["bytes", "bytes"], [bytecode, initHashData])
+        );
+      }
     }
     const flags = BigInt(
       1 << 13 | // BEFORE_INITIALIZE_FLAG
@@ -13028,6 +13408,108 @@ var Derc20 = class _Derc20 {
     );
   }
 };
+
+// src/evm/entities/token/derc20/Derc20V2.ts
+var Derc20V2 = class extends Derc20 {
+  async getVestingScheduleCount() {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20V2Abi,
+      functionName: "vestingScheduleCount"
+    });
+  }
+  async getVestingSchedule(scheduleId) {
+    const result = await this.rpc.readContract({
+      address: this.address,
+      abi: derc20V2Abi,
+      functionName: "vestingSchedules",
+      args: [scheduleId]
+    });
+    return {
+      cliffDuration: BigInt(result[0]),
+      duration: BigInt(result[1])
+    };
+  }
+  async getScheduleIdsOf(beneficiary) {
+    const result = await this.rpc.readContract({
+      address: this.address,
+      abi: derc20V2Abi,
+      functionName: "getScheduleIdsOf",
+      args: [beneficiary]
+    });
+    return Array.from(result);
+  }
+  async getTotalAllocatedOf(beneficiary) {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20V2Abi,
+      functionName: "totalAllocatedOf",
+      args: [beneficiary]
+    });
+  }
+  async getAvailableVestedAmountForSchedule(beneficiary, scheduleId) {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20V2Abi,
+      functionName: "computeAvailableVestedAmount",
+      args: [beneficiary, scheduleId]
+    });
+  }
+  async getVestingDataForSchedule(beneficiary, scheduleId) {
+    const result = await this.rpc.readContract({
+      address: this.address,
+      abi: derc20V2Abi,
+      functionName: "vestingOf",
+      args: [beneficiary, scheduleId]
+    });
+    return {
+      totalAmount: result[0],
+      releasedAmount: result[1]
+    };
+  }
+  async releaseSchedule(scheduleId, options) {
+    if (!this.walletClient) {
+      throw new Error("Wallet client required for write operations");
+    }
+    const { request } = await this.rpc.simulateContract({
+      address: this.address,
+      abi: derc20V2Abi,
+      functionName: "release",
+      args: [scheduleId],
+      account: this.walletClient.account
+    });
+    return await this.walletClient.writeContract(
+      options?.gas ? { ...request, gas: options.gas } : request
+    );
+  }
+  async releaseFor(beneficiary, scheduleId, options) {
+    if (!this.walletClient) {
+      throw new Error("Wallet client required for write operations");
+    }
+    if (scheduleId === void 0) {
+      const { request: request2 } = await this.rpc.simulateContract({
+        address: this.address,
+        abi: derc20V2Abi,
+        functionName: "releaseFor",
+        args: [beneficiary],
+        account: this.walletClient.account
+      });
+      return await this.walletClient.writeContract(
+        options?.gas ? { ...request2, gas: options.gas } : request2
+      );
+    }
+    const { request } = await this.rpc.simulateContract({
+      address: this.address,
+      abi: derc20V2Abi,
+      functionName: "releaseFor",
+      args: [beneficiary, scheduleId],
+      account: this.walletClient.account
+    });
+    return await this.walletClient.writeContract(
+      options?.gas ? { ...request, gas: options.gas } : request
+    );
+  }
+};
 var Eth = class {
   publicClient;
   get rpc() {
@@ -13083,6 +13565,35 @@ var Eth = class {
 };
 
 // src/evm/builders/shared.ts
+var MAX_SAFE_INTEGER_BIGINT = BigInt(Number.MAX_SAFE_INTEGER);
+function normalizeBuilderVestingScheduleDuration(value, fieldPath) {
+  const duration = value ?? 0n;
+  if (duration < 0n) {
+    throw new RangeError(`${fieldPath} cannot be negative`);
+  }
+  if (duration > MAX_SAFE_INTEGER_BIGINT) {
+    throw new RangeError(`${fieldPath} must be a safe integer`);
+  }
+  return Number(duration);
+}
+function normalizeBuilderScheduleId(scheduleId, fieldPath) {
+  if (typeof scheduleId === "bigint") {
+    if (scheduleId < 0n) {
+      throw new RangeError(`${fieldPath} cannot be negative`);
+    }
+    if (scheduleId > MAX_SAFE_INTEGER_BIGINT) {
+      throw new RangeError(`${fieldPath} must be a safe integer`);
+    }
+    return Number(scheduleId);
+  }
+  if (!Number.isSafeInteger(scheduleId)) {
+    throw new RangeError(`${fieldPath} must be a safe integer`);
+  }
+  if (scheduleId < 0) {
+    throw new RangeError(`${fieldPath} cannot be negative`);
+  }
+  return scheduleId;
+}
 function computeTicks(priceRange, tickSpacing) {
   const startTick = Math.floor(
     Math.log(priceRange.startPrice) / Math.log(1.0001) / tickSpacing
@@ -13378,11 +13889,24 @@ var StaticAuctionBuilder = class _StaticAuctionBuilder {
       this.vesting = void 0;
       return this;
     }
+    const hasCustomSchedules = (params.schedules?.length ?? 0) > 0 || (params.scheduleIds?.length ?? 0) > 0;
     this.vesting = {
-      duration: Number(params.duration ?? DEFAULT_V3_VESTING_DURATION),
+      duration: Number(
+        params.duration ?? (hasCustomSchedules ? 0n : DEFAULT_V3_VESTING_DURATION)
+      ),
       cliffDuration: params.cliffDuration ?? 0,
       recipients: params.recipients,
-      amounts: params.amounts
+      amounts: params.amounts,
+      schedules: params.schedules?.map((schedule) => ({
+        duration: normalizeBuilderVestingScheduleDuration(
+          schedule.duration,
+          "Vesting schedule duration"
+        ),
+        cliffDuration: schedule.cliffDuration ?? 0
+      })),
+      scheduleIds: params.scheduleIds?.map(
+        (scheduleId, index) => normalizeBuilderScheduleId(scheduleId, `Vesting scheduleIds[${index}]`)
+      )
     };
     return this;
   }
@@ -13714,7 +14238,17 @@ var DynamicAuctionBuilder = class _DynamicAuctionBuilder {
       duration: Number(params.duration ?? 0n),
       cliffDuration: params.cliffDuration ?? 0,
       recipients: params.recipients,
-      amounts: params.amounts
+      amounts: params.amounts,
+      schedules: params.schedules?.map((schedule) => ({
+        duration: normalizeBuilderVestingScheduleDuration(
+          schedule.duration,
+          "Vesting schedule duration"
+        ),
+        cliffDuration: schedule.cliffDuration ?? 0
+      })),
+      scheduleIds: params.scheduleIds?.map(
+        (scheduleId, index) => normalizeBuilderScheduleId(scheduleId, `Vesting scheduleIds[${index}]`)
+      )
     };
     return this;
   }
@@ -14320,7 +14854,17 @@ var MulticurveBuilder = class _MulticurveBuilder {
       duration: Number(params.duration ?? 0n),
       cliffDuration: params.cliffDuration ?? 0,
       recipients: params.recipients,
-      amounts: params.amounts
+      amounts: params.amounts,
+      schedules: params.schedules?.map((schedule) => ({
+        duration: normalizeBuilderVestingScheduleDuration(
+          schedule.duration,
+          "Vesting schedule duration"
+        ),
+        cliffDuration: schedule.cliffDuration ?? 0
+      })),
+      scheduleIds: params.scheduleIds?.map(
+        (scheduleId, index) => normalizeBuilderScheduleId(scheduleId, `Vesting scheduleIds[${index}]`)
+      )
     };
     return this;
   }
@@ -14709,7 +15253,17 @@ var OpeningAuctionBuilder = class _OpeningAuctionBuilder {
       duration: Number(params.duration ?? 0n),
       cliffDuration: params.cliffDuration ?? 0,
       recipients: params.recipients,
-      amounts: params.amounts
+      amounts: params.amounts,
+      schedules: params.schedules?.map((schedule) => ({
+        duration: normalizeBuilderVestingScheduleDuration(
+          schedule.duration,
+          "Vesting schedule duration"
+        ),
+        cliffDuration: schedule.cliffDuration ?? 0
+      })),
+      scheduleIds: params.scheduleIds?.map(
+        (scheduleId, index) => normalizeBuilderScheduleId(scheduleId, `Vesting scheduleIds[${index}]`)
+      )
     };
     return this;
   }
@@ -15155,6 +15709,13 @@ var DopplerSDK = class {
   getDerc20(tokenAddress) {
     return new Derc20(this.publicClient, this.walletClient, tokenAddress);
   }
+  /**
+   * Get a DERC20 V2 token instance for interacting with cliffed / multi-schedule vesting tokens
+   * @param tokenAddress The address of the DERC20 V2 token
+   */
+  getDerc20V2(tokenAddress) {
+    return new Derc20V2(this.publicClient, this.walletClient, tokenAddress);
+  }
   /**
    * Get information about a static auction pool
    * @param poolAddress The address of the pool
@@ -15277,6 +15838,7 @@ exports.DOPPLER_FLAGS = DOPPLER_FLAGS;
 exports.DOPPLER_MAX_TICK_SPACING = DOPPLER_MAX_TICK_SPACING;
 exports.DYNAMIC_FEE_FLAG = DYNAMIC_FEE_FLAG;
 exports.Derc20 = Derc20;
+exports.Derc20V2 = Derc20V2;
 exports.DopplerBytecode = doppler_default;
 exports.DopplerDN404Bytecode = dopplerDN404_default;
 exports.DopplerFactory = DopplerFactory;
@@ -15347,6 +15909,7 @@ exports.createAirlockBeneficiary = createAirlockBeneficiary;
 exports.decayMulticurveInitializerHookAbi = decayMulticurveInitializerHookAbi;
 exports.decodeBalanceDelta = decodeBalanceDelta;
 exports.derc20Abi = derc20Abi;
+exports.derc20V2Abi = derc20V2Abi;
 exports.dopplerHookAbi = dopplerHookAbi;
 exports.dopplerHookInitializerAbi = dopplerHookInitializerAbi;
 exports.dopplerLensAbi = dopplerLensAbi;