@whetstone-research/doppler-sdk 0.0.1-alpha.8 → 0.0.1

package/dist/chunk-NZ4BJ2IC.mjs

@@ -0,0 +1,315 @@
+import { derc20Abi } from './chunk-OTG75GVH.mjs';
+
+// src/entities/token/derc20/Derc20.ts
+var Derc20 = class _Derc20 {
+  get rpc() {
+    return this.publicClient;
+  }
+  static splitSignature(signature) {
+    const sig = signature.toLowerCase();
+    const r = `0x${sig.slice(2, 66)}`;
+    const s = `0x${sig.slice(66, 130)}`;
+    let v = parseInt(sig.slice(130, 132), 16);
+    if (v < 27) v += 27;
+    return { v, r, s };
+  }
+  constructor(publicClient, walletClient, address) {
+    this.publicClient = publicClient;
+    this.walletClient = walletClient;
+    this.address = address;
+  }
+  /** Get the human-readable name of the token */
+  async getName() {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "name"
+    });
+  }
+  /** Get the symbol/ticker of the token */
+  async getSymbol() {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "symbol"
+    });
+  }
+  /** Get the number of decimals used for token divisions */
+  async getDecimals() {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "decimals"
+    });
+  }
+  /** Get the token URI for the token */
+  async getTokenURI() {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "tokenURI"
+    });
+  }
+  // -------------------------
+  // Governance (Votes) reads
+  // -------------------------
+  /** Get the current delegate for an account */
+  async getDelegates(account) {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "delegates",
+      args: [account]
+    });
+  }
+  /** Get current voting power for an account */
+  async getVotes(account) {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "getVotes",
+      args: [account]
+    });
+  }
+  /** Get historical voting power at a given timepoint (block) */
+  async getPastVotes(account, timepoint) {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "getPastVotes",
+      args: [account, timepoint]
+    });
+  }
+  /**
+   * Get the allowance granted by an owner to a spender
+   * @param owner - The address that granted the allowance
+   * @param spender - The address that can spend the tokens
+   */
+  async getAllowance(owner, spender) {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "allowance",
+      args: [owner, spender]
+    });
+  }
+  /**
+   * Get the token balance of a specific account
+   * @param account - Address to check balance for
+   */
+  async getBalanceOf(account) {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "balanceOf",
+      args: [account]
+    });
+  }
+  /** Get the total supply of tokens in circulation */
+  async getTotalSupply() {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "totalSupply"
+    });
+  }
+  /** Get the duration (in seconds) of the vesting period */
+  async getVestingDuration() {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "vestingDuration"
+    });
+  }
+  /** Get the timestamp when vesting begins */
+  async getVestingStart() {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "vestingStart"
+    });
+  }
+  /** Get the total amount of tokens allocated for vesting */
+  async getVestedTotalAmount() {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "vestedTotalAmount"
+    });
+  }
+  /** Get the amount of vested tokens available for a specific address */
+  async getAvailableVestedAmount(account) {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "computeAvailableVestedAmount",
+      args: [account]
+    });
+  }
+  /** Get the current annual mint rate in tokens per year */
+  async getYearlyMintRate() {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "yearlyMintRate"
+    });
+  }
+  /** Get the pool address for the token */
+  async getPool() {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "pool"
+    });
+  }
+  /** Check if the liquidity pool is unlocked */
+  async getIsPoolUnlocked() {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "isPoolUnlocked"
+    });
+  }
+  /** Get the timestamp when token minting begins */
+  async getCurrentYearStart() {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "currentYearStart"
+    });
+  }
+  /** Get the timestamp of the last mint */
+  async getLastMintTimestamp() {
+    return await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "lastMintTimestamp"
+    });
+  }
+  /**
+   * Get detailed vesting information for a specific account
+   * @param account - Address to retrieve vesting data for
+   * @returns Object containing totalAmount and releasedAmount
+   */
+  async getVestingData(account) {
+    const result = await this.rpc.readContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "getVestingDataOf",
+      args: [account]
+    });
+    return {
+      totalAmount: result[0],
+      releasedAmount: result[1]
+    };
+  }
+  // Write methods (require wallet client)
+  /**
+   * Approve a spender to transfer tokens on behalf of the owner
+   * @param spender - Address that will be able to spend the tokens
+   * @param value - Amount of tokens to approve
+   * @returns Transaction hash
+   */
+  async approve(spender, value, options) {
+    if (!this.walletClient) {
+      throw new Error("Wallet client required for write operations");
+    }
+    const { request } = await this.rpc.simulateContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "approve",
+      args: [spender, value],
+      account: this.walletClient.account
+    });
+    return await this.walletClient.writeContract(options?.gas ? { ...request, gas: options.gas } : request);
+  }
+  /**
+   * Delegate governance votes to an address
+   */
+  async delegate(delegatee, options) {
+    if (!this.walletClient) {
+      throw new Error("Wallet client required for write operations");
+    }
+    const { request } = await this.rpc.simulateContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "delegate",
+      args: [delegatee],
+      account: this.walletClient.account
+    });
+    return await this.walletClient.writeContract(options?.gas ? { ...request, gas: options.gas } : request);
+  }
+  /**
+   * Delegate governance votes using an EIP-712 signature (gasless path)
+   * Note: Caller signs typed data; a relayer or the caller submits the tx.
+   */
+  async delegateBySig(delegatee, expiry, options) {
+    if (!this.walletClient) {
+      throw new Error("Wallet client required for write operations");
+    }
+    const acct = this.walletClient.account;
+    let accountAddress;
+    if (typeof acct === "string") {
+      accountAddress = acct;
+    } else if (acct && typeof acct === "object" && "address" in acct) {
+      accountAddress = acct.address;
+    } else {
+      throw new Error("Invalid wallet account");
+    }
+    const [nonce, name] = await Promise.all([
+      this.rpc.readContract({ address: this.address, abi: derc20Abi, functionName: "nonces", args: [accountAddress] }),
+      this.getName()
+    ]);
+    const chainId = this.rpc.chain?.id ?? await this.rpc.getChainId();
+    const domain = {
+      name,
+      version: "1",
+      chainId,
+      verifyingContract: this.address
+    };
+    const types = {
+      Delegation: [
+        { name: "delegatee", type: "address" },
+        { name: "nonce", type: "uint256" },
+        { name: "expiry", type: "uint256" }
+      ]
+    };
+    const message = { delegatee, nonce, expiry };
+    const signature = await this.walletClient.signTypedData({
+      domain,
+      types,
+      primaryType: "Delegation",
+      message,
+      account: accountAddress
+    });
+    const { v, r, s } = _Derc20.splitSignature(signature);
+    const { request } = await this.rpc.simulateContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "delegateBySig",
+      args: [delegatee, nonce, expiry, v, r, s],
+      account: this.walletClient.account
+    });
+    return await this.walletClient.writeContract(options?.gas ? { ...request, gas: options.gas } : request);
+  }
+  /**
+   * Release all currently available vested tokens to the caller
+   */
+  async release(options) {
+    if (!this.walletClient) {
+      throw new Error("Wallet client required for write operations");
+    }
+    const { request } = await this.rpc.simulateContract({
+      address: this.address,
+      abi: derc20Abi,
+      functionName: "release",
+      args: [],
+      account: this.walletClient.account
+    });
+    return await this.walletClient.writeContract(options?.gas ? { ...request, gas: options.gas } : request);
+  }
+};
+
+export { Derc20 };
+//# sourceMappingURL=chunk-NZ4BJ2IC.mjs.map
+//# sourceMappingURL=chunk-NZ4BJ2IC.mjs.map

