liquid-sdk 1.5.1 → 1.5.3

package/AGENT_README.md

@@ -511,19 +511,18 @@ All addresses are exported as `ADDRESSES` and `EXTERNAL`:
 import { ADDRESSES, EXTERNAL } from "liquid-sdk";
 
 // Liquid Protocol contracts
-ADDRESSES.FACTORY                  // 0x0000003482fe299E72d4908368044A8A173BE576
-ADDRESSES.LP_LOCKER                // 0x00000548732DfA56Be1257cE44D0CFc3B46dDb2A
-ADDRESSES.FEE_LOCKER               // 0x000008B9242b7e4432f6c4b1EeAD93562f9Cc94d
-ADDRESSES.VAULT                    // 0x000001c5263F4d64CdC343cDA9C8bF961CF8376c
-ADDRESSES.HOOK_DYNAMIC_FEE_V2      // 0x2A2F73CDDa098d639bd8Bbcd7dF2bf24E06728cC
-ADDRESSES.HOOK_STATIC_FEE_V2       // 0xb2401c5369AaCF62F8d615623C7F68F84da428Cc
-ADDRESSES.AIRDROP_V2               // 0x00000C222442512b08446D33dd9754a7F260BE79
-ADDRESSES.SNIPER_AUCTION_V2        // 0x000007b64003ee07a69576F98859a0a36b854260
-ADDRESSES.SNIPER_UTIL_V2           // 0x000003Ee0cb9B0C82C6C7FCB7b81a9883F285270
-ADDRESSES.MEV_BLOCK_DELAY          // 0x0000035D83588954F3c581c3A66251b3F06AD5e4
-ADDRESSES.UNIV4_ETH_DEV_BUY        // 0x00000d7DE1f0A3FA7957F5d8A2b97B0E24e5783D
-ADDRESSES.POOL_EXTENSION_ALLOWLIST  // 0x000003Afb1b070F037D2871eE0A6b8c8f53F7B77
-ADDRESSES.LIQUID_DEPLOYER_LIB      // 0x00000f88b2d37A2006F2F0C8552d22E0b8945202
+ADDRESSES.FACTORY                  // 0x04F1a284168743759BE6554f607a10CEBdB77760
+ADDRESSES.LP_LOCKER_FEE_CONVERSION // 0x77247fCD1d5e34A3703AcA898A591Dc7422435f3
+ADDRESSES.FEE_LOCKER               // 0xF7d3BE3FC0de76fA5550C29A8F6fa53667B876FF
+ADDRESSES.VAULT                    // 0xdFCCC93257c20519A9005A2281CFBdF84836d50E
+ADDRESSES.HOOK_DYNAMIC_FEE_V2      // 0x80E2F7dC8C2C880BbC4BDF80A5Fb0eB8B1DB68CC
+ADDRESSES.HOOK_STATIC_FEE_V2       // 0x9811f10Cd549c754Fa9E5785989c422A762c28cc
+ADDRESSES.AIRDROP_V2               // 0x1423974d48f525462f1c087cBFdCC20BDBc33CdD
+ADDRESSES.SNIPER_AUCTION_V2        // 0x187e8627c02c58F31831953C1268e157d3BfCefd
+ADDRESSES.SNIPER_UTIL_V2           // 0x2B6cd5Be183c388Dd0074d53c52317df1414cd9f
+ADDRESSES.MEV_DESCENDING_FEES      // 0x8D6B080e48756A99F3893491D556B5d6907b6910
+ADDRESSES.UNIV4_ETH_DEV_BUY        // 0x5934097864dC487D21A7B4e4EEe201A39ceF728D
+ADDRESSES.POOL_EXTENSION_ALLOWLIST  // 0xb614167d79aDBaA9BA35d05fE1d5542d7316Ccaa
 
 // External (Uniswap V4 / Base)
 EXTERNAL.POOL_MANAGER              // 0x498581fF718922c3f8e6A244956aF099B2652b2b

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Liquid Protocol
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -246,18 +246,18 @@ All contracts are deployed on **Base** (chain ID 8453):
 
 | Contract | Address |
 |----------|---------|
