@whetstone-research/doppler-sdk 0.0.24 → 1.0.0

package/dist/builders/MulticurveBuilder.d.mts

@@ -1,196 +0,0 @@
-import { Address } from 'viem';
-import { MulticurveMarketCapPreset, MulticurveMarketCapCurvesConfig, RehypeDopplerHookConfig, GovernanceOption, MigrationConfig, CreateMulticurveParams } from '../types.mjs';
-import { SupportedChainId } from '../addresses.mjs';
-import { BaseAuctionBuilder, MarketCapPresetOverrides } from './shared.mjs';
-import 'viem/chains';
-
-declare class MulticurveBuilder<C extends SupportedChainId> implements BaseAuctionBuilder<C> {
-    private token?;
-    private sale?;
-    private pool?;
-    private initializer?;
-    private schedule?;
-    private dopplerHook?;
-    private vesting?;
-    private governance?;
-    private migration?;
-    private integrator?;
-    private userAddress?;
-    private moduleAddresses?;
-    private gasLimit?;
-    private numerairePrice?;
-    private tokenDecimals?;
-    private numeraireDecimals?;
-    private curvesConfig?;
-    chainId: C;
-    constructor(chainId: C);
-    static forChain<C extends SupportedChainId>(chainId: C): MulticurveBuilder<C>;
-    tokenConfig(params: {
-        type?: 'standard';
-        name: string;
-        symbol: string;
-        tokenURI: string;
-        yearlyMintRate?: bigint;
-    } | {
-        type: 'doppler404';
-        name: string;
-        symbol: string;
-        baseURI: string;
-        unit?: bigint;
-    }): this;
-    saleConfig(params: {
-        initialSupply: bigint;
-        numTokensToSell: bigint;
-        numeraire: Address;
-    }): this;
-    poolConfig(params: {
-        fee: number;
-        tickSpacing: number;
-        curves: {
-            tickLower: number;
-            tickUpper: number;
-            numPositions: number;
-            shares: bigint;
-        }[];
-        beneficiaries?: {
-            beneficiary: Address;
-            shares: bigint;
-        }[];
-    }): this;
-    withMarketCapPresets(params?: {
-        fee?: number;
-        tickSpacing?: number;
-        presets?: MulticurveMarketCapPreset[];
-        overrides?: MarketCapPresetOverrides;
-        beneficiaries?: {
-            beneficiary: Address;
-            shares: bigint;
-        }[];
-    }): this;
-    /**
-     * Configure multicurve using market cap ranges (no tick math required).
-     *
-     * This is the recommended way to configure multicurve pools. Simply specify
-     * market cap ranges in USD for each curve.
-     *
-     * Curves can be provided in any order - they will be automatically sorted
-     * by market cap (ascending) before validation and processing. Curves must
-     * be contiguous or overlapping (no gaps allowed).
-     *
-     * V4 pools support custom fees (0-100,000). Standard fee tiers auto-derive
-     * tickSpacing; custom fees require explicit tickSpacing parameter.
-     *
-     * @param params - Market cap configuration with curves defined by market cap ranges
-     * @returns Builder instance for chaining
-     *
-     * @example Standard fee tier
-     * ```ts
-     * builder
-     *   .saleConfig({ initialSupply, numTokensToSell, numeraire: WETH })
-     *   .withCurves({
-     *     numerairePrice: 3000,
-     *     curves: [...],
-     *     fee: 500, // Standard tier, tickSpacing auto-derived
-     *   })
-     * ```
-     *
-     * @example Custom fee
-     * ```ts
-     * builder
-     *   .saleConfig({ initialSupply, numTokensToSell, numeraire: WETH })
-     *   .withCurves({
-     *     numerairePrice: 3000,
-     *     curves: [...],
-     *     fee: 2500,      // Custom 0.25% fee
-     *     tickSpacing: 10, // Required for custom fees
-     *   })
-     * ```
-     */
-    withCurves(params: MulticurveMarketCapCurvesConfig): this;
-    /**
-     * Sort curves by market cap (start, then end) for deterministic ordering
-     */
-    private sortCurvesByMarketCap;
-    private validateCurveRange;
-    private validateCurveContiguity;
-    /**
-     * Configure a RehypeDopplerHook for the pool.
-     *
-     * When configured, the hook will be initialized with the pool and will handle:
-     * - Custom swap fees
-     * - Fee distribution to beneficiaries, LPs, and buyback destinations
-     *
-     * IMPORTANT:
-     * - The hook address must be whitelisted in the DopplerHookInitializer
-     * - Fee distribution percentages must sum to exactly WAD (1e18 = 100%)
-     *
-     * @example
-     * ```typescript
-     * builder.withRehypeDopplerHook({
-     *   hookAddress: '0x...',
-     *   buybackDestination: '0x...',
-     *   startFee: 3000, // 0.3%
-     *   endFee: 3000,
-     *   durationSeconds: 0,
-     *   feeDistributionInfo: {
-     *     assetFeesToAssetBuybackWad: parseEther('0.2'),
-     *     assetFeesToNumeraireBuybackWad: parseEther('0.2'),
-     *     assetFeesToBeneficiaryWad: parseEther('0.3'),
-     *     assetFeesToLpWad: parseEther('0.3'),
-     *     numeraireFeesToAssetBuybackWad: parseEther('0.2'),
-     *     numeraireFeesToNumeraireBuybackWad: parseEther('0.2'),
-     *     numeraireFeesToBeneficiaryWad: parseEther('0.3'),
-     *     numeraireFeesToLpWad: parseEther('0.3'),
-     *   },
-     * })
-     * ```
-     */
-    withRehypeDopplerHook(params: RehypeDopplerHookConfig): this;
-    private parseUint32Value;
-    private normalizeRehypeFeeRoutingMode;
-    private resolveRehypeFeeDistributionInfo;
-    private validateRehypeDistribution;
-    private resolveRehypeFeeSchedule;
-    withVesting(params?: {
-        duration?: bigint;
-        cliffDuration?: number;
-        recipients?: Address[];
-        amounts?: bigint[];
-    }): this;
-    private parseStartTimeSeconds;
-    private assertCanSetInitializer;
-    /**
-     * Configure decay multicurve initializer settings.
-     *
-     * The pool's terminal fee is always taken from `poolConfig().fee`.
-     * `startFee` must be greater than or equal to that terminal fee.
-     * `startTime` is optional and defaults to `0` when omitted.
-     */
-    withDecay(params?: {
-        startTime?: number | bigint | Date;
-        startFee: number;
-        durationSeconds: number | bigint;
-    }): this;
-    withSchedule(params?: {
-        startTime: number | bigint | Date;
-    }): this;
-    withGovernance(params: GovernanceOption<C>): this;
-    withMigration(migration: MigrationConfig): this;
-    withUserAddress(address: Address): this;
-    withIntegrator(address?: Address): this;
-    withGasLimit(gas?: bigint): this;
-    private overrideModule;
-    withTokenFactory(address: Address): this;
-    withAirlock(address: Address): this;
-    withV4MulticurveInitializer(address: Address): this;
-    withV4ScheduledMulticurveInitializer(address: Address): this;
-    withV4DecayMulticurveInitializer(address: Address): this;
-    withGovernanceFactory(address: Address): this;
-    withV2Migrator(address: Address): this;
-    withV4Migrator(address: Address): this;
-    withNoOpMigrator(address: Address): this;
-    withDopplerHookInitializer(address: Address): this;
-    build(): CreateMulticurveParams<C>;
-}
-
-export { MulticurveBuilder };