package/dist/chunk-NZ4BJ2IC.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/entities/token/derc20/Derc20.ts"],"names":[],"mappings":"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","file":"chunk-NZ4BJ2IC.mjs","sourcesContent":["import { type Address, type WalletClient, type PublicClient } from 'viem'\nimport { derc20Abi } from '../../../abis'\nimport { SupportedPublicClient } from '@/types'\n\n/**\n * A class providing read and write access to a DERC20 token contract.\n * Enables querying standard ERC20 token properties along with custom vesting\n * and minting-related state information.\n */\nexport class Derc20 {\n  private publicClient: SupportedPublicClient\n  private walletClient?: WalletClient\n  private address: Address\n  private get rpc(): PublicClient {\n    return this.publicClient as PublicClient\n  }\n  \n  private static splitSignature(signature: `0x${string}`): { v: number; r: `0x${string}`; s: `0x${string}` } {\n    const sig = signature.toLowerCase() as `0x${string}`\n    const r = (`0x${sig.slice(2, 66)}`) as `0x${string}`\n    const s = (`0x${sig.slice(66, 130)}`) as `0x${string}`\n    let v = parseInt(sig.slice(130, 132), 16)\n    if (v < 27) v += 27\n    return { v, r, s }\n  }\n  \n  constructor(publicClient: SupportedPublicClient, walletClient: WalletClient | undefined, address: Address) {\n    this.publicClient = publicClient\n    this.walletClient = walletClient\n    this.address = address\n  }\n  \n  /** Get the human-readable name of the token */\n  async getName(): Promise<string> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'name',\n    })\n  }\n  \n  /** Get the symbol/ticker of the token */\n  async getSymbol(): Promise<string> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'symbol',\n    })\n  }\n  \n  /** Get the number of decimals used for token divisions */\n  async getDecimals(): Promise<number> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'decimals',\n    })\n  }\n  \n  /** Get the token URI for the token */\n  async getTokenURI(): Promise<string> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'tokenURI',\n    })\n  }\n  \n  // -------------------------\n  // Governance (Votes) reads\n  // -------------------------\n  \n  /** Get the current delegate for an account */\n  async getDelegates(account: Address): Promise<Address> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'delegates',\n      args: [account],\n    })\n  }\n  \n  /** Get current voting power for an account */\n  async getVotes(account: Address): Promise<bigint> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'getVotes',\n      args: [account],\n    })\n  }\n  \n  /** Get historical voting power at a given timepoint (block) */\n  async getPastVotes(account: Address, timepoint: bigint): Promise<bigint> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'getPastVotes',\n      args: [account, timepoint],\n    })\n  }\n  \n  /**\n   * Get the allowance granted by an owner to a spender\n   * @param owner - The address that granted the allowance\n   * @param spender - The address that can spend the tokens\n   */\n  async getAllowance(owner: Address, spender: Address): Promise<bigint> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'allowance',\n      args: [owner, spender],\n    })\n  }\n  \n  /**\n   * Get the token balance of a specific account\n   * @param account - Address to check balance for\n   */\n  async getBalanceOf(account: Address): Promise<bigint> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'balanceOf',\n      args: [account],\n    })\n  }\n  \n  /** Get the total supply of tokens in circulation */\n  async getTotalSupply(): Promise<bigint> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'totalSupply',\n    })\n  }\n  \n  /** Get the duration (in seconds) of the vesting period */\n  async getVestingDuration(): Promise<bigint> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'vestingDuration',\n    })\n  }\n  \n  /** Get the timestamp when vesting begins */\n  async getVestingStart(): Promise<bigint> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'vestingStart',\n    })\n  }\n  \n  /** Get the total amount of tokens allocated for vesting */\n  async getVestedTotalAmount(): Promise<bigint> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'vestedTotalAmount',\n    })\n  }\n  \n  /** Get the amount of vested tokens available for a specific address */\n  async getAvailableVestedAmount(account: Address): Promise<bigint> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'computeAvailableVestedAmount',\n      args: [account],\n    })\n  }\n  \n  /** Get the current annual mint rate in tokens per year */\n  async getYearlyMintRate(): Promise<bigint> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'yearlyMintRate',\n    })\n  }\n  \n  /** Get the pool address for the token */\n  async getPool(): Promise<Address> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'pool',\n    })\n  }\n  \n  /** Check if the liquidity pool is unlocked */\n  async getIsPoolUnlocked(): Promise<boolean> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'isPoolUnlocked',\n    })\n  }\n  \n  /** Get the timestamp when token minting begins */\n  async getCurrentYearStart(): Promise<bigint> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'currentYearStart',\n    })\n  }\n  \n  /** Get the timestamp of the last mint */\n  async getLastMintTimestamp(): Promise<bigint> {\n    return await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'lastMintTimestamp',\n    })\n  }\n  \n  /**\n   * Get detailed vesting information for a specific account\n   * @param account - Address to retrieve vesting data for\n   * @returns Object containing totalAmount and releasedAmount\n   */\n  async getVestingData(account: Address): Promise<{\n    totalAmount: bigint\n    releasedAmount: bigint\n  }> {\n    const result = await this.rpc.readContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'getVestingDataOf',\n      args: [account],\n    })\n    \n    return {\n      totalAmount: result[0],\n      releasedAmount: result[1],\n    }\n  }\n  \n  // Write methods (require wallet client)\n  \n  /**\n   * Approve a spender to transfer tokens on behalf of the owner\n   * @param spender - Address that will be able to spend the tokens\n   * @param value - Amount of tokens to approve\n   * @returns Transaction hash\n   */\n  async approve(spender: Address, value: bigint, options?: { gas?: bigint }): Promise<`0x${string}`> {\n    if (!this.walletClient) {\n      throw new Error('Wallet client required for write operations')\n    }\n    \n    const { request } = await this.rpc.simulateContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'approve',\n      args: [spender, value],\n      account: this.walletClient.account,\n    })\n    \n    return await this.walletClient.writeContract(options?.gas ? { ...request, gas: options.gas } : request)\n  }\n  \n  /**\n   * Delegate governance votes to an address\n   */\n  async delegate(delegatee: Address, options?: { gas?: bigint }): Promise<`0x${string}`> {\n    if (!this.walletClient) {\n      throw new Error('Wallet client required for write operations')\n    }\n    \n    const { request } = await this.rpc.simulateContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'delegate',\n      args: [delegatee],\n      account: this.walletClient.account,\n    })\n    \n    return await this.walletClient.writeContract(options?.gas ? { ...request, gas: options.gas } : request)\n  }\n  \n  /**\n   * Delegate governance votes using an EIP-712 signature (gasless path)\n   * Note: Caller signs typed data; a relayer or the caller submits the tx.\n   */\n  async delegateBySig(\n    delegatee: Address,\n    expiry: bigint,\n    options?: { gas?: bigint }\n  ): Promise<`0x${string}`> {\n    if (!this.walletClient) {\n      throw new Error('Wallet client required for write operations')\n    }\n\n    const acct = this.walletClient.account as unknown\n    let accountAddress: Address\n    if (typeof acct === 'string') {\n      accountAddress = acct as Address\n    } else if (acct && typeof acct === 'object' && 'address' in acct) {\n      accountAddress = (acct as { address: Address }).address\n    } else {\n      throw new Error('Invalid wallet account')\n    }\n    const [nonce, name] = await Promise.all([\n      this.rpc.readContract({ address: this.address, abi: derc20Abi, functionName: 'nonces', args: [accountAddress] }),\n      this.getName(),\n    ])\n    const chainId = (this.rpc.chain?.id as number | undefined) ?? (await this.rpc.getChainId())\n\n    const domain = {\n      name,\n      version: '1',\n      chainId,\n      verifyingContract: this.address,\n    } as const\n\n    const types = {\n      Delegation: [\n        { name: 'delegatee', type: 'address' },\n        { name: 'nonce', type: 'uint256' },\n        { name: 'expiry', type: 'uint256' },\n      ],\n    } as const\n\n    const message = { delegatee, nonce, expiry } as const\n\n    const signature = await this.walletClient.signTypedData({\n      domain,\n      types,\n      primaryType: 'Delegation',\n      message,\n      account: accountAddress,\n    })\n\n    const { v, r, s } = Derc20.splitSignature(signature)\n\n    const { request } = await this.rpc.simulateContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'delegateBySig',\n      args: [delegatee, nonce, expiry, v, r, s],\n      account: this.walletClient.account,\n    })\n\n    return await this.walletClient.writeContract(options?.gas ? { ...request, gas: options.gas } : request)\n  }\n\n  /**\n   * Release all currently available vested tokens to the caller\n   */\n  async release(options?: { gas?: bigint }): Promise<`0x${string}`> {\n    if (!this.walletClient) {\n      throw new Error('Wallet client required for write operations')\n    }\n\n    const { request } = await this.rpc.simulateContract({\n      address: this.address,\n      abi: derc20Abi,\n      functionName: 'release',\n      args: [],\n      account: this.walletClient.account,\n    })\n\n    return await this.walletClient.writeContract(options?.gas ? { ...request, gas: options.gas } : request)\n  }\n}\n"]}

