liquid-sdk 1.0.0

package/dist/index.mjs

@@ -0,0 +1,1326 @@
+// src/client.ts
+import {
+  decodeEventLog,
+  encodeAbiParameters,
+  encodePacked,
+  keccak256,
+  getAddress,
+  zeroAddress
+} from "viem";
+import { base as base2 } from "viem/chains";
+
+// src/constants.ts
+import { base } from "viem/chains";
+var ADDRESSES = {
+  FACTORY: "0x0000003482fe299E72d4908368044A8A173BE576",
+  POOL_EXTENSION_ALLOWLIST: "0x000003Afb1b070F037D2871eE0A6b8c8f53F7B77",
+  FEE_LOCKER: "0x000008B9242b7e4432f6c4b1EeAD93562f9Cc94d",
+  LP_LOCKER: "0x00000548732DfA56Be1257cE44D0CFc3B46dDb2A",
+  LP_LOCKER_FEE_CONVERSION: "0x00000547518784420CEeF761fb18D884bb908102",
+  VAULT: "0x000001c5263F4d64CdC343cDA9C8bF961CF8376c",
+  HOOK_DYNAMIC_FEE_V2: "0x2A2F73CDDa098d639bd8Bbcd7dF2bf24E06728cC",
+  HOOK_STATIC_FEE_V2: "0xb2401c5369AaCF62F8d615623C7F68F84da428Cc",
+  SNIPER_AUCTION_V2: "0x000007b64003ee07a69576F98859a0a36b854260",
+  SNIPER_UTIL_V2: "0x000003Ee0cb9B0C82C6C7FCB7b81a9883F285270",
+  MEV_BLOCK_DELAY: "0x0000035D83588954F3c581c3A66251b3F06AD5e4",
+  AIRDROP_V2: "0x00000C222442512b08446D33dd9754a7F260BE79",
+  UNIV4_ETH_DEV_BUY: "0x00000d7DE1f0A3FA7957F5d8A2b97B0E24e5783D",
+  LIQUID_DEPLOYER_LIB: "0x00000f88b2d37A2006F2F0C8552d22E0b8945202"
+};
+var EXTERNAL = {
+  POOL_MANAGER: "0x498581fF718922c3f8e6A244956aF099B2652b2b",
+  WETH: "0x4200000000000000000000000000000000000006",
+  UNIVERSAL_ROUTER: "0x6fF5693b99212Da76ad316178A184AB56D299b43",
+  PERMIT2: "0x000000000022D473030F116dDEE9F6B43aC78BA3"
+};
+var FEE = {
+  /** Fee denominator used by Uniswap v4 (1,000,000 = 100%) */
+  DENOMINATOR: 1e6,
+  /** Protocol fee numerator: 200,000 / 1,000,000 = 20% of LP fees */
+  PROTOCOL_FEE_NUMERATOR: 2e5,
+  /** Max LP fee: 10% (100,000 / 1,000,000) */
+  MAX_LP_FEE: 1e5,
+  /** Max MEV fee: 80% (800,000 / 1,000,000) */
+  MAX_MEV_FEE: 8e5,
+  /** BPS denominator for token supply splits */
+  BPS: 1e4
+};
+var TOKEN = {
+  /** Total supply for every token: 100 billion with 18 decimals */
+  SUPPLY: 100000000000n * 10n ** 18n,
+  DECIMALS: 18,
+  MAX_EXTENSIONS: 10,
+  MAX_EXTENSION_BPS: 9e3
+};
+var DEFAULT_CHAIN = base;
+var DEFAULT_CHAIN_ID = 8453;
+
+// src/abis/LiquidFactory.ts
+var LiquidFactoryAbi = [
+  {
+    type: "function",
+    name: "deployToken",
+    inputs: [
+      {
+        name: "deploymentConfig",
+        type: "tuple",
+        components: [
+          {
+            name: "tokenConfig",
+            type: "tuple",
+            components: [
+              { name: "tokenAdmin", type: "address" },
+              { name: "name", type: "string" },
+              { name: "symbol", type: "string" },
+              { name: "salt", type: "bytes32" },
+              { name: "image", type: "string" },
+              { name: "metadata", type: "string" },
+              { name: "context", type: "string" },
+              { name: "originatingChainId", type: "uint256" }
+            ]
+          },
+          {
+            name: "poolConfig",
+            type: "tuple",
+            components: [
+              { name: "hook", type: "address" },
+              { name: "pairedToken", type: "address" },
+              { name: "tickIfToken0IsLiquid", type: "int24" },
+              { name: "tickSpacing", type: "int24" },
+              { name: "poolData", type: "bytes" }
+            ]
+          },
+          {
+            name: "lockerConfig",
+            type: "tuple",
+            components: [
+              { name: "locker", type: "address" },
+              { name: "rewardAdmins", type: "address[]" },
+              { name: "rewardRecipients", type: "address[]" },
+              { name: "rewardBps", type: "uint16[]" },
+              { name: "tickLower", type: "int24[]" },
+              { name: "tickUpper", type: "int24[]" },
+              { name: "positionBps", type: "uint16[]" },
+              { name: "lockerData", type: "bytes" }
+            ]
+          },
+          {
+            name: "mevModuleConfig",
+            type: "tuple",
+            components: [
+              { name: "mevModule", type: "address" },
+              { name: "mevModuleData", type: "bytes" }
+            ]
+          },
+          {
+            name: "extensionConfigs",
+            type: "tuple[]",
+            components: [
+              { name: "extension", type: "address" },
+              { name: "msgValue", type: "uint256" },
+              { name: "extensionBps", type: "uint16" },
+              { name: "extensionData", type: "bytes" }
+            ]
+          }
+        ]
+      }
+    ],
+    outputs: [{ name: "tokenAddress", type: "address" }],
+    stateMutability: "payable"
+  },
+  {
+    type: "function",
+    name: "tokenDeploymentInfo",
+    inputs: [{ name: "token", type: "address" }],
+    outputs: [
+      {
+        name: "",
+        type: "tuple",
+        components: [
+          { name: "token", type: "address" },
+          { name: "hook", type: "address" },
+          { name: "locker", type: "address" },
+          { name: "extensions", type: "address[]" }
+        ]
+      }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "deploymentInfoForToken",
+    inputs: [{ name: "token", type: "address" }],
+    outputs: [
+      { name: "token", type: "address" },
+      { name: "hook", type: "address" },
+      { name: "locker", type: "address" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "deprecated",
+    inputs: [],
+    outputs: [{ name: "", type: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "TOKEN_SUPPLY",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "BPS",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "teamFeeRecipient",
+    inputs: [],
+    outputs: [{ name: "", type: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "enabledLockers",
+    inputs: [
+      { name: "locker", type: "address" },
+      { name: "hook", type: "address" }
+    ],
+    outputs: [{ name: "enabled", type: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "event",
+    name: "TokenCreated",
+    inputs: [
+      { name: "msgSender", type: "address", indexed: false },
+      { name: "tokenAddress", type: "address", indexed: true },
+      { name: "tokenAdmin", type: "address", indexed: true },
+      { name: "tokenImage", type: "string", indexed: false },
+      { name: "tokenName", type: "string", indexed: false },
+      { name: "tokenSymbol", type: "string", indexed: false },
+      { name: "tokenMetadata", type: "string", indexed: false },
+      { name: "tokenContext", type: "string", indexed: false },
+      { name: "startingTick", type: "int24", indexed: false },
+      { name: "poolHook", type: "address", indexed: false },
+      { name: "poolId", type: "bytes32", indexed: false },
+      { name: "pairedToken", type: "address", indexed: false },
+      { name: "locker", type: "address", indexed: false },
+      { name: "mevModule", type: "address", indexed: false },
+      { name: "extensionsSupply", type: "uint256", indexed: false },
+      { name: "extensions", type: "address[]", indexed: false }
+    ],
+    anonymous: false
+  }
+];
+
+// src/abis/LiquidFeeLocker.ts
+var LiquidFeeLockerAbi = [
+  {
+    type: "function",
+    name: "availableFees",
+    inputs: [
+      { name: "feeOwner", type: "address" },
+      { name: "token", type: "address" }
+    ],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "feesToClaim",
+    inputs: [
+      { name: "feeOwner", type: "address" },
+      { name: "token", type: "address" }
+    ],
+    outputs: [{ name: "balance", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "claim",
+    inputs: [
+      { name: "feeOwner", type: "address" },
+      { name: "token", type: "address" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  }
+];
+
+// src/abis/LiquidHookDynamicFeeV2.ts
+var LiquidHookDynamicFeeV2Abi = [
+  {
+    type: "function",
+    name: "liquidIsToken0",
+    inputs: [{ name: "", type: "bytes32" }],
+    outputs: [{ name: "", type: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "poolConfigVars",
+    inputs: [{ name: "poolId", type: "bytes32" }],
+    outputs: [
+      {
+        name: "",
+        type: "tuple",
+        components: [
+          { name: "baseFee", type: "uint24" },
+          { name: "maxLpFee", type: "uint24" },
+          { name: "referenceTickFilterPeriod", type: "uint256" },
+          { name: "resetPeriod", type: "uint256" },
+          { name: "resetTickFilter", type: "int24" },
+          { name: "feeControlNumerator", type: "uint256" },
+          { name: "decayFilterBps", type: "uint24" }
+        ]
+      }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "poolFeeVars",
+    inputs: [{ name: "poolId", type: "bytes32" }],
+    outputs: [
+      {
+        name: "",
+        type: "tuple",
+        components: [
+          { name: "referenceTick", type: "int24" },
+          { name: "resetTick", type: "int24" },
+          { name: "resetTickTimestamp", type: "uint256" },
+          { name: "lastSwapTimestamp", type: "uint256" },
+          { name: "appliedVR", type: "uint24" },
+          { name: "prevVA", type: "uint24" }
+        ]
+      }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "poolCreationTimestamp",
+    inputs: [{ name: "", type: "bytes32" }],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "protocolFee",
+    inputs: [],
+    outputs: [{ name: "", type: "uint24" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "factory",
+    inputs: [],
+    outputs: [{ name: "", type: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "poolManager",
+    inputs: [],
+    outputs: [{ name: "", type: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "locker",
+    inputs: [],
+    outputs: [{ name: "", type: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "mevModule",
+    inputs: [{ name: "", type: "bytes32" }],
+    outputs: [{ name: "", type: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "mevModuleEnabled",
+    inputs: [{ name: "", type: "bytes32" }],
+    outputs: [{ name: "", type: "bool" }],
+    stateMutability: "view"
+  }
+];
+
+// src/abis/LiquidVault.ts
+var LiquidVaultAbi = [
+  {
+    type: "function",
+    name: "allocation",
+    inputs: [{ name: "", type: "address" }],
+    outputs: [
+      { name: "token", type: "address" },
+      { name: "amountTotal", type: "uint256" },
+      { name: "amountClaimed", type: "uint256" },
+      { name: "lockupEndTime", type: "uint256" },
+      { name: "vestingEndTime", type: "uint256" },
+      { name: "admin", type: "address" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "amountAvailableToClaim",
+    inputs: [{ name: "token", type: "address" }],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "claim",
+    inputs: [{ name: "token", type: "address" }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  }
+];
+
+// src/abis/LiquidSniperAuctionV2.ts
+var LiquidSniperAuctionV2Abi = [
+  {
+    type: "function",
+    name: "nextAuctionBlock",
+    inputs: [{ name: "poolId", type: "bytes32" }],
+    outputs: [{ name: "nextAuctionBlock", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "round",
+    inputs: [{ name: "poolId", type: "bytes32" }],
+    outputs: [{ name: "round", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "gasPeg",
+    inputs: [{ name: "poolId", type: "bytes32" }],
+    outputs: [{ name: "gasPeg", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "feeConfig",
+    inputs: [{ name: "poolId", type: "bytes32" }],
+    outputs: [
+      { name: "startingFee", type: "uint24" },
+      { name: "endingFee", type: "uint24" },
+      { name: "secondsToDecay", type: "uint256" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "getFee",
+    inputs: [{ name: "poolId", type: "bytes32" }],
+    outputs: [{ name: "", type: "uint24" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "poolDecayStartTime",
+    inputs: [{ name: "poolId", type: "bytes32" }],
+    outputs: [{ name: "poolDecayStartTime", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "maxRounds",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "blocksBetweenAuction",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "blocksBetweenDeploymentAndFirstAuction",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "paymentPerGasUnit",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  }
+];
+
+// src/abis/LiquidSniperUtilV2.ts
+var LiquidSniperUtilV2Abi = [
+  {
+    type: "function",
+    name: "bidInAuction",
+    inputs: [
+      {
+        name: "swapParams",
+        type: "tuple",
+        components: [
+          {
+            name: "poolKey",
+            type: "tuple",
+            components: [
+              { name: "currency0", type: "address" },
+              { name: "currency1", type: "address" },
+              { name: "fee", type: "uint24" },
+              { name: "tickSpacing", type: "int24" },
+              { name: "hooks", type: "address" }
+            ]
+          },
+          { name: "zeroForOne", type: "bool" },
+          { name: "amountIn", type: "uint128" },
+          { name: "amountOutMinimum", type: "uint128" },
+          { name: "hookData", type: "bytes" }
+        ]
+      },
+      { name: "round", type: "uint256" }
+    ],
+    outputs: [],
+    stateMutability: "payable"
+  },
+  {
+    type: "function",
+    name: "getTxGasPriceForBidAmount",
+    inputs: [
+      { name: "auctionGasPeg", type: "uint256" },
+      { name: "desiredBidAmount", type: "uint256" }
+    ],
+    outputs: [{ name: "txGasPrice", type: "uint256" }],
+    stateMutability: "view"
+  }
+];
+
+// src/abis/LiquidAirdropV2.ts
+var LiquidAirdropV2Abi = [
+  {
+    type: "function",
+    name: "airdrops",
+    inputs: [{ name: "token", type: "address" }],
+    outputs: [
+      { name: "admin", type: "address" },
+      { name: "merkleRoot", type: "bytes32" },
+      { name: "totalSupply", type: "uint256" },
+      { name: "totalClaimed", type: "uint256" },
+      { name: "lockupEndTime", type: "uint256" },
+      { name: "vestingEndTime", type: "uint256" },
+      { name: "adminClaimTime", type: "uint256" },
+      { name: "adminClaimed", type: "bool" }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "amountAvailableToClaim",
+    inputs: [
+      { name: "token", type: "address" },
+      { name: "recipient", type: "address" },
+      { name: "allocatedAmount", type: "uint256" }
+    ],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "claim",
+    inputs: [
+      { name: "token", type: "address" },
+      { name: "recipient", type: "address" },
+      { name: "allocatedAmount", type: "uint256" },
+      { name: "proof", type: "bytes32[]" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "CLAIM_EXPIRATION_INTERVAL",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "MIN_LOCKUP_DURATION",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  }
+];
+
+// src/abis/LiquidPoolExtensionAllowlist.ts
+var LiquidPoolExtensionAllowlistAbi = [
+  {
+    type: "function",
+    name: "enabledExtensions",
+    inputs: [{ name: "extension", type: "address" }],
+    outputs: [{ name: "enabled", type: "bool" }],
+    stateMutability: "view"
+  }
+];
+
+// src/abis/LiquidMevBlockDelay.ts
+var LiquidMevBlockDelayAbi = [
+  {
+    type: "function",
+    name: "blockDelay",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "poolUnlockTime",
+    inputs: [{ name: "poolId", type: "bytes32" }],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  }
+];
+
+// src/abis/LiquidLpLocker.ts
+var LiquidLpLockerAbi = [
+  {
+    type: "function",
+    name: "tokenRewards",
+    inputs: [{ name: "token", type: "address" }],
+    outputs: [
+      {
+        name: "",
+        type: "tuple",
+        components: [
+          { name: "token", type: "address" },
+          {
+            name: "poolKey",
+            type: "tuple",
+            components: [
+              { name: "currency0", type: "address" },
+              { name: "currency1", type: "address" },
+              { name: "fee", type: "uint24" },
+              { name: "tickSpacing", type: "int24" },
+              { name: "hooks", type: "address" }
+            ]
+          },
+          { name: "positionId", type: "uint256" },
+          { name: "numPositions", type: "uint256" },
+          { name: "rewardBps", type: "uint16[]" },
+          { name: "rewardAdmins", type: "address[]" },
+          { name: "rewardRecipients", type: "address[]" }
+        ]
+      }
+    ],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "collectRewards",
+    inputs: [{ name: "token", type: "address" }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "collectRewardsWithoutUnlock",
+    inputs: [{ name: "token", type: "address" }],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "updateRewardAdmin",
+    inputs: [
+      { name: "token", type: "address" },
+      { name: "rewardIndex", type: "uint256" },
+      { name: "newAdmin", type: "address" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "updateRewardRecipient",
+    inputs: [
+      { name: "token", type: "address" },
+      { name: "rewardIndex", type: "uint256" },
+      { name: "newRecipient", type: "address" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "version",
+    inputs: [],
+    outputs: [{ name: "", type: "string" }],
+    stateMutability: "view"
+  }
+];
+
+// src/abis/ERC20.ts
+var ERC20Abi = [
+  {
+    type: "function",
+    name: "name",
+    inputs: [],
+    outputs: [{ name: "", type: "string" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "symbol",
+    inputs: [],
+    outputs: [{ name: "", type: "string" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "decimals",
+    inputs: [],
+    outputs: [{ name: "", type: "uint8" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "totalSupply",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "balanceOf",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "allowance",
+    inputs: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" }
+    ],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "approve",
+    inputs: [
+      { name: "spender", type: "address" },
+      { name: "value", type: "uint256" }
+    ],
+    outputs: [{ name: "", type: "bool" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "transfer",
+    inputs: [
+      { name: "to", type: "address" },
+      { name: "value", type: "uint256" }
+    ],
+    outputs: [{ name: "", type: "bool" }],
+    stateMutability: "nonpayable"
+  }
+];
+
+// src/client.ts
+var LiquidSDK = class {
+  publicClient;
+  walletClient;
+  constructor(config) {
+    this.publicClient = config.publicClient;
+    this.walletClient = config.walletClient;
+  }
+  // ── Dev Buy Helper ───────────────────────────────────────────────
+  /**
+   * Build an ExtensionConfig for a dev buy (buy tokens with ETH at launch).
+   * The paired token must be WETH for simple dev buys.
+   */
+  buildDevBuyExtension(devBuy) {
+    const extensionData = encodeAbiParameters(
+      [
+        {
+          type: "tuple",
+          components: [
+            {
+              type: "tuple",
+              name: "pairedTokenPoolKey",
+              components: [
+                { type: "address", name: "currency0" },
+                { type: "address", name: "currency1" },
+                { type: "uint24", name: "fee" },
+                { type: "int24", name: "tickSpacing" },
+                { type: "address", name: "hooks" }
+              ]
+            },
+            { type: "uint128", name: "pairedTokenAmountOutMinimum" },
+            { type: "address", name: "recipient" }
+          ]
+        }
+      ],
+      [
+        {
+          pairedTokenPoolKey: {
+            currency0: zeroAddress,
+            currency1: zeroAddress,
+            fee: 0,
+            tickSpacing: 0,
+            hooks: zeroAddress
+          },
+          pairedTokenAmountOutMinimum: 0n,
+          recipient: devBuy.recipient
+        }
+      ]
+    );
+    return {
+      extension: ADDRESSES.UNIV4_ETH_DEV_BUY,
+      msgValue: devBuy.ethAmount,
+      extensionBps: 0,
+      extensionData
+    };
+  }
+  // ── Token Deployment ─────────────────────────────────────────────
+  async deployToken(params) {
+    if (!this.walletClient?.account) {
+      throw new Error("walletClient with account required for deployToken");
+    }
+    const account = this.walletClient.account.address;
+    const deploymentConfig = {
+      tokenConfig: {
+        tokenAdmin: params.tokenAdmin ?? account,
+        name: params.name,
+        symbol: params.symbol,
+        salt: params.salt ?? keccak256(
+          encodePacked(
+            ["string", "string", "uint256"],
+            [params.name, params.symbol, BigInt(Date.now())]
+          )
+        ),
+        image: params.image ?? "",
+        metadata: params.metadata ?? "",
+        context: params.context ?? "",
+        originatingChainId: BigInt(DEFAULT_CHAIN_ID)
+      },
+      poolConfig: {
+        hook: params.hook ?? ADDRESSES.HOOK_DYNAMIC_FEE_V2,
+        pairedToken: params.pairedToken ?? EXTERNAL.WETH,
+        tickIfToken0IsLiquid: params.tickIfToken0IsLiquid ?? -198720,
+        tickSpacing: params.tickSpacing ?? 60,
+        poolData: params.poolData ?? "0x"
+      },
+      lockerConfig: {
+        locker: params.locker ?? ADDRESSES.LP_LOCKER,
+        rewardAdmins: params.rewardAdmins ?? [account],
+        rewardRecipients: params.rewardRecipients ?? [account],
+        rewardBps: params.rewardBps ?? [1e4],
+        tickLower: params.tickLower ?? [-887220],
+        tickUpper: params.tickUpper ?? [887220],
+        positionBps: params.positionBps ?? [1e4],
+        lockerData: params.lockerData ?? "0x"
+      },
+      mevModuleConfig: {
+        mevModule: params.mevModule ?? ADDRESSES.MEV_BLOCK_DELAY,
+        mevModuleData: params.mevModuleData ?? "0x"
+      },
+      extensionConfigs: [...params.extensions ?? []]
+    };
+    if (params.devBuy) {
+      deploymentConfig.extensionConfigs.push(
+        this.buildDevBuyExtension(params.devBuy)
+      );
+    }
+    const msgValue = deploymentConfig.extensionConfigs.reduce(
+      (sum, ext) => sum + ext.msgValue,
+      0n
+    );
+    const txHash = await this.walletClient.writeContract({
+      address: ADDRESSES.FACTORY,
+      abi: LiquidFactoryAbi,
+      functionName: "deployToken",
+      args: [deploymentConfig],
+      value: msgValue,
+      chain: base2,
+      account: this.walletClient.account
+    });
+    const receipt = await this.publicClient.waitForTransactionReceipt({
+      hash: txHash
+    });
+    const tokenCreatedLog = receipt.logs.find((log) => {
+      try {
+        const decoded2 = decodeEventLog({
+          abi: LiquidFactoryAbi,
+          data: log.data,
+          topics: log.topics
+        });
+        return decoded2.eventName === "TokenCreated";
+      } catch {
+        return false;
+      }
+    });
+    if (!tokenCreatedLog) {
+      throw new Error("TokenCreated event not found in transaction receipt");
+    }
+    const decoded = decodeEventLog({
+      abi: LiquidFactoryAbi,
+      data: tokenCreatedLog.data,
+      topics: tokenCreatedLog.topics
+    });
+    const args = decoded.args;
+    return {
+      tokenAddress: getAddress(args.tokenAddress),
+      txHash,
+      event: {
+        msgSender: args.msgSender,
+        tokenAddress: args.tokenAddress,
+        tokenAdmin: args.tokenAdmin,
+        tokenImage: args.tokenImage,
+        tokenName: args.tokenName,
+        tokenSymbol: args.tokenSymbol,
+        tokenMetadata: args.tokenMetadata,
+        tokenContext: args.tokenContext,
+        startingTick: args.startingTick,
+        poolHook: args.poolHook,
+        poolId: args.poolId,
+        pairedToken: args.pairedToken,
+        locker: args.locker,
+        mevModule: args.mevModule,
+        extensionsSupply: args.extensionsSupply,
+        extensions: args.extensions
+      }
+    };
+  }
+  // ── Token Info ────────────────────────────────────────────────────
+  async getDeploymentInfo(tokenAddress) {
+    const result = await this.publicClient.readContract({
+      address: ADDRESSES.FACTORY,
+      abi: LiquidFactoryAbi,
+      functionName: "tokenDeploymentInfo",
+      args: [tokenAddress]
+    });
+    const data = result;
+    return {
+      token: data.token,
+      hook: data.hook,
+      locker: data.locker,
+      extensions: data.extensions
+    };
+  }
+  async getTokenInfo(tokenAddress) {
+    const [name, symbol, decimals, totalSupply] = await Promise.all([
+      this.publicClient.readContract({
+        address: tokenAddress,
+        abi: ERC20Abi,
+        functionName: "name"
+      }),
+      this.publicClient.readContract({
+        address: tokenAddress,
+        abi: ERC20Abi,
+        functionName: "symbol"
+      }),
+      this.publicClient.readContract({
+        address: tokenAddress,
+        abi: ERC20Abi,
+        functionName: "decimals"
+      }),
+      this.publicClient.readContract({
+        address: tokenAddress,
+        abi: ERC20Abi,
+        functionName: "totalSupply"
+      })
+    ]);
+    const deployment = await this.getDeploymentInfo(tokenAddress);
+    return {
+      address: tokenAddress,
+      name,
+      symbol,
+      decimals,
+      totalSupply,
+      deployment
+    };
+  }
+  // ── Pool Info ─────────────────────────────────────────────────────
+  async getPoolConfig(poolId, hookAddress) {
+    const hook = hookAddress ?? ADDRESSES.HOOK_DYNAMIC_FEE_V2;
+    const result = await this.publicClient.readContract({
+      address: hook,
+      abi: LiquidHookDynamicFeeV2Abi,
+      functionName: "poolConfigVars",
+      args: [poolId]
+    });
+    const data = result;
+    return {
+      baseFee: data.baseFee,
+      maxLpFee: data.maxLpFee,
+      referenceTickFilterPeriod: data.referenceTickFilterPeriod,
+      resetPeriod: data.resetPeriod,
+      resetTickFilter: data.resetTickFilter,
+      feeControlNumerator: data.feeControlNumerator,
+      decayFilterBps: data.decayFilterBps
+    };
+  }
+  async getPoolFeeState(poolId, hookAddress) {
+    const hook = hookAddress ?? ADDRESSES.HOOK_DYNAMIC_FEE_V2;
+    const result = await this.publicClient.readContract({
+      address: hook,
+      abi: LiquidHookDynamicFeeV2Abi,
+      functionName: "poolFeeVars",
+      args: [poolId]
+    });
+    const data = result;
+    return {
+      referenceTick: data.referenceTick,
+      resetTick: data.resetTick,
+      resetTickTimestamp: data.resetTickTimestamp,
+      lastSwapTimestamp: data.lastSwapTimestamp,
+      appliedVR: data.appliedVR,
+      prevVA: data.prevVA
+    };
+  }
+  async getPoolCreationTimestamp(poolId, hookAddress) {
+    const hook = hookAddress ?? ADDRESSES.HOOK_DYNAMIC_FEE_V2;
+    return await this.publicClient.readContract({
+      address: hook,
+      abi: LiquidHookDynamicFeeV2Abi,
+      functionName: "poolCreationTimestamp",
+      args: [poolId]
+    });
+  }
+  async isLiquidToken0(poolId, hookAddress) {
+    const hook = hookAddress ?? ADDRESSES.HOOK_DYNAMIC_FEE_V2;
+    return await this.publicClient.readContract({
+      address: hook,
+      abi: LiquidHookDynamicFeeV2Abi,
+      functionName: "liquidIsToken0",
+      args: [poolId]
+    });
+  }
+  // ── Fee Claims ────────────────────────────────────────────────────
+  async getAvailableFees(feeOwner, tokenAddress) {
+    return await this.publicClient.readContract({
+      address: ADDRESSES.FEE_LOCKER,
+      abi: LiquidFeeLockerAbi,
+      functionName: "availableFees",
+      args: [feeOwner, tokenAddress]
+    });
+  }
+  async getFeesToClaim(feeOwner, tokenAddress) {
+    return await this.publicClient.readContract({
+      address: ADDRESSES.FEE_LOCKER,
+      abi: LiquidFeeLockerAbi,
+      functionName: "feesToClaim",
+      args: [feeOwner, tokenAddress]
+    });
+  }
+  async claimFees(feeOwner, tokenAddress) {
+    if (!this.walletClient?.account) {
+      throw new Error("walletClient with account required for claimFees");
+    }
+    return this.walletClient.writeContract({
+      address: ADDRESSES.FEE_LOCKER,
+      abi: LiquidFeeLockerAbi,
+      functionName: "claim",
+      args: [feeOwner, tokenAddress],
+      chain: base2,
+      account: this.walletClient.account
+    });
+  }
+  // ── Vault ─────────────────────────────────────────────────────────
+  async getVaultAllocation(tokenAddress) {
+    const result = await this.publicClient.readContract({
+      address: ADDRESSES.VAULT,
+      abi: LiquidVaultAbi,
+      functionName: "allocation",
+      args: [tokenAddress]
+    });
+    const data = result;
+    return {
+      token: data[0] ?? data.token,
+      amountTotal: data[1] ?? data.amountTotal,
+      amountClaimed: data[2] ?? data.amountClaimed,
+      lockupEndTime: data[3] ?? data.lockupEndTime,
+      vestingEndTime: data[4] ?? data.vestingEndTime,
+      admin: data[5] ?? data.admin
+    };
+  }
+  async getVaultClaimable(tokenAddress) {
+    return await this.publicClient.readContract({
+      address: ADDRESSES.VAULT,
+      abi: LiquidVaultAbi,
+      functionName: "amountAvailableToClaim",
+      args: [tokenAddress]
+    });
+  }
+  async claimVault(tokenAddress) {
+    if (!this.walletClient?.account) {
+      throw new Error("walletClient with account required for claimVault");
+    }
+    return this.walletClient.writeContract({
+      address: ADDRESSES.VAULT,
+      abi: LiquidVaultAbi,
+      functionName: "claim",
+      args: [tokenAddress],
+      chain: base2,
+      account: this.walletClient.account
+    });
+  }
+  // ── Factory Status ────────────────────────────────────────────────
+  async isFactoryDeprecated() {
+    return await this.publicClient.readContract({
+      address: ADDRESSES.FACTORY,
+      abi: LiquidFactoryAbi,
+      functionName: "deprecated"
+    });
+  }
+  async isLockerEnabled(locker, hook) {
+    return await this.publicClient.readContract({
+      address: ADDRESSES.FACTORY,
+      abi: LiquidFactoryAbi,
+      functionName: "enabledLockers",
+      args: [locker, hook]
+    });
+  }
+  // ── Sniper Auction ─────────────────────────────────────────────────
+  async getAuctionState(poolId) {
+    const [nextAuctionBlock, round, gasPeg, currentFee] = await Promise.all([
+      this.publicClient.readContract({
+        address: ADDRESSES.SNIPER_AUCTION_V2,
+        abi: LiquidSniperAuctionV2Abi,
+        functionName: "nextAuctionBlock",
+        args: [poolId]
+      }),
+      this.publicClient.readContract({
+        address: ADDRESSES.SNIPER_AUCTION_V2,
+        abi: LiquidSniperAuctionV2Abi,
+        functionName: "round",
+        args: [poolId]
+      }),
+      this.publicClient.readContract({
+        address: ADDRESSES.SNIPER_AUCTION_V2,
+        abi: LiquidSniperAuctionV2Abi,
+        functionName: "gasPeg",
+        args: [poolId]
+      }),
+      this.publicClient.readContract({
+        address: ADDRESSES.SNIPER_AUCTION_V2,
+        abi: LiquidSniperAuctionV2Abi,
+        functionName: "getFee",
+        args: [poolId]
+      })
+    ]);
+    return {
+      nextAuctionBlock,
+      round,
+      gasPeg,
+      currentFee
+    };
+  }
+  async getAuctionFeeConfig(poolId) {
+    const result = await this.publicClient.readContract({
+      address: ADDRESSES.SNIPER_AUCTION_V2,
+      abi: LiquidSniperAuctionV2Abi,
+      functionName: "feeConfig",
+      args: [poolId]
+    });
+    const data = result;
+    return {
+      startingFee: Array.isArray(data) ? data[0] : data.startingFee,
+      endingFee: Array.isArray(data) ? data[1] : data.endingFee,
+      secondsToDecay: Array.isArray(data) ? data[2] : data.secondsToDecay
+    };
+  }
+  async getAuctionDecayStartTime(poolId) {
+    return await this.publicClient.readContract({
+      address: ADDRESSES.SNIPER_AUCTION_V2,
+      abi: LiquidSniperAuctionV2Abi,
+      functionName: "poolDecayStartTime",
+      args: [poolId]
+    });
+  }
+  async getAuctionMaxRounds() {
+    return await this.publicClient.readContract({
+      address: ADDRESSES.SNIPER_AUCTION_V2,
+      abi: LiquidSniperAuctionV2Abi,
+      functionName: "maxRounds"
+    });
+  }
+  async getAuctionGasPriceForBid(auctionGasPeg, desiredBidAmount) {
+    return await this.publicClient.readContract({
+      address: ADDRESSES.SNIPER_UTIL_V2,
+      abi: LiquidSniperUtilV2Abi,
+      functionName: "getTxGasPriceForBidAmount",
+      args: [auctionGasPeg, desiredBidAmount]
+    });
+  }
+  // ── Airdrop ─────────────────────────────────────────────────────────
+  async getAirdropInfo(tokenAddress) {
+    const result = await this.publicClient.readContract({
+      address: ADDRESSES.AIRDROP_V2,
+      abi: LiquidAirdropV2Abi,
+      functionName: "airdrops",
+      args: [tokenAddress]
+    });
+    const data = result;
+    return {
+      admin: Array.isArray(data) ? data[0] : data.admin,
+      merkleRoot: Array.isArray(data) ? data[1] : data.merkleRoot,
+      totalSupply: Array.isArray(data) ? data[2] : data.totalSupply,
+      totalClaimed: Array.isArray(data) ? data[3] : data.totalClaimed,
+      lockupEndTime: Array.isArray(data) ? data[4] : data.lockupEndTime,
+      vestingEndTime: Array.isArray(data) ? data[5] : data.vestingEndTime,
+      adminClaimTime: Array.isArray(data) ? data[6] : data.adminClaimTime,
+      adminClaimed: Array.isArray(data) ? data[7] : data.adminClaimed
+    };
+  }
+  async getAirdropClaimable(tokenAddress, recipient, allocatedAmount) {
+    return await this.publicClient.readContract({
+      address: ADDRESSES.AIRDROP_V2,
+      abi: LiquidAirdropV2Abi,
+      functionName: "amountAvailableToClaim",
+      args: [tokenAddress, recipient, allocatedAmount]
+    });
+  }
+  async claimAirdrop(tokenAddress, recipient, allocatedAmount, proof) {
+    if (!this.walletClient?.account) {
+      throw new Error("walletClient with account required for claimAirdrop");
+    }
+    return this.walletClient.writeContract({
+      address: ADDRESSES.AIRDROP_V2,
+      abi: LiquidAirdropV2Abi,
+      functionName: "claim",
+      args: [tokenAddress, recipient, allocatedAmount, proof],
+      chain: base2,
+      account: this.walletClient.account
+    });
+  }
+  // ── LP Locker ───────────────────────────────────────────────────────
+  async getTokenRewards(tokenAddress, lockerAddress) {
+    const locker = lockerAddress ?? ADDRESSES.LP_LOCKER;
+    const result = await this.publicClient.readContract({
+      address: locker,
+      abi: LiquidLpLockerAbi,
+      functionName: "tokenRewards",
+      args: [tokenAddress]
+    });
+    const data = result;
+    return {
+      token: data.token,
+      poolKey: data.poolKey,
+      positionId: data.positionId,
+      numPositions: data.numPositions,
+      rewardBps: [...data.rewardBps],
+      rewardAdmins: [...data.rewardAdmins],
+      rewardRecipients: [...data.rewardRecipients]
+    };
+  }
+  async collectRewards(tokenAddress, lockerAddress) {
+    if (!this.walletClient?.account) {
+      throw new Error("walletClient with account required for collectRewards");
+    }
+    const locker = lockerAddress ?? ADDRESSES.LP_LOCKER;
+    return this.walletClient.writeContract({
+      address: locker,
+      abi: LiquidLpLockerAbi,
+      functionName: "collectRewards",
+      args: [tokenAddress],
+      chain: base2,
+      account: this.walletClient.account
+    });
+  }
+  async collectRewardsWithoutUnlock(tokenAddress, lockerAddress) {
+    if (!this.walletClient?.account) {
+      throw new Error(
+        "walletClient with account required for collectRewardsWithoutUnlock"
+      );
+    }
+    const locker = lockerAddress ?? ADDRESSES.LP_LOCKER;
+    return this.walletClient.writeContract({
+      address: locker,
+      abi: LiquidLpLockerAbi,
+      functionName: "collectRewardsWithoutUnlock",
+      args: [tokenAddress],
+      chain: base2,
+      account: this.walletClient.account
+    });
+  }
+  async updateRewardRecipient(tokenAddress, rewardIndex, newRecipient, lockerAddress) {
+    if (!this.walletClient?.account) {
+      throw new Error(
+        "walletClient with account required for updateRewardRecipient"
+      );
+    }
+    const locker = lockerAddress ?? ADDRESSES.LP_LOCKER;
+    return this.walletClient.writeContract({
+      address: locker,
+      abi: LiquidLpLockerAbi,
+      functionName: "updateRewardRecipient",
+      args: [tokenAddress, rewardIndex, newRecipient],
+      chain: base2,
+      account: this.walletClient.account
+    });
+  }
+  // ── Pool Extension Allowlist ────────────────────────────────────────
+  async isExtensionEnabled(extensionAddress) {
+    return await this.publicClient.readContract({
+      address: ADDRESSES.POOL_EXTENSION_ALLOWLIST,
+      abi: LiquidPoolExtensionAllowlistAbi,
+      functionName: "enabledExtensions",
+      args: [extensionAddress]
+    });
+  }
+  // ── MEV Block Delay ─────────────────────────────────────────────────
+  async getMevBlockDelay() {
+    return await this.publicClient.readContract({
+      address: ADDRESSES.MEV_BLOCK_DELAY,
+      abi: LiquidMevBlockDelayAbi,
+      functionName: "blockDelay"
+    });
+  }
+  async getPoolUnlockTime(poolId) {
+    return await this.publicClient.readContract({
+      address: ADDRESSES.MEV_BLOCK_DELAY,
+      abi: LiquidMevBlockDelayAbi,
+      functionName: "poolUnlockTime",
+      args: [poolId]
+    });
+  }
+};
+export {
+  ADDRESSES,
+  DEFAULT_CHAIN,
+  DEFAULT_CHAIN_ID,
+  ERC20Abi,
+  EXTERNAL,
+  FEE,
+  LiquidAirdropV2Abi,
+  LiquidFactoryAbi,
+  LiquidFeeLockerAbi,
+  LiquidHookDynamicFeeV2Abi,
+  LiquidLpLockerAbi,
+  LiquidMevBlockDelayAbi,
+  LiquidPoolExtensionAllowlistAbi,
+  LiquidSDK,
+  LiquidSniperAuctionV2Abi,
+  LiquidSniperUtilV2Abi,
+  LiquidVaultAbi,
+  TOKEN
+};
+//# sourceMappingURL=index.mjs.map