package/dist/builders/MulticurveBuilder.d.ts

@@ -1,196 +0,0 @@
-import { Address } from 'viem';
-import { MulticurveMarketCapPreset, MulticurveMarketCapCurvesConfig, RehypeDopplerHookConfig, GovernanceOption, MigrationConfig, CreateMulticurveParams } from '../types.js';
-import { SupportedChainId } from '../addresses.js';
-import { BaseAuctionBuilder, MarketCapPresetOverrides } from './shared.js';
-import 'viem/chains';
-
-declare class MulticurveBuilder<C extends SupportedChainId> implements BaseAuctionBuilder<C> {
-    private token?;
-    private sale?;
-    private pool?;
-    private initializer?;
-    private schedule?;
-    private dopplerHook?;
-    private vesting?;
-    private governance?;
-    private migration?;
-    private integrator?;
-    private userAddress?;
-    private moduleAddresses?;
-    private gasLimit?;
-    private numerairePrice?;
-    private tokenDecimals?;
-    private numeraireDecimals?;
-    private curvesConfig?;
-    chainId: C;
-    constructor(chainId: C);
-    static forChain<C extends SupportedChainId>(chainId: C): MulticurveBuilder<C>;
-    tokenConfig(params: {
-        type?: 'standard';
-        name: string;
-        symbol: string;
-        tokenURI: string;
-        yearlyMintRate?: bigint;
-    } | {
-        type: 'doppler404';
-        name: string;
-        symbol: string;
-        baseURI: string;
-        unit?: bigint;
-    }): this;
-    saleConfig(params: {
-        initialSupply: bigint;
-        numTokensToSell: bigint;
-        numeraire: Address;
-    }): this;
-    poolConfig(params: {
-        fee: number;
-        tickSpacing: number;
-        curves: {
-            tickLower: number;
-            tickUpper: number;
-            numPositions: number;
-            shares: bigint;
-        }[];
-        beneficiaries?: {
-            beneficiary: Address;
-            shares: bigint;
-        }[];
-    }): this;
-    withMarketCapPresets(params?: {
-        fee?: number;
-        tickSpacing?: number;
-        presets?: MulticurveMarketCapPreset[];
-        overrides?: MarketCapPresetOverrides;
-        beneficiaries?: {
-            beneficiary: Address;
-            shares: bigint;
-        }[];
-    }): this;
-    /**
-     * Configure multicurve using market cap ranges (no tick math required).
-     *
-     * This is the recommended way to configure multicurve pools. Simply specify
-     * market cap ranges in USD for each curve.
-     *
-     * Curves can be provided in any order - they will be automatically sorted
-     * by market cap (ascending) before validation and processing. Curves must
-     * be contiguous or overlapping (no gaps allowed).
-     *
-     * V4 pools support custom fees (0-100,000). Standard fee tiers auto-derive
-     * tickSpacing; custom fees require explicit tickSpacing parameter.
-     *
-     * @param params - Market cap configuration with curves defined by market cap ranges
-     * @returns Builder instance for chaining
-     *
-     * @example Standard fee tier
-     * ```ts
-     * builder
-     *   .saleConfig({ initialSupply, numTokensToSell, numeraire: WETH })
-     *   .withCurves({
-     *     numerairePrice: 3000,
-     *     curves: [...],
-     *     fee: 500, // Standard tier, tickSpacing auto-derived
-     *   })
-     * ```
-     *
-     * @example Custom fee
-     * ```ts
-     * builder
-     *   .saleConfig({ initialSupply, numTokensToSell, numeraire: WETH })
-     *   .withCurves({
-     *     numerairePrice: 3000,
-     *     curves: [...],
-     *     fee: 2500,      // Custom 0.25% fee
-     *     tickSpacing: 10, // Required for custom fees
-     *   })
-     * ```
-     */
-    withCurves(params: MulticurveMarketCapCurvesConfig): this;
-    /**
-     * Sort curves by market cap (start, then end) for deterministic ordering
-     */
-    private sortCurvesByMarketCap;
-    private validateCurveRange;
-    private validateCurveContiguity;
-    /**
-     * Configure a RehypeDopplerHook for the pool.
-     *
-     * When configured, the hook will be initialized with the pool and will handle:
-     * - Custom swap fees
-     * - Fee distribution to beneficiaries, LPs, and buyback destinations
-     *
-     * IMPORTANT:
-     * - The hook address must be whitelisted in the DopplerHookInitializer
-     * - Fee distribution percentages must sum to exactly WAD (1e18 = 100%)
-     *
-     * @example
-     * ```typescript
-     * builder.withRehypeDopplerHook({
-     *   hookAddress: '0x...',
-     *   buybackDestination: '0x...',
-     *   startFee: 3000, // 0.3%
-     *   endFee: 3000,
-     *   durationSeconds: 0,
-     *   feeDistributionInfo: {
-     *     assetFeesToAssetBuybackWad: parseEther('0.2'),
-     *     assetFeesToNumeraireBuybackWad: parseEther('0.2'),
-     *     assetFeesToBeneficiaryWad: parseEther('0.3'),
-     *     assetFeesToLpWad: parseEther('0.3'),
-     *     numeraireFeesToAssetBuybackWad: parseEther('0.2'),
-     *     numeraireFeesToNumeraireBuybackWad: parseEther('0.2'),
-     *     numeraireFeesToBeneficiaryWad: parseEther('0.3'),
-     *     numeraireFeesToLpWad: parseEther('0.3'),
-     *   },
-     * })
-     * ```
-     */
-    withRehypeDopplerHook(params: RehypeDopplerHookConfig): this;
-    private parseUint32Value;
-    private normalizeRehypeFeeRoutingMode;
-    private resolveRehypeFeeDistributionInfo;
-    private validateRehypeDistribution;
-    private resolveRehypeFeeSchedule;
-    withVesting(params?: {
-        duration?: bigint;
-        cliffDuration?: number;
-        recipients?: Address[];
-        amounts?: bigint[];
-    }): this;
-    private parseStartTimeSeconds;
-    private assertCanSetInitializer;
-    /**
-     * Configure decay multicurve initializer settings.
-     *
-     * The pool's terminal fee is always taken from `poolConfig().fee`.
-     * `startFee` must be greater than or equal to that terminal fee.
-     * `startTime` is optional and defaults to `0` when omitted.
-     */
-    withDecay(params?: {
-        startTime?: number | bigint | Date;
-        startFee: number;
-        durationSeconds: number | bigint;
-    }): this;
-    withSchedule(params?: {
-        startTime: number | bigint | Date;
-    }): this;
-    withGovernance(params: GovernanceOption<C>): this;
-    withMigration(migration: MigrationConfig): this;
-    withUserAddress(address: Address): this;
-    withIntegrator(address?: Address): this;
-    withGasLimit(gas?: bigint): this;
-    private overrideModule;
-    withTokenFactory(address: Address): this;
-    withAirlock(address: Address): this;
-    withV4MulticurveInitializer(address: Address): this;
-    withV4ScheduledMulticurveInitializer(address: Address): this;
-    withV4DecayMulticurveInitializer(address: Address): this;
-    withGovernanceFactory(address: Address): this;
-    withV2Migrator(address: Address): this;
-    withV4Migrator(address: Address): this;
-    withNoOpMigrator(address: Address): this;
-    withDopplerHookInitializer(address: Address): this;
-    build(): CreateMulticurveParams<C>;
-}
-
-export { MulticurveBuilder };