package/dist/chunk-OKNM7ODQ.js

@@ -0,0 +1,29 @@
+'use strict';
+
+var chunkYYUOLM6U_js = require('./chunk-YYUOLM6U.js');
+
+// src/types.ts
+var NO_OP_ENABLED_CHAIN_IDS = [
+  chunkYYUOLM6U_js.CHAIN_IDS.BASE,
+  chunkYYUOLM6U_js.CHAIN_IDS.BASE_SEPOLIA,
+  chunkYYUOLM6U_js.CHAIN_IDS.UNICHAIN,
+  chunkYYUOLM6U_js.CHAIN_IDS.UNICHAIN_SEPOLIA,
+  chunkYYUOLM6U_js.CHAIN_IDS.MONAD_TESTNET,
+  chunkYYUOLM6U_js.CHAIN_IDS.MONAD_MAINNET
+];
+function isNoOpEnabledChain(chainId) {
+  return NO_OP_ENABLED_CHAIN_IDS.includes(chainId);
+}
+var LockablePoolStatus = /* @__PURE__ */ ((LockablePoolStatus2) => {
+  LockablePoolStatus2[LockablePoolStatus2["Uninitialized"] = 0] = "Uninitialized";
+  LockablePoolStatus2[LockablePoolStatus2["Initialized"] = 1] = "Initialized";
+  LockablePoolStatus2[LockablePoolStatus2["Locked"] = 2] = "Locked";
+  LockablePoolStatus2[LockablePoolStatus2["Exited"] = 3] = "Exited";
+  return LockablePoolStatus2;
+})(LockablePoolStatus || {});
+
+exports.LockablePoolStatus = LockablePoolStatus;
+exports.NO_OP_ENABLED_CHAIN_IDS = NO_OP_ENABLED_CHAIN_IDS;
+exports.isNoOpEnabledChain = isNoOpEnabledChain;
+//# sourceMappingURL=chunk-OKNM7ODQ.js.map
+//# sourceMappingURL=chunk-OKNM7ODQ.js.map