-| Factory | `0x0000003482fe299E72d4908368044A8A173BE576` |
-| Hook Dynamic Fee V2 | `0x2A2F73CDDa098d639bd8Bbcd7dF2bf24E06728cC` |
-| Hook Static Fee V2 | `0xb2401c5369AaCF62F8d615623C7F68F84da428Cc` |
-| Fee Locker | `0x000008B9242b7e4432f6c4b1EeAD93562f9Cc94d` |
-| LP Locker | `0x00000548732DfA56Be1257cE44D0CFc3B46dDb2A` |
-| LP Locker Fee Conversion | `0x00000547518784420CEeF761fb18D884bb908102` |
-| Vault | `0x000001c5263F4d64CdC343cDA9C8bF961CF8376c` |
-| Sniper Auction V2 | `0x000007b64003ee07a69576F98859a0a36b854260` |
-| Sniper Util V2 | `0x000003Ee0cb9B0C82C6C7FCB7b81a9883F285270` |
-| MEV Block Delay | `0x0000035D83588954F3c581c3A66251b3F06AD5e4` |
-| Airdrop V2 | `0x00000C222442512b08446D33dd9754a7F260BE79` |
-| Pool Extension Allowlist | `0x000003Afb1b070F037D2871eE0A6b8c8f53F7B77` |
+| Factory | `0x04F1a284168743759BE6554f607a10CEBdB77760` |
+| Hook Dynamic Fee V2 | `0x80E2F7dC8C2C880BbC4BDF80A5Fb0eB8B1DB68CC` |
+| Hook Static Fee V2 | `0x9811f10Cd549c754Fa9E5785989c422A762c28cc` |
+| Fee Locker | `0xF7d3BE3FC0de76fA5550C29A8F6fa53667B876FF` |
+| LP Locker Fee Conversion | `0x77247fCD1d5e34A3703AcA898A591Dc7422435f3` |
+| Vault | `0xdFCCC93257c20519A9005A2281CFBdF84836d50E` |
+| Sniper Auction V2 | `0x187e8627c02c58F31831953C1268e157d3BfCefd` |
+| Sniper Util V2 | `0x2B6cd5Be183c388Dd0074d53c52317df1414cd9f` |
+| MEV Descending Fees | `0x8D6B080e48756A99F3893491D556B5d6907b6910` |
+| Airdrop V2 | `0x1423974d48f525462f1c087cBFdCC20BDBc33CdD` |
+| Pool Extension Allowlist | `0xb614167d79aDBaA9BA35d05fE1d5542d7316Ccaa` |
+| Univ4 ETH Dev Buy | `0x5934097864dC487D21A7B4e4EEe201A39ceF728D` |
 
 ## License
 

package/dist/index.d.mts