package/dist/builders/MulticurveBuilder.js

@@ -1,35 +0,0 @@
-'use strict';
-
-var chunk2A3B3NVB_js = require('../chunk-2A3B3NVB.js');
-require('../chunk-HJFVRV47.js');
-require('../chunk-DSYPZETD.js');
-require('../chunk-WNUB3UTT.js');
-require('../chunk-UPVKABAV.js');
-require('../chunk-QOYI7WCH.js');
-require('../chunk-FNUBKONK.js');
-require('../chunk-6H6X3VTZ.js');
-require('../chunk-7M57PU6V.js');
-require('../chunk-KHUE77HC.js');
-require('../chunk-4VWQNNNW.js');
-require('../chunk-BQZTELUX.js');
-require('../chunk-XSJTASPK.js');
-require('../chunk-6BQY5EPB.js');
-require('../chunk-65CESA3J.js');
-require('../chunk-7A4DBBXA.js');
-require('../chunk-PGYTMRP3.js');
-require('../chunk-MU56HCUI.js');
-require('../chunk-4XN6DQBW.js');
-require('../chunk-QRTABC4Z.js');
-require('../chunk-J62YDWIK.js');
-require('../chunk-XMFOZYNI.js');
-require('../chunk-QAPQGDWK.js');
-require('../chunk-5TQOT6CW.js');
-
-
-
-Object.defineProperty(exports, "MulticurveBuilder", {
-  enumerable: true,
-  get: function () { return chunk2A3B3NVB_js.MulticurveBuilder; }
-});
-//# sourceMappingURL=MulticurveBuilder.js.map
-//# sourceMappingURL=MulticurveBuilder.js.map

