liquid-sdk 1.5.2 → 1.5.4

package/AGENT_README.md

@@ -428,10 +428,31 @@ const maxRounds = await sdk.getAuctionMaxRounds();
 ```typescript
 const gasPrice = await sdk.getAuctionGasPriceForBid(
   auction.gasPeg,
-  parseEther("1"),  // desired bid
+  parseEther("0.001"),  // desired bid
 );
 ```
 
+#### `sdk.bidInAuction(params, gasPrice)` — Bid in auction and swap tokens
+
+Requires wallet. Auto-wraps ETH → WETH and approves SniperUtilV2 if needed. Sets gas manually (800K) and both `maxFeePerGas`/`maxPriorityFeePerGas` to the auction gas price.
+
+```typescript
+const rewards = await sdk.getTokenRewards(tokenAddress);
+const zeroForOne = rewards.poolKey.currency0.toLowerCase() === EXTERNAL.WETH.toLowerCase();
+
+const result = await sdk.bidInAuction({
+  poolKey: rewards.poolKey,
+  zeroForOne,                        // depends on token sort order vs WETH
+  amountIn: parseEther("0.001"),     // WETH to swap (auto-wrapped from ETH)
+  amountOutMinimum: 0n,              // set slippage in production
+  round: auction.round,              // must match current on-chain round
+  bidAmount: parseEther("0.0005"),   // ETH bid (sent as msg.value)
+}, gasPrice);
+// result.txHash — transaction hash
+```
+
+**Important:** The bid is valid only at `nextAuctionBlock`. Submit when `currentBlock === nextAuctionBlock - 1`. The `amountIn` is pulled from your WETH balance (separate from the bid's `msg.value`). Auction runs 5 rounds, every 2 blocks, starting 2 blocks after deployment.
+
 ---
 
 ### MEV Protection

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: 800000n,
+      maxFeePerGas,
+      maxPriorityFeePerGas: maxFeePerGas
     });
     return { txHash };
   }