@@ -200,9 +200,16 @@ interface LiquidSDKConfig {
 interface BidInAuctionParams {
     /** The pool key identifying the token's Uniswap V4 pool */
     poolKey: PoolKey;
-    /** True if swapping token0 → token1 (typically ETH → token) */
+    /**
+     * Swap direction. Set `true` when WETH is currency0 (buying token with ETH).
+     * Determine via: `poolKey.currency0.toLowerCase() === WETH.toLowerCase()`
+     */
     zeroForOne: boolean;
-    /** Amount of input token (in wei) */
+    /**
+     * Amount of WETH to swap (in wei). Pulled from caller's WETH balance via
+     * `transferFrom` — separate from the bid. The SDK auto-wraps ETH → WETH
+     * and approves SniperUtilV2 if balance or allowance is insufficient.
+     */
     amountIn: bigint;
     /** Minimum output tokens to receive (slippage protection) */
     amountOutMinimum: bigint;
@@ -267,22 +274,30 @@ declare class LiquidSDK {
      * The auction lets bidders compete via gas price — the bid amount is
      * determined by how much your tx.gasprice exceeds the pool's gasPeg.
      *
+     * **Important:** The `amountIn` (swap input) is pulled from the caller's
+     * WETH balance via `transferFrom`. The SDK automatically wraps ETH → WETH
+     * and approves the SniperUtilV2 if needed. The `bidAmount` is sent as
+     * `msg.value` (separate from the swap).
+     *
+     * Gas price must exceed the pool's `gasPeg` — the delta encodes the bid.
+     * Both `maxFeePerGas` and `maxPriorityFeePerGas` are set to ensure the
+     * effective gas price matches on Base (EIP-1559). Gas estimation is skipped
+     * because `eth_estimateGas` simulates at `baseFee` which is below `gasPeg`.
+     *
      * @example
      * ```typescript
-     * // 1. Get auction state
+     * // 1. Get auction state & pool key
      * const state = await sdk.getAuctionState(poolId);
+     * const rewards = await sdk.getTokenRewards(tokenAddress);
      *
      * // 2. Calculate gas price for desired bid
      * const gasPrice = await sdk.getAuctionGasPriceForBid(state.gasPeg, bidAmount);
      *
-     * // 3. Get pool key from token rewards
-     * const rewards = await sdk.getTokenRewards(tokenAddress);
-     *
-     * // 4. Bid
+     * // 3. Bid (SDK auto-wraps WETH + approves if needed)
      * const result = await sdk.bidInAuction({
      *   poolKey: rewards.poolKey,
      *   zeroForOne: true,            // ETH → token
-     *   amountIn: parseEther("0.1"), // swap 0.1 ETH
+     *   amountIn: parseEther("0.1"), // swap 0.1 ETH (pulled from WETH balance)
      *   amountOutMinimum: 0n,        // set slippage
      *   round: state.round,
      *   bidAmount: parseEther("0.01"),

package/dist/index.d.ts

@@ -200,9 +200,16 @@ interface LiquidSDKConfig {
 interface BidInAuctionParams {
     /** The pool key identifying the token's Uniswap V4 pool */
     poolKey: PoolKey;
-    /** True if swapping token0 → token1 (typically ETH → token) */
+    /**
+     * Swap direction. Set `true` when WETH is currency0 (buying token with ETH).
+     * Determine via: `poolKey.currency0.toLowerCase() === WETH.toLowerCase()`
+     */
     zeroForOne: boolean;
-    /** Amount of input token (in wei) */
+    /**
+     * Amount of WETH to swap (in wei). Pulled from caller's WETH balance via
+     * `transferFrom` — separate from the bid. The SDK auto-wraps ETH → WETH
+     * and approves SniperUtilV2 if balance or allowance is insufficient.
+     */
     amountIn: bigint;
     /** Minimum output tokens to receive (slippage protection) */
     amountOutMinimum: bigint;
@@ -267,22 +274,30 @@ declare class LiquidSDK {
      * The auction lets bidders compete via gas price — the bid amount is
      * determined by how much your tx.gasprice exceeds the pool's gasPeg.
      *
+     * **Important:** The `amountIn` (swap input) is pulled from the caller's
+     * WETH balance via `transferFrom`. The SDK automatically wraps ETH → WETH
+     * and approves the SniperUtilV2 if needed. The `bidAmount` is sent as
+     * `msg.value` (separate from the swap).
+     *
+     * Gas price must exceed the pool's `gasPeg` — the delta encodes the bid.
+     * Both `maxFeePerGas` and `maxPriorityFeePerGas` are set to ensure the
+     * effective gas price matches on Base (EIP-1559). Gas estimation is skipped
+     * because `eth_estimateGas` simulates at `baseFee` which is below `gasPeg`.
+     *
      * @example
      * ```typescript
-     * // 1. Get auction state
+     * // 1. Get auction state & pool key
      * const state = await sdk.getAuctionState(poolId);
+     * const rewards = await sdk.getTokenRewards(tokenAddress);
      *
      * // 2. Calculate gas price for desired bid
      * const gasPrice = await sdk.getAuctionGasPriceForBid(state.gasPeg, bidAmount);
      *
-     * // 3. Get pool key from token rewards
-     * const rewards = await sdk.getTokenRewards(tokenAddress);
-     *
-     * // 4. Bid
+     * // 3. Bid (SDK auto-wraps WETH + approves if needed)
      * const result = await sdk.bidInAuction({
      *   poolKey: rewards.poolKey,
      *   zeroForOne: true,            // ETH → token
-     *   amountIn: parseEther("0.1"), // swap 0.1 ETH
+     *   amountIn: parseEther("0.1"), // swap 0.1 ETH (pulled from WETH balance)
      *   amountOutMinimum: 0n,        // set slippage
      *   round: state.round,
      *   bidAmount: parseEther("0.01"),

package/dist/index.js

@@ -1631,22 +1631,30 @@ var LiquidSDK = class {
    * The auction lets bidders compete via gas price — the bid amount is
    * determined by how much your tx.gasprice exceeds the pool's gasPeg.
    *
+   * **Important:** The `amountIn` (swap input) is pulled from the caller's
+   * WETH balance via `transferFrom`. The SDK automatically wraps ETH → WETH
+   * and approves the SniperUtilV2 if needed. The `bidAmount` is sent as
+   * `msg.value` (separate from the swap).
+   *
+   * Gas price must exceed the pool's `gasPeg` — the delta encodes the bid.
+   * Both `maxFeePerGas` and `maxPriorityFeePerGas` are set to ensure the
+   * effective gas price matches on Base (EIP-1559). Gas estimation is skipped
+   * because `eth_estimateGas` simulates at `baseFee` which is below `gasPeg`.
+   *
    * @example
    * ```typescript
-   * // 1. Get auction state
+   * // 1. Get auction state & pool key
    * const state = await sdk.getAuctionState(poolId);
+   * const rewards = await sdk.getTokenRewards(tokenAddress);
    *
    * // 2. Calculate gas price for desired bid
    * const gasPrice = await sdk.getAuctionGasPriceForBid(state.gasPeg, bidAmount);
    *
-   * // 3. Get pool key from token rewards
-   * const rewards = await sdk.getTokenRewards(tokenAddress);
-   *
-   * // 4. Bid
+   * // 3. Bid (SDK auto-wraps WETH + approves if needed)
    * const result = await sdk.bidInAuction({
    *   poolKey: rewards.poolKey,
    *   zeroForOne: true,            // ETH → token
-   *   amountIn: parseEther("0.1"), // swap 0.1 ETH
+   *   amountIn: parseEther("0.1"), // swap 0.1 ETH (pulled from WETH balance)
    *   amountOutMinimum: 0n,        // set slippage
    *   round: state.round,
    *   bidAmount: parseEther("0.01"),
@@ -1657,6 +1665,44 @@ var LiquidSDK = class {
     if (!this.walletClient?.account) {
       throw new Error("walletClient with account required for bidInAuction");
     }
+    const account = this.walletClient.account;
+    const weth = EXTERNAL.WETH;
+    const wethBalance = await this.publicClient.readContract({
+      address: weth,
+      abi: ERC20Abi,
+      functionName: "balanceOf",
+      args: [account.address]
+    });
+    if (wethBalance < params.amountIn) {
+      const wrapAmount = params.amountIn - wethBalance;
+      const wrapTx = await this.walletClient.writeContract({
+        address: weth,
+        abi: [{ type: "function", name: "deposit", inputs: [], outputs: [], stateMutability: "payable" }],
+        functionName: "deposit",
+        args: [],
+        value: wrapAmount,
+        chain: import_chains2.base,
+        account
+      });
+      await this.publicClient.waitForTransactionReceipt({ hash: wrapTx });
+    }
+    const allowance = await this.publicClient.readContract({
+      address: weth,
+      abi: ERC20Abi,
+      functionName: "allowance",
+      args: [account.address, ADDRESSES.SNIPER_UTIL_V2]
+    });
+    if (allowance < params.amountIn) {
+      const approveTx = await this.walletClient.writeContract({
+        address: weth,
+        abi: ERC20Abi,
+        functionName: "approve",
+        args: [ADDRESSES.SNIPER_UTIL_V2, params.amountIn * 10n],
+        chain: import_chains2.base,
+        account
+      });
+      await this.publicClient.waitForTransactionReceipt({ hash: approveTx });
+    }
     const hookData = (0, import_viem2.encodeAbiParameters)(
       [
         {
@@ -1693,8 +1739,10 @@ var LiquidSDK = class {
       ],
       value: params.bidAmount,
       chain: import_chains2.base,
-      account: this.walletClient.account,
-      maxFeePerGas
+      account,
+      gas: 500000n,
+      maxFeePerGas,
+      maxPriorityFeePerGas: maxFeePerGas
     });
     return { txHash };
   }