package/dist/chunk-OKNM7ODQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"names":["CHAIN_IDS","LockablePoolStatus"],"mappings":";;;;;AA0EO,IAAM,uBAAA,GAA0B;AAAA,EACrCA,0BAAA,CAAU,IAAA;AAAA,EACVA,0BAAA,CAAU,YAAA;AAAA,EACVA,0BAAA,CAAU,QAAA;AAAA,EACVA,0BAAA,CAAU,gBAAA;AAAA,EACVA,0BAAA,CAAU,aAAA;AAAA,EACVA,0BAAA,CAAU;AACZ;AAOO,SAAS,mBAAmB,OAAA,EAAgD;AACjF,EAAA,OAAQ,uBAAA,CAA8C,SAAS,OAAO,CAAA;AACxE;AAyBO,IAAK,kBAAA,qBAAAC,mBAAAA,KAAL;AACL,EAAAA,mBAAAA,CAAAA,mBAAAA,CAAA,mBAAgB,CAAA,CAAA,GAAhB,eAAA;AACA,EAAAA,mBAAAA,CAAAA,mBAAAA,CAAA,iBAAc,CAAA,CAAA,GAAd,aAAA;AACA,EAAAA,mBAAAA,CAAAA,mBAAAA,CAAA,YAAS,CAAA,CAAA,GAAT,QAAA;AACA,EAAAA,mBAAAA,CAAAA,mBAAAA,CAAA,YAAS,CAAA,CAAA,GAAT,QAAA;AAJU,EAAA,OAAAA,mBAAAA;AAAA,CAAA,EAAA,kBAAA,IAAA,EAAA","file":"chunk-OKNM7ODQ.js","sourcesContent":["import { base, baseSepolia, ink, unichain } from 'viem/chains';\nimport { CHAIN_IDS, type SupportedChainId } from './addresses';\n// Re-export SupportedChainId so consumers can import from this module\nexport { type SupportedChainId } from './addresses';\nimport type { Address, WalletClient } from 'viem';\n\nexport type SupportedChain =\n  | typeof base\n  | typeof baseSepolia\n  | typeof ink\n  | typeof unichain\n  | typeof baseSepolia;\n// Use a wide type to avoid cross-package viem type identity issues when linking packages locally.\nexport type SupportedPublicClient = unknown;\n\n// Core configuration types\n// Token configuration (discriminated union)\nexport interface StandardTokenConfig {\n  type?: 'standard'; // default behavior (backwards compatible)\n  name: string;\n  symbol: string;\n  tokenURI: string;\n  yearlyMintRate?: bigint; // Optional yearly mint rate (in WAD, default: 2% = 0.02e18)\n}\n\nexport interface Doppler404TokenConfig {\n  type: 'doppler404';\n  name: string;\n  symbol: string;\n  baseURI: string;\n  // Optional unit for DN404 factory (uint256). Defaults to 1000 when omitted.\n  unit?: bigint;\n}\n\nexport type TokenConfig = StandardTokenConfig | Doppler404TokenConfig;\n\nexport interface SaleConfig {\n  initialSupply: bigint;\n  numTokensToSell: bigint;\n  numeraire: Address; // e.g., WETH address\n}\n\n// Static Auction Pool configuration\nexport interface StaticPoolConfig {\n  startTick: number;\n  endTick: number;\n  fee: number; // e.g., 3000 for 0.3%\n  // Optional parameters for lockable initializer\n  numPositions?: number; // Number of liquidity positions (default: based on tick range)\n  maxShareToBeSold?: bigint; // Maximum share of tokens to sell (in WAD, default: 1e18 = 100%)\n  beneficiaries?: BeneficiaryData[]; // Optional beneficiaries for fee streaming\n}\n\n// Dynamic Auction configuration\nexport interface DynamicAuctionConfig {\n  duration: number; // in seconds\n  epochLength: number; // in seconds\n  startTick: number;\n  endTick: number;\n  gamma?: number; // Optional, can be auto-calculated\n  minProceeds: bigint;\n  maxProceeds: bigint;\n  numPdSlugs?: number; // Price discovery slugs (optional)\n}\n\n// Vesting configuration\nexport interface VestingConfig {\n  duration: number; // in seconds\n  cliffDuration: number; // in seconds\n  recipients?: Address[]; // Optional array of recipient addresses (defaults to [userAddress] if not specified)\n  amounts?: bigint[]; // Optional array of vesting amounts per recipient (must match recipients length if provided)\n}\n\n// Chains where no-op governance is enabled\nexport const NO_OP_ENABLED_CHAIN_IDS = [\n  CHAIN_IDS.BASE,\n  CHAIN_IDS.BASE_SEPOLIA,\n  CHAIN_IDS.UNICHAIN,\n  CHAIN_IDS.UNICHAIN_SEPOLIA,\n  CHAIN_IDS.MONAD_TESTNET,\n  CHAIN_IDS.MONAD_MAINNET,\n] as const;\n\nexport type NoOpEnabledChainId = (typeof NO_OP_ENABLED_CHAIN_IDS)[number];\n\n/**\n * Check if a chain supports no-op governance\n */\nexport function isNoOpEnabledChain(chainId: number): chainId is NoOpEnabledChainId {\n  return (NO_OP_ENABLED_CHAIN_IDS as readonly number[]).includes(chainId);\n}\n\n// Governance configuration (discriminated union)\nexport type GovernanceDefault = { type: 'default' };\nexport interface GovernanceCustom {\n  type: 'custom';\n  initialVotingDelay: number;\n  initialVotingPeriod: number;\n  initialProposalThreshold: bigint;\n}\nexport type GovernanceNoOp = { type: 'noOp' };\n\nexport type GovernanceOption<C extends SupportedChainId> =\n  | GovernanceDefault\n  | GovernanceCustom\n  | (C extends NoOpEnabledChainId ? GovernanceNoOp : never);\n\n// Unified beneficiary data used for fee streaming, lockable initializers, and migration configs\n// Uses shares in WAD format (1e18 = 100%) for consistency across all beneficiary configurations\nexport interface BeneficiaryData {\n  beneficiary: Address;\n  shares: bigint; // shares in WAD (1e18 = 100%)\n}\n\n// Pool status for lockable initializer\nexport enum LockablePoolStatus {\n  Uninitialized = 0,\n  Initialized = 1,\n  Locked = 2,\n  Exited = 3,\n}\n\n// Lockable pool state\nexport interface LockablePoolState {\n  asset: Address;\n  numeraire: Address;\n  tickLower: number;\n  tickUpper: number;\n  maxShareToBeSold: bigint;\n  totalTokensOnBondingCurve: bigint;\n  status: LockablePoolStatus;\n}\n\n// Multicurve pool state (V4 initializer)\nexport interface MulticurvePoolState {\n  asset: Address;\n  numeraire: Address;\n  fee: number;\n  tickSpacing: number;\n  status: LockablePoolStatus; // Reuses the same enum\n  poolKey: V4PoolKey;\n  farTick: number;\n}\n\n// Migration configuration (discriminated union)\nexport type MigrationConfig =\n  | { type: 'uniswapV2' } // Basic migration to a new Uniswap v2 pool\n  | {\n      type: 'uniswapV3';\n      fee: number;\n      tickSpacing: number;\n    }\n  | {\n      type: 'uniswapV4';\n      fee: number;\n      tickSpacing: number;\n      // Configuration for fee streaming via StreamableFeesLocker (optional)\n      // When omitted, fees are not locked and beneficiaries are not configured\n      // This is useful when using noOp governance where lock duration is not meaningful\n      streamableFees?: {\n        lockDuration: number; // in seconds\n        beneficiaries: BeneficiaryData[]; // Uses shares in WAD (1e18 = 100%)\n      };\n    }\n  | { type: 'noOp' }; // No migration - used with lockable beneficiaries\n\n// Create Static Auction parameters\nexport interface CreateStaticAuctionParams<C extends SupportedChainId = SupportedChainId> {\n  // Token configuration\n  token: TokenConfig;\n\n  // Sale configuration\n  sale: SaleConfig;\n\n  // Static Auction (Uniswap v3) Pool configuration\n  pool: StaticPoolConfig;\n\n  // Vesting configuration (optional)\n  vesting?: VestingConfig;\n\n  // Governance configuration (required). Use `{ type: 'noOp' }` where enabled,\n  // `{ type: 'default' }` for standard defaults, or `{ type: 'custom', ... }` to customize.\n  governance: GovernanceOption<C>;\n\n  // Explicit Migration Configuration\n  migration: MigrationConfig;\n\n  // Integrator details\n  integrator?: Address;\n  userAddress: Address;\n\n  // Optional address overrides for on-chain modules used during encoding/creation\n  modules?: ModuleAddressOverrides;\n\n  // Optional transaction gas limit override for the create() transaction\n  // If omitted, SDK will default to 13,500,000 gas for create()\n  gas?: bigint;\n}\n\n// Create Dynamic Auction parameters\nexport interface CreateDynamicAuctionParams<C extends SupportedChainId = SupportedChainId> {\n  // Token configuration\n  token: TokenConfig;\n\n  // Sale configuration\n  sale: SaleConfig;\n\n  // Dynamic Auction (Uniswap v4 Hook) configuration\n  auction: DynamicAuctionConfig;\n\n  // Pool configuration\n  pool: {\n    fee: number; // e.g., 3000 for 0.3%\n    tickSpacing: number;\n  };\n\n  // Vesting configuration (optional)\n  vesting?: VestingConfig;\n\n  // Governance configuration (required). Use `{ type: 'noOp' }` where enabled,\n  // `{ type: 'default' }` for standard defaults, or `{ type: 'custom', ... }` to customize.\n  governance: GovernanceOption<C>;\n\n  // Explicit Migration Configuration\n  migration: MigrationConfig;\n\n  // Integrator details\n  integrator?: Address;\n  userAddress: Address;\n\n  // Time configuration (internal use)\n  startTimeOffset?: number;\n  blockTimestamp?: number; // Optional: use this block timestamp instead of fetching latest\n\n  // Optional transaction gas limit override for the create() transaction\n  // If omitted, SDK will default to 13,500,000 gas for create()\n  gas?: bigint;\n\n  // Optional address overrides for on-chain modules used during encoding/creation\n  modules?: ModuleAddressOverrides;\n}\n\n// Price range configuration for automatic tick calculation\nexport interface PriceRange {\n  startPrice: number;\n  endPrice: number;\n}\n\n// Tick range configuration\nexport interface TickRange {\n  startTick: number;\n  endTick: number;\n}\n\n// ============================================================================\n// Market Cap Configuration Types\n// ============================================================================\n\n/**\n * Market cap range in USD for price configurations.\n * Used to define start and end market caps for bonding curves.\n */\nexport interface MarketCapRange {\n  /** Starting market cap in USD (e.g., 100_000 for $100k) */\n  start: number;\n  /** Ending market cap in USD (e.g., 10_000_000 for $10M) */\n  end: number;\n}\n\n/**\n * Base configuration for market cap-based tick calculations.\n * Used by builder methods to convert market caps to ticks.\n */\nexport interface MarketCapConfig {\n  /** Target market cap range in USD */\n  marketCap: MarketCapRange;\n  /** Price of numeraire in USD (e.g., 3000 for ETH at $3000) */\n  numerairePrice: number;\n  /** \n   * Token supply override. If not provided, inferred from saleConfig.initialSupply.\n   * Must include decimals (e.g., parseEther('1000000000') for 1B tokens).\n   */\n  tokenSupply?: bigint;\n  /** Token decimals (default: 18) */\n  tokenDecimals?: number;\n  /** Numeraire decimals (default: 18) */\n  numeraireDecimals?: number;\n}\n\n/**\n * Market cap configuration for V3 Static Auctions.\n * Extends base config with V3-specific parameters.\n */\nexport interface StaticAuctionMarketCapConfig extends MarketCapConfig {\n  /** Fee tier in basis points (e.g., 10000 for 1%). Default: 10000 */\n  fee?: number;\n  /** Number of liquidity positions. Default: 15 */\n  numPositions?: number;\n  /** Maximum share of tokens to sell per position (WAD). Default: 35% */\n  maxShareToBeSold?: bigint;\n}\n\n/**\n * Market cap range for V4 Dynamic Auctions (Dutch auctions).\n * Uses start/min because price descends from start to minimum.\n */\nexport interface DynamicMarketCapRange {\n  /** Starting market cap in USD - auction begins here (e.g., 500_000 for $500k) */\n  start: number;\n  /** Minimum market cap in USD - floor price the auction descends to (e.g., 50_000 for $50k) */\n  min: number;\n}\n\n/**\n * Market cap configuration for V4 Dynamic Auctions.\n * Uses start/min (not start/end) because Dutch auctions descend from start to minimum.\n */\nexport interface DynamicAuctionMarketCapConfig {\n  /** Target market cap range (start = launch price, min = floor price) */\n  marketCap: DynamicMarketCapRange;\n  /** Price of numeraire in USD (e.g., 3000 for ETH at $3000) */\n  numerairePrice: number;\n  /** \n   * Token supply override. If not provided, inferred from saleConfig.initialSupply.\n   * Must include decimals (e.g., parseEther('1000000000') for 1B tokens).\n   */\n  tokenSupply?: bigint;\n  /** Token decimals (default: 18) */\n  tokenDecimals?: number;\n  /** Numeraire decimals (default: 18) */\n  numeraireDecimals?: number;\n  /** Minimum proceeds required for successful auction */\n  minProceeds: bigint;\n  /** Maximum proceeds cap for the auction */\n  maxProceeds: bigint;\n  /** Auction duration in seconds. Default: 7 days */\n  duration?: number;\n  /** Epoch length in seconds. Default: 3600 (1 hour) */\n  epochLength?: number;\n  /** Gamma (tick decay per epoch). Auto-calculated if not provided */\n  gamma?: number;\n  /** Number of price discovery slugs. Default: 5 */\n  numPdSlugs?: number;\n}\n\n/**\n * Result of market cap parameter validation.\n */\nexport interface MarketCapValidationResult {\n  /** Whether all parameters are within normal bounds */\n  valid: boolean;\n  /** Warning messages for unusual but technically valid values */\n  warnings: string[];\n}\n\n// ============================================================================\n// New Multicurve Market Cap API (no tick math required)\n// ============================================================================\n\n/**\n * Curve configuration for Multicurve pools using market cap ranges.\n * Each curve defines a market cap range and liquidity distribution.\n */\nexport interface MulticurveMarketCapRangeCurve {\n  /** Market cap range for this curve */\n  marketCap: {\n    /** Start market cap in USD (for the first curve, this is the launch price) */\n    start: number;\n    /** End market cap in USD */\n    end: number;\n  };\n  /** Number of liquidity positions in this curve */\n  numPositions: number;\n  /** Share of total supply allocated to this curve (WAD, e.g., parseEther('0.3') = 30%) */\n  shares: bigint;\n}\n\n/**\n * Market cap-based configuration for Multicurve pools.\n * No tick math required - just specify market caps in USD.\n */\nexport interface MulticurveMarketCapCurvesConfig {\n  /** Price of numeraire in USD (e.g., 3000 for ETH at $3000) */\n  numerairePrice: number;\n  /** \n   * Array of curves defining market cap ranges and liquidity distribution.\n   * The first curve's marketCap.start is the launch price.\n   * Curves must be contiguous (no gaps allowed).\n   */\n  curves: MulticurveMarketCapRangeCurve[];\n  /** Token supply override */\n  tokenSupply?: bigint;\n  /** Token decimals (default: 18) */\n  tokenDecimals?: number;\n  /** Numeraire decimals (default: 18) */\n  numeraireDecimals?: number;\n  /** Fee tier (default: FEE_TIERS.LOW) */\n  fee?: number;\n  /** Tick spacing (derived from fee if not provided) */\n  tickSpacing?: number;\n  /** Optional beneficiaries for fee streaming */\n  beneficiaries?: BeneficiaryData[];\n}\n\n// Build configuration for static auctions (V3-style)\nexport interface StaticAuctionBuildConfig {\n  // Token details\n  name: string;\n  symbol: string;\n  totalSupply?: bigint; // default: 1 billion\n  numTokensToSell?: bigint; // default: 900 million\n  tokenURI: string;\n\n  // Time parameters\n  startTimeOffset?: number; // Optional - seconds to add to current block timestamp (default: 30)\n\n  // Price parameters - must provide either priceRange or tickRange\n  numeraire: Address; // Required for V3\n  tickRange?: TickRange;\n  priceRange?: PriceRange;\n  fee?: number; // default: 10000 (1%)\n\n  // Pool parameters (V3 specific)\n  numPositions?: number; // default: 15\n  maxShareToBeSold?: bigint; // default: 35% in WAD\n\n  // Vesting parameters\n  yearlyMintRate?: bigint; // default: 2%\n  vestingDuration?: bigint; // default: 1 year\n  recipients?: Address[]; // defaults to [userAddress]\n  amounts?: bigint[]; // defaults based on pre-mint calculation\n\n  // Migration configuration\n  migration: MigrationConfig;\n\n  // Other parameters\n  integrator?: Address;\n  useGovernance?: boolean; // default: true\n}\n\n// Build configuration for dynamic auctions (V4-style)\nexport interface DynamicAuctionBuildConfig {\n  // Token details\n  name: string;\n  symbol: string;\n  totalSupply: bigint;\n  numTokensToSell: bigint;\n  tokenURI: string;\n\n  // Time parameters\n  startTimeOffset?: number; // Optional - seconds to add to block timestamp (default: 30)\n  blockTimestamp?: number; // Optional - specific block timestamp to use (default: fetch latest)\n  duration?: number; // in seconds (default: 604800 = 7 days)\n  epochLength?: number; // in seconds (default: 3600)\n\n  // Price parameters - must provide either priceRange or tickRange\n  numeraire?: Address; // defaults to zero address\n  tickRange?: TickRange;\n  priceRange?: PriceRange;\n  tickSpacing: number;\n  gamma?: number; // auto-calculated if not provided\n  fee: number; // In basis points\n\n  // Sale parameters\n  minProceeds: bigint;\n  maxProceeds: bigint;\n  numPdSlugs?: number; // default: 5\n\n  // Vesting parameters\n  yearlyMintRate?: bigint; // default: 2%\n  vestingDuration: bigint;\n  recipients: Address[];\n  amounts: bigint[];\n\n  // Migration configuration\n  migration: MigrationConfig;\n\n  // Other parameters\n  integrator?: Address;\n  useGovernance?: boolean; // default: true\n}\n\n// SDK initialization configuration\nexport interface DopplerSDKConfig {\n  publicClient: SupportedPublicClient;\n  walletClient?: WalletClient;\n  chainId: number;\n}\n\n// Pool information types\nexport interface PoolInfo {\n  address: Address;\n  tokenAddress: Address;\n  numeraireAddress: Address;\n  fee: number;\n  liquidity: bigint;\n  sqrtPriceX96: bigint;\n}\n\nexport interface HookInfo {\n  hookAddress: Address;\n  tokenAddress: Address;\n  numeraireAddress: Address;\n  poolId: string;\n  currentEpoch: number;\n  totalProceeds: bigint;\n  totalTokensSold: bigint;\n  earlyExit: boolean;\n  insufficientProceeds: boolean;\n  startingTime: bigint;\n  endingTime: bigint;\n  epochLength: bigint;\n  minimumProceeds: bigint;\n  maximumProceeds: bigint;\n}\n\n// Quote result type\nexport interface QuoteResult {\n  amountOut: bigint;\n  priceImpact: number;\n  fee: bigint;\n  route: string[];\n}\n\n// Lockable Uniswap V3 Initializer encode params\nexport interface LockableV3InitializerParams {\n  fee: number;\n  tickLower: number;\n  tickUpper: number;\n  numPositions: number;\n  maxShareToBeSold: bigint;\n  beneficiaries: BeneficiaryData[];\n}\n\n// Multicurve curve configuration (mirrors solidity struct)\nexport interface MulticurveCurve {\n  tickLower: number; // int24\n  tickUpper: number; // int24\n  numPositions: number; // uint16\n  shares: bigint; // uint256 (WAD)\n}\n\nexport type MulticurveMarketCapPreset = 'low' | 'medium' | 'high';\n\nexport interface V4PoolKey {\n  currency0: Address;\n  currency1: Address;\n  fee: number;\n  tickSpacing: number;\n  hooks: Address;\n}\n\nexport interface MulticurveBundleExactOutResult {\n  asset: Address;\n  poolKey: V4PoolKey;\n  amountIn: bigint;\n  gasEstimate: bigint;\n}\n\nexport interface MulticurveBundleExactInResult {\n  asset: Address;\n  poolKey: V4PoolKey;\n  amountOut: bigint;\n  gasEstimate: bigint;\n}\n\n// Create Multicurve initializer parameters\nexport interface CreateMulticurveParams<C extends SupportedChainId = SupportedChainId> {\n  // Token configuration\n  token: TokenConfig;\n\n  // Sale configuration\n  sale: SaleConfig;\n\n  // Pool configuration for multicurve initializer\n  pool: {\n    fee: number;\n    tickSpacing: number;\n    curves: MulticurveCurve[];\n    // Optional beneficiaries to lock the pool (fee collection only, no migration)\n    beneficiaries?: BeneficiaryData[];\n  };\n\n  // Optional scheduled launch configuration\n  schedule?: {\n    startTime: number;\n  };\n\n  // Vesting configuration (optional)\n  vesting?: VestingConfig;\n\n  // Governance configuration\n  governance: GovernanceOption<C>;\n\n  // Migration configuration (can be any supported migrator: V2, V3, or V4)\n  migration: MigrationConfig;\n\n  // Integrator details\n  integrator?: Address;\n  userAddress: Address;\n\n  // Optional address overrides for on-chain modules used during encoding/creation\n  modules?: ModuleAddressOverrides;\n\n  // Optional transaction gas limit override for the create() transaction\n  gas?: bigint;\n}\n\n// Final Params object that gets passed as arg to create\nexport interface CreateParams {\n    initialSupply: bigint,\n    numTokensToSell: bigint,\n    numeraire: Address,\n    tokenFactory: Address,\n    tokenFactoryData: `0x${string}`,\n    governanceFactory: Address,\n    governanceFactoryData: `0x${string}`,\n    poolInitializer: Address,\n    poolInitializerData: `0x${string}`,\n    liquidityMigrator: Address,\n    liquidityMigratorData: `0x${string}`,\n    integrator: Address,\n    salt: `0x${string}`,\n}\n\n// Optional per-call module address overrides. When provided, these take precedence\n// over chain defaults resolved via getAddresses(chainId).\nexport interface ModuleAddressOverrides {\n  // Core deployment & routing\n  airlock?: Address;\n  tokenFactory?: Address;\n\n  // Initializers\n  v3Initializer?: Address;\n  lockableV3Initializer?: Address;\n  v4Initializer?: Address;\n  v4MulticurveInitializer?: Address;\n  v4ScheduledMulticurveInitializer?: Address;\n\n  // Governance\n  governanceFactory?: Address;\n\n  // Dynamic auction infra\n  poolManager?: Address;\n  dopplerDeployer?: Address;\n\n  // Migrators\n  v2Migrator?: Address;\n  v3Migrator?: Address;\n  v4Migrator?: Address;\n  noOpMigrator?: Address;\n}\n"]}