package/dist/builders/MulticurveBuilder.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"MulticurveBuilder.js"}

package/dist/builders/MulticurveBuilder.mjs

@@ -1,26 +0,0 @@
-export { MulticurveBuilder } from '../chunk-QUBD6HUZ.mjs';
-import '../chunk-ZEDJUNC6.mjs';
-import '../chunk-7ZUV6WPX.mjs';
-import '../chunk-YBK6EBA5.mjs';
-import '../chunk-H3B54PFV.mjs';
-import '../chunk-IUZ3BBQP.mjs';
-import '../chunk-GSBQIVME.mjs';
-import '../chunk-ABT6AT7C.mjs';
-import '../chunk-CFAAYL5M.mjs';
-import '../chunk-CWTGQAOG.mjs';
-import '../chunk-25GEBO3B.mjs';
-import '../chunk-5GQJRNFL.mjs';
-import '../chunk-KOAC3BBP.mjs';
-import '../chunk-IWJOPXYN.mjs';
-import '../chunk-WKWP42TD.mjs';
-import '../chunk-WDC53TM7.mjs';
-import '../chunk-VKSD3KXF.mjs';
-import '../chunk-JLUOFAE4.mjs';
-import '../chunk-DOUF6NON.mjs';
-import '../chunk-VYSOAGRU.mjs';
-import '../chunk-U3GOWK6J.mjs';
-import '../chunk-SWWLOD7Q.mjs';
-import '../chunk-OHA5KJ2M.mjs';
-import '../chunk-3NMGCQJ4.mjs';
-//# sourceMappingURL=MulticurveBuilder.mjs.map
-//# sourceMappingURL=MulticurveBuilder.mjs.map

