liquid-sdk 1.6.5 → 1.7.2

package/dist/index.mjs

@@ -816,8 +816,8 @@ var LiquidPoolExtensionAllowlistAbi = [
   }
 ];
 
-// src/abis/LiquidMevBlockDelay.ts
-var LiquidMevBlockDelayAbi = [
+// src/abis/LiquidMevDescendingFees.ts
+var LiquidMevDescendingFeesAbi = [
   {
     type: "function",
     name: "blockDelay",
@@ -1086,6 +1086,63 @@ var LiquidSDK = class {
       extensionData
     };
   }
+  /**
+   * Build a vault extension config for token deployment.
+   *
+   * Locks a percentage of the token supply with a lockup period
+   * followed by optional linear vesting.
+   *
+   * @param vault - Vault parameters
+   * @returns ExtensionConfig to include in `deployToken({ extensions })`
+   *
+   * @example
+   * ```typescript
+   * const vaultExt = sdk.buildVaultExtension({
+   *   admin: account.address,
+   *   allocationBps: 2000,       // 20% of supply
+   *   lockupDuration: 2592000,   // 30 days in seconds
+   *   vestingDuration: 7776000,  // 90 days linear vesting after lockup
+   * });
+   * const result = await sdk.deployToken({
+   *   name: "My Token", symbol: "MTK",
+   *   extensions: [vaultExt],
+   * });
+   * ```
+   */
+  buildVaultExtension(vault) {
+    const MIN_LOCKUP = 604800;
+    const MAX_BPS = 9e3;
+    if (vault.allocationBps < 1 || vault.allocationBps > MAX_BPS) {
+      throw new Error(`Vault allocationBps must be 1\u2013${MAX_BPS} (0.01%\u201390%). Got ${vault.allocationBps}.`);
+    }
+    if (vault.lockupDuration < MIN_LOCKUP) {
+      throw new Error(`Vault lockupDuration must be \u2265 ${MIN_LOCKUP} seconds (7 days). Got ${vault.lockupDuration}.`);
+    }
+    if (vault.vestingDuration !== void 0 && vault.vestingDuration < 0) {
+      throw new Error("Vault vestingDuration cannot be negative.");
+    }
+    const extensionData = encodeAbiParameters2(
+      [
+        { type: "address" },
+        // admin
+        { type: "uint256" },
+        // lockupDuration
+        { type: "uint256" }
+        // vestingDuration
+      ],
+      [
+        vault.admin,
+        BigInt(vault.lockupDuration),
+        BigInt(vault.vestingDuration ?? 0)
+      ]
+    );
+    return {
+      extension: ADDRESSES.VAULT,
+      msgValue: 0n,
+      extensionBps: vault.allocationBps,
+      extensionData
+    };
+  }
   // ── Validation ─────────────────────────────────────────────────
   /**
    * Validate a DeploymentConfig before sending to the contract.
@@ -1413,23 +1470,39 @@ var LiquidSDK = class {
     });
   }
   // ── Fee Claims ────────────────────────────────────────────────────
-  async getAvailableFees(feeOwner, tokenAddress) {
+  /**
+   * Get uncollected fees for a fee owner.
+   * @param feeOwner - Address that receives fees (reward recipient)
+   * @param feeToken - The token fees are denominated in. Defaults to WETH
+   *   (correct for all pools using LP_LOCKER_FEE_CONVERSION).
+   */
+  async getAvailableFees(feeOwner, feeToken = EXTERNAL.WETH) {
     return await this.publicClient.readContract({
       address: ADDRESSES.FEE_LOCKER,
       abi: LiquidFeeLockerAbi,
       functionName: "availableFees",
-      args: [feeOwner, tokenAddress]
+      args: [feeOwner, feeToken]
     });
   }
-  async getFeesToClaim(feeOwner, tokenAddress) {
+  /**
+   * Get collected, claimable fees for a fee owner.
+   * @param feeOwner - Address that receives fees (reward recipient)
+   * @param feeToken - The token fees are denominated in. Defaults to WETH.
+   */
+  async getFeesToClaim(feeOwner, feeToken = EXTERNAL.WETH) {
     return await this.publicClient.readContract({
       address: ADDRESSES.FEE_LOCKER,
       abi: LiquidFeeLockerAbi,
       functionName: "feesToClaim",
-      args: [feeOwner, tokenAddress]
+      args: [feeOwner, feeToken]
     });
   }
-  async claimFees(feeOwner, tokenAddress) {
+  /**
+   * Claim all accumulated fees for a fee owner.
+   * @param feeOwner - Address that receives fees (reward recipient)
+   * @param feeToken - The token fees are denominated in. Defaults to WETH.
+   */
+  async claimFees(feeOwner, feeToken = EXTERNAL.WETH) {
     if (!this.walletClient?.account) {
       throw new Error("walletClient with account required for claimFees");
     }
@@ -1437,7 +1510,7 @@ var LiquidSDK = class {
       address: ADDRESSES.FEE_LOCKER,
       abi: LiquidFeeLockerAbi,
       functionName: "claim",
-      args: [feeOwner, tokenAddress],
+      args: [feeOwner, feeToken],
       chain: base2,
       account: this.walletClient.account
     });
@@ -1806,18 +1879,22 @@ var LiquidSDK = class {
       args: [extensionAddress]
     });
   }
-  // ── MEV Block Delay ─────────────────────────────────────────────────
-  async getMevBlockDelay() {
+  // ── MEV Descending Fees ─────────────────────────────────────────────
+  async getMevDescendingFeesBlockDelay() {
     return await this.publicClient.readContract({
       address: ADDRESSES.MEV_DESCENDING_FEES,
-      abi: LiquidMevBlockDelayAbi,
+      abi: LiquidMevDescendingFeesAbi,
       functionName: "blockDelay"
     });
   }
+  /** @deprecated Use getMevDescendingFeesBlockDelay() */
+  async getMevBlockDelay() {
+    return this.getMevDescendingFeesBlockDelay();
+  }
   async getPoolUnlockTime(poolId) {
     return await this.publicClient.readContract({
       address: ADDRESSES.MEV_DESCENDING_FEES,
-      abi: LiquidMevBlockDelayAbi,
+      abi: LiquidMevDescendingFeesAbi,
       functionName: "poolUnlockTime",
       args: [poolId]
     });
@@ -1964,6 +2041,24 @@ var LiquidSDK = class {
   }
 };
 
+// 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/LiquidUniv4EthDevBuy.ts
 var LiquidUniv4EthDevBuyAbi = [
   {
@@ -2238,6 +2333,7 @@ export {
   LiquidHookDynamicFeeV2Abi,
   LiquidLpLockerAbi,
   LiquidMevBlockDelayAbi,
+  LiquidMevDescendingFeesAbi,
   LiquidPoolExtensionAllowlistAbi,
   LiquidSDK,
   LiquidSniperAuctionV2Abi,