liquid-sdk 1.4.0 → 1.5.0

package/dist/index.d.mts

@@ -197,6 +197,23 @@ interface LiquidSDKConfig {
     publicClient?: any;
     walletClient?: any;
 }
+interface BidInAuctionParams {
+    /** The pool key identifying the token's Uniswap V4 pool */
+    poolKey: PoolKey;
+    /** True if swapping token0 → token1 (typically ETH → token) */
+    zeroForOne: boolean;
+    /** Amount of input token (in wei) */
+    amountIn: bigint;
+    /** Minimum output tokens to receive (slippage protection) */
+    amountOutMinimum: bigint;
+    /** The auction round to bid in (must match current round on-chain) */
+    round: bigint;
+    /** ETH bid amount — sent as msg.value, must equal (gasPrice - gasPeg) × paymentPerGasUnit */
+    bidAmount: bigint;
+}
+interface BidInAuctionResult {
+    txHash: Hash;
+}
 interface DeployTokenResult {
     tokenAddress: Address;
     txHash: Hash;
@@ -244,6 +261,35 @@ declare class LiquidSDK {
     getAuctionDecayStartTime(poolId: Hex): Promise<bigint>;
     getAuctionMaxRounds(): Promise<bigint>;
     getAuctionGasPriceForBid(auctionGasPeg: bigint, desiredBidAmount: bigint): Promise<bigint>;
+    /**
+     * Bid in a sniper auction for early access to a newly launched token.
+     *
+     * The auction lets bidders compete via gas price — the bid amount is
+     * determined by how much your tx.gasprice exceeds the pool's gasPeg.
+     *
+     * @example
+     * ```typescript
+     * // 1. Get auction state
+     * const state = await sdk.getAuctionState(poolId);
+     *
+     * // 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
+     * const result = await sdk.bidInAuction({
+     *   poolKey: rewards.poolKey,
+     *   zeroForOne: true,            // ETH → token
+     *   amountIn: parseEther("0.1"), // swap 0.1 ETH
+     *   amountOutMinimum: 0n,        // set slippage
+     *   round: state.round,
+     *   bidAmount: parseEther("0.01"),
+     * }, gasPrice);
+     * ```
+     */
+    bidInAuction(params: BidInAuctionParams, maxFeePerGas: bigint): Promise<BidInAuctionResult>;
     getAirdropInfo(tokenAddress: Address): Promise<AirdropInfo>;
     getAirdropClaimable(tokenAddress: Address, recipient: Address, allocatedAmount: bigint): Promise<bigint>;
     claimAirdrop(tokenAddress: Address, recipient: Address, allocatedAmount: bigint, proof: Hex[]): Promise<Hash>;
@@ -362,7 +408,7 @@ interface PoolPosition {
 declare const POOL_POSITIONS: {
     /** Single position, 100% of liquidity in one range */
     readonly Standard: PoolPosition[];
-    /** 3-tranche Liquid default (hardcoded for ~10 ETH start, ~$2070/ETH) */
+    /** 5-position layout with concentrated mid-range liquidity */
     readonly Liquid: PoolPosition[];
 };
 /**
@@ -2421,4 +2467,4 @@ declare function parseContext(contextString: string): LiquidContext | null;
  */
 declare function parseMetadata(metadataString: string): LiquidMetadata | null;
 
-export { ADDRESSES, type AirdropInfo, DEFAULTS, DEFAULT_CHAIN, DEFAULT_CHAIN_ID, DEFAULT_RPC_URL, DEFAULT_TRANCHES_USD, type DeployTokenParams, type DeployTokenResult, type DeploymentConfig, type DeploymentInfo, type DevBuyParams, type DynamicFeeConfig, ERC20Abi, EXTERNAL, type ExtensionConfig, FEE, FeePreference, type GetTokensOptions, LiquidAirdropV2Abi, type LiquidContext, LiquidFactoryAbi, LiquidFeeLockerAbi, LiquidHookDynamicFeeV2Abi, LiquidLpLockerAbi, type LiquidMetadata, LiquidMevBlockDelayAbi, LiquidPoolExtensionAllowlistAbi, LiquidSDK, type LiquidSDKConfig, LiquidSniperAuctionV2Abi, LiquidSniperUtilV2Abi, LiquidTokenAbi, LiquidUniv4EthDevBuyAbi, LiquidVaultAbi, type LockerConfig, type MarketCapTranche, type MarketCapTrancheUSD, type MevModuleConfig, POOL_POSITIONS, type PoolConfig, type PoolDynamicConfigVars, type PoolDynamicFeeVars, type PoolKey, type PoolPosition, type PositionArrays, type PositionConfig, type SniperAuctionConfig, type SniperAuctionFeeConfig, type SniperAuctionState, type SocialMediaUrl, TOKEN, type TokenConfig, type TokenCreatedEvent, type TokenRewardInfo, type VaultAllocation, buildContext, buildMetadata, createDefaultPositions, createPositions, createPositionsUSD, describePositions, encodeDynamicFeePoolData, encodeFeeConversionLockerData, encodeSniperAuctionData, encodeStaticFeePoolData, getTickFromMarketCapETH, getTickFromMarketCapStable, getTickFromMarketCapUSD, marketCapFromTickETH, marketCapFromTickUSD, parseContext, parseMetadata };
+export { ADDRESSES, type AirdropInfo, type BidInAuctionParams, type BidInAuctionResult, DEFAULTS, DEFAULT_CHAIN, DEFAULT_CHAIN_ID, DEFAULT_RPC_URL, DEFAULT_TRANCHES_USD, type DeployTokenParams, type DeployTokenResult, type DeploymentConfig, type DeploymentInfo, type DevBuyParams, type DynamicFeeConfig, ERC20Abi, EXTERNAL, type ExtensionConfig, FEE, FeePreference, type GetTokensOptions, LiquidAirdropV2Abi, type LiquidContext, LiquidFactoryAbi, LiquidFeeLockerAbi, LiquidHookDynamicFeeV2Abi, LiquidLpLockerAbi, type LiquidMetadata, LiquidMevBlockDelayAbi, LiquidPoolExtensionAllowlistAbi, LiquidSDK, type LiquidSDKConfig, LiquidSniperAuctionV2Abi, LiquidSniperUtilV2Abi, LiquidTokenAbi, LiquidUniv4EthDevBuyAbi, LiquidVaultAbi, type LockerConfig, type MarketCapTranche, type MarketCapTrancheUSD, type MevModuleConfig, POOL_POSITIONS, type PoolConfig, type PoolDynamicConfigVars, type PoolDynamicFeeVars, type PoolKey, type PoolPosition, type PositionArrays, type PositionConfig, type SniperAuctionConfig, type SniperAuctionFeeConfig, type SniperAuctionState, type SocialMediaUrl, TOKEN, type TokenConfig, type TokenCreatedEvent, type TokenRewardInfo, type VaultAllocation, buildContext, buildMetadata, createDefaultPositions, createPositions, createPositionsUSD, describePositions, encodeDynamicFeePoolData, encodeFeeConversionLockerData, encodeSniperAuctionData, encodeStaticFeePoolData, getTickFromMarketCapETH, getTickFromMarketCapStable, getTickFromMarketCapUSD, marketCapFromTickETH, marketCapFromTickUSD, parseContext, parseMetadata };

package/dist/index.d.ts

@@ -197,6 +197,23 @@ interface LiquidSDKConfig {
     publicClient?: any;
     walletClient?: any;
 }
+interface BidInAuctionParams {
+    /** The pool key identifying the token's Uniswap V4 pool */
+    poolKey: PoolKey;
+    /** True if swapping token0 → token1 (typically ETH → token) */
+    zeroForOne: boolean;
+    /** Amount of input token (in wei) */
+    amountIn: bigint;
+    /** Minimum output tokens to receive (slippage protection) */
+    amountOutMinimum: bigint;
+    /** The auction round to bid in (must match current round on-chain) */
+    round: bigint;
+    /** ETH bid amount — sent as msg.value, must equal (gasPrice - gasPeg) × paymentPerGasUnit */
+    bidAmount: bigint;
+}
+interface BidInAuctionResult {
+    txHash: Hash;
+}
 interface DeployTokenResult {
     tokenAddress: Address;
     txHash: Hash;
@@ -244,6 +261,35 @@ declare class LiquidSDK {
     getAuctionDecayStartTime(poolId: Hex): Promise<bigint>;
     getAuctionMaxRounds(): Promise<bigint>;
     getAuctionGasPriceForBid(auctionGasPeg: bigint, desiredBidAmount: bigint): Promise<bigint>;
+    /**
+     * Bid in a sniper auction for early access to a newly launched token.
+     *
+     * The auction lets bidders compete via gas price — the bid amount is
+     * determined by how much your tx.gasprice exceeds the pool's gasPeg.
+     *
+     * @example
+     * ```typescript
+     * // 1. Get auction state
+     * const state = await sdk.getAuctionState(poolId);
+     *
+     * // 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
+     * const result = await sdk.bidInAuction({
+     *   poolKey: rewards.poolKey,
+     *   zeroForOne: true,            // ETH → token
+     *   amountIn: parseEther("0.1"), // swap 0.1 ETH
+     *   amountOutMinimum: 0n,        // set slippage
+     *   round: state.round,
+     *   bidAmount: parseEther("0.01"),
+     * }, gasPrice);
+     * ```
+     */
+    bidInAuction(params: BidInAuctionParams, maxFeePerGas: bigint): Promise<BidInAuctionResult>;
     getAirdropInfo(tokenAddress: Address): Promise<AirdropInfo>;
     getAirdropClaimable(tokenAddress: Address, recipient: Address, allocatedAmount: bigint): Promise<bigint>;
     claimAirdrop(tokenAddress: Address, recipient: Address, allocatedAmount: bigint, proof: Hex[]): Promise<Hash>;
@@ -362,7 +408,7 @@ interface PoolPosition {
 declare const POOL_POSITIONS: {
     /** Single position, 100% of liquidity in one range */
     readonly Standard: PoolPosition[];
-    /** 3-tranche Liquid default (hardcoded for ~10 ETH start, ~$2070/ETH) */
+    /** 5-position layout with concentrated mid-range liquidity */
     readonly Liquid: PoolPosition[];
 };
 /**
@@ -2421,4 +2467,4 @@ declare function parseContext(contextString: string): LiquidContext | null;
  */
 declare function parseMetadata(metadataString: string): LiquidMetadata | null;
 
-export { ADDRESSES, type AirdropInfo, DEFAULTS, DEFAULT_CHAIN, DEFAULT_CHAIN_ID, DEFAULT_RPC_URL, DEFAULT_TRANCHES_USD, type DeployTokenParams, type DeployTokenResult, type DeploymentConfig, type DeploymentInfo, type DevBuyParams, type DynamicFeeConfig, ERC20Abi, EXTERNAL, type ExtensionConfig, FEE, FeePreference, type GetTokensOptions, LiquidAirdropV2Abi, type LiquidContext, LiquidFactoryAbi, LiquidFeeLockerAbi, LiquidHookDynamicFeeV2Abi, LiquidLpLockerAbi, type LiquidMetadata, LiquidMevBlockDelayAbi, LiquidPoolExtensionAllowlistAbi, LiquidSDK, type LiquidSDKConfig, LiquidSniperAuctionV2Abi, LiquidSniperUtilV2Abi, LiquidTokenAbi, LiquidUniv4EthDevBuyAbi, LiquidVaultAbi, type LockerConfig, type MarketCapTranche, type MarketCapTrancheUSD, type MevModuleConfig, POOL_POSITIONS, type PoolConfig, type PoolDynamicConfigVars, type PoolDynamicFeeVars, type PoolKey, type PoolPosition, type PositionArrays, type PositionConfig, type SniperAuctionConfig, type SniperAuctionFeeConfig, type SniperAuctionState, type SocialMediaUrl, TOKEN, type TokenConfig, type TokenCreatedEvent, type TokenRewardInfo, type VaultAllocation, buildContext, buildMetadata, createDefaultPositions, createPositions, createPositionsUSD, describePositions, encodeDynamicFeePoolData, encodeFeeConversionLockerData, encodeSniperAuctionData, encodeStaticFeePoolData, getTickFromMarketCapETH, getTickFromMarketCapStable, getTickFromMarketCapUSD, marketCapFromTickETH, marketCapFromTickUSD, parseContext, parseMetadata };
+export { ADDRESSES, type AirdropInfo, type BidInAuctionParams, type BidInAuctionResult, DEFAULTS, DEFAULT_CHAIN, DEFAULT_CHAIN_ID, DEFAULT_RPC_URL, DEFAULT_TRANCHES_USD, type DeployTokenParams, type DeployTokenResult, type DeploymentConfig, type DeploymentInfo, type DevBuyParams, type DynamicFeeConfig, ERC20Abi, EXTERNAL, type ExtensionConfig, FEE, FeePreference, type GetTokensOptions, LiquidAirdropV2Abi, type LiquidContext, LiquidFactoryAbi, LiquidFeeLockerAbi, LiquidHookDynamicFeeV2Abi, LiquidLpLockerAbi, type LiquidMetadata, LiquidMevBlockDelayAbi, LiquidPoolExtensionAllowlistAbi, LiquidSDK, type LiquidSDKConfig, LiquidSniperAuctionV2Abi, LiquidSniperUtilV2Abi, LiquidTokenAbi, LiquidUniv4EthDevBuyAbi, LiquidVaultAbi, type LockerConfig, type MarketCapTranche, type MarketCapTrancheUSD, type MevModuleConfig, POOL_POSITIONS, type PoolConfig, type PoolDynamicConfigVars, type PoolDynamicFeeVars, type PoolKey, type PoolPosition, type PositionArrays, type PositionConfig, type SniperAuctionConfig, type SniperAuctionFeeConfig, type SniperAuctionState, type SocialMediaUrl, TOKEN, type TokenConfig, type TokenCreatedEvent, type TokenRewardInfo, type VaultAllocation, buildContext, buildMetadata, createDefaultPositions, createPositions, createPositionsUSD, describePositions, encodeDynamicFeePoolData, encodeFeeConversionLockerData, encodeSniperAuctionData, encodeStaticFeePoolData, getTickFromMarketCapETH, getTickFromMarketCapStable, getTickFromMarketCapUSD, marketCapFromTickETH, marketCapFromTickUSD, parseContext, parseMetadata };

package/dist/index.js

@@ -124,31 +124,37 @@ var POOL_POSITIONS = {
       positionBps: 1e4
     }
   ],
-  /** 3-tranche Liquid default (hardcoded for ~10 ETH start, ~$2070/ETH) */
+  /** 5-position layout with concentrated mid-range liquidity */
   Liquid: [
     {
       tickLower: -230400,
-      // ~$20K starting
-      tickUpper: -198600,
-      // ~$500K
-      positionBps: 4e3
-      // 40%
+      tickUpper: -216e3,
+      positionBps: 1e3
+      // 10%
     },
     {
-      tickLower: -198600,
-      // ~$500K
-      tickUpper: -168600,
-      // ~$10M
+      tickLower: -216e3,
+      tickUpper: -155e3,
       positionBps: 5e3
       // 50%
     },
     {
-      tickLower: -168600,
-      // ~$10M
-      tickUpper: -122600,
-      // ~$1B
-      positionBps: 1e3
-      // 10%
+      tickLower: -202e3,
+      tickUpper: -155e3,
+      positionBps: 1500
+      // 15%
+    },
+    {
+      tickLower: -155e3,
+      tickUpper: -12e4,
+      positionBps: 2e3
+      // 20%
+    },
+    {
+      tickLower: -141e3,
+      tickUpper: -12e4,
+      positionBps: 500
+      // 5%
     }
   ]
 };
@@ -1619,6 +1625,79 @@ var LiquidSDK = class {
       args: [auctionGasPeg, desiredBidAmount]
     });
   }
+  /**
+   * Bid in a sniper auction for early access to a newly launched token.
+   *
+   * The auction lets bidders compete via gas price — the bid amount is
+   * determined by how much your tx.gasprice exceeds the pool's gasPeg.
+   *
+   * @example
+   * ```typescript
+   * // 1. Get auction state
+   * const state = await sdk.getAuctionState(poolId);
+   *
+   * // 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
+   * const result = await sdk.bidInAuction({
+   *   poolKey: rewards.poolKey,
+   *   zeroForOne: true,            // ETH → token
+   *   amountIn: parseEther("0.1"), // swap 0.1 ETH
+   *   amountOutMinimum: 0n,        // set slippage
+   *   round: state.round,
+   *   bidAmount: parseEther("0.01"),
+   * }, gasPrice);
+   * ```
+   */
+  async bidInAuction(params, maxFeePerGas) {
+    if (!this.walletClient?.account) {
+      throw new Error("walletClient with account required for bidInAuction");
+    }
+    const hookData = (0, import_viem2.encodeAbiParameters)(
+      [
+        {
+          type: "tuple",
+          components: [
+            { type: "bytes", name: "mevModuleSwapData" },
+            { type: "bytes", name: "poolExtensionSwapData" }
+          ]
+        }
+      ],
+      [
+        {
+          mevModuleSwapData: (0, import_viem2.encodeAbiParameters)(
+            [{ type: "address" }],
+            [ADDRESSES.SNIPER_UTIL_V2]
+          ),
+          poolExtensionSwapData: "0x"
+        }
+      ]
+    );
+    const txHash = await this.walletClient.writeContract({
+      address: ADDRESSES.SNIPER_UTIL_V2,
+      abi: LiquidSniperUtilV2Abi,
+      functionName: "bidInAuction",
+      args: [
+        {
+          poolKey: params.poolKey,
+          zeroForOne: params.zeroForOne,
+          amountIn: params.amountIn,
+          amountOutMinimum: params.amountOutMinimum,
+          hookData
+        },
+        params.round
+      ],
+      value: params.bidAmount,
+      chain: import_chains2.base,
+      account: this.walletClient.account,
+      maxFeePerGas
+    });
+    return { txHash };
+  }
   // ── Airdrop ─────────────────────────────────────────────────────────
   async getAirdropInfo(tokenAddress) {
     const result = await this.publicClient.readContract({