package/dist/builders/MulticurveBuilder.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"MulticurveBuilder.mjs"}

package/dist/builders/StaticAuctionBuilder.d.mts

@@ -1,131 +0,0 @@
-import { Address } from 'viem';
-import { PriceRange, StaticAuctionMarketCapConfig, GovernanceOption, MigrationConfig, CreateStaticAuctionParams } from '../types.mjs';
-import { SupportedChainId } from '../addresses.mjs';
-import { BaseAuctionBuilder } from './shared.mjs';
-import 'viem/chains';
-
-declare class StaticAuctionBuilder<C extends SupportedChainId> implements BaseAuctionBuilder<C> {
-    private token?;
-    private sale?;
-    private pool?;
-    private beneficiaries?;
-    private vesting?;
-    private governance?;
-    private migration?;
-    private integrator?;
-    private userAddress?;
-    private moduleAddresses?;
-    private gasLimit?;
-    private marketCapConfig?;
-    chainId: C;
-    constructor(chainId: C);
-    static forChain<C extends SupportedChainId>(chainId: C): StaticAuctionBuilder<C>;
-    tokenConfig(params: {
-        type?: 'standard';
-        name: string;
-        symbol: string;
-        tokenURI: string;
-        yearlyMintRate?: bigint;
-    } | {
-        type: 'doppler404';
-        name: string;
-        symbol: string;
-        baseURI: string;
-        unit?: bigint;
-    }): this;
-    saleConfig(params: {
-        initialSupply: bigint;
-        numTokensToSell: bigint;
-        numeraire: Address;
-    }): this;
-    /**
-     * Provide pool ticks directly.
-     *
-     * Note: Static Auctions use Uniswap V3, which only supports 4 fee tiers:
-     * 100 (0.01%), 500 (0.05%), 3000 (0.3%), 10000 (1%).
-     * For custom fees, use Dynamic or Multicurve auctions (V4).
-     */
-    poolByTicks(params: {
-        startTick?: number;
-        endTick?: number;
-        fee?: number;
-        numPositions?: number;
-        maxShareToBeSold?: bigint;
-    }): this;
-    /**
-     * @deprecated Use withMarketCapRange() instead for more intuitive market cap configuration
-     */
-    poolByPriceRange(params: {
-        priceRange: PriceRange;
-        fee?: number;
-        numPositions?: number;
-        maxShareToBeSold?: bigint;
-    }): this;
-    /**
-     * Configure pool using target market cap range.
-     * Converts market cap values (in USD) to Uniswap ticks.
-     *
-     * @param params - Market cap configuration
-     * @returns Builder instance for chaining
-     *
-     * @example
-     * ```ts
-     * builder
-     *   .saleConfig({ initialSupply, numTokensToSell, numeraire: WETH })
-     *   .withMarketCapRange({
-     *     marketCap: { start: 100_000, end: 10_000_000 }, // $100k to $10M
-     *     numerairePrice: 3000, // ETH = $3000
-     *   })
-     * ```
-     */
-    withMarketCapRange(params: StaticAuctionMarketCapConfig): this;
-    /**
-     * Configure beneficiaries for fee streaming on locked V3 pools.
-     *
-     * When beneficiaries are provided, the pool enters a "Locked" state where:
-     * - Fees are collected and distributed to beneficiaries according to their shares
-     * - Liquidity cannot be exited/migrated (pool stays locked permanently)
-     * - Anyone can call collectFees() to distribute accumulated fees
-     *
-     * IMPORTANT:
-     * - Shares must sum to exactly WAD (1e18 = 100%)
-     * - Protocol owner (Airlock.owner()) must be included with at least 5% shares
-     * - Beneficiaries will be automatically sorted by address (ascending)
-     * - Use withMigration({ type: 'noOp' }) when using beneficiaries
-     *
-     * @example
-     * ```typescript
-     * builder.withBeneficiaries([
-     *   { beneficiary: protocolOwner, shares: parseEther('0.05') },  // 5% (minimum required)
-     *   { beneficiary: teamWallet, shares: parseEther('0.45') },     // 45%
-     *   { beneficiary: daoTreasury, shares: parseEther('0.50') },    // 50%
-     * ])
-     * ```
-     */
-    withBeneficiaries(beneficiaries: {
-        beneficiary: Address;
-        shares: bigint;
-    }[]): this;
-    withVesting(params?: {
-        duration?: bigint;
-        cliffDuration?: number;
-        recipients?: Address[];
-        amounts?: bigint[];
-    }): this;
-    withGovernance(params: GovernanceOption<C>): this;
-    withMigration(migration: MigrationConfig): this;
-    withUserAddress(address: Address): this;
-    withIntegrator(address?: Address): this;
-    withGasLimit(gas?: bigint): this;
-    private overrideModule;
-    withTokenFactory(address: Address): this;
-    withAirlock(address: Address): this;
-    withV3Initializer(address: Address): this;
-    withGovernanceFactory(address: Address): this;
-    withV2Migrator(address: Address): this;
-    withV4Migrator(address: Address): this;
-    withNoOpMigrator(address: Address): this;
-    build(): CreateStaticAuctionParams<C>;
-}
-
-export { StaticAuctionBuilder };