liquid-sdk 1.5.2 → 1.5.3

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 };
   }