liquid-sdk 1.7.3 → 1.7.5

package/llms.txt

@@ -30,7 +30,7 @@ console.log(result.tokenAddress);
 Liquid Protocol deploys ERC-20 tokens on Base (chain 8453) with:
 - Uniswap V4 liquidity pools (created automatically)
 - Locked LP with configurable reward splits
-- MEV protection (sniper auction or block delay)
+- MEV protection (sniper auction with descending fees)
 - Optional extensions: dev buy, vault lockup/vesting, merkle airdrops
 
 Every token gets 100 billion supply (18 decimals), a Uniswap V4 pool, and locked liquidity.
@@ -42,9 +42,9 @@ Every token gets 100 billion supply (18 decimals), a Uniswap V4 pool, and locked
 - `sdk.buildDevBuyExtension(devBuy)` — Build extension config for buying tokens at launch
 
 ### Fee Management
-- `sdk.getAvailableFees(feeOwner, feeToken?)` — Total unlocked fees (bigint, defaults to WETH)
-- `sdk.getFeesToClaim(feeOwner, feeToken?)` — Claimable fees right now (bigint, defaults to WETH)
-- `sdk.claimFees(feeOwner, feeToken?)` — Claim fees (returns txHash, defaults to WETH)
+- `sdk.getAvailableFees(feeOwner, tokenAddress)` — Total unlocked fees (bigint)
+- `sdk.getFeesToClaim(feeOwner, tokenAddress)` — Claimable fees right now (bigint)
+- `sdk.claimFees(feeOwner, tokenAddress)` — Claim fees (returns txHash)
 
 ### LP Reward Management
 - `sdk.getTokenRewards(tokenAddress)` — Reward config (recipients, bps, admins, poolKey)
@@ -86,8 +86,8 @@ Every token gets 100 billion supply (18 decimals), a Uniswap V4 pool, and locked
 - `sdk.getAuctionMaxRounds()` — Max auction rounds
 - `sdk.getAuctionGasPriceForBid(gasPeg, bidAmount)` — Calculate gas price for bid
 
-### MEV Protection
-- `sdk.getMevBlockDelay()` — Configured block delay
+### MEV Descending Fees
+- `sdk.getMevDescendingFeesBlockDelay()` — Configured block delay (also: `getMevBlockDelay()` deprecated alias)
 - `sdk.getPoolUnlockTime(poolId)` — When MEV lock expires (unix timestamp)
 
 ### Factory & Allowlist

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "liquid-sdk",
-  "version": "1.7.3",
+  "version": "1.7.5",
   "description": "TypeScript SDK to deploy ERC-20 tokens with Uniswap V4 liquidity on Base — zero API keys, one dependency (viem)",
   "author": "Liquid Protocol",
   "homepage": "https://github.com/Liquid-Protocol-Ops/SDK#readme",

package/skills/bid-in-auction.md

@@ -22,6 +22,8 @@ Sniper auction participation involves significant financial risk:
 
 7. **Smart contract risk**: The auction contracts are unaudited for this specific deployment. Bugs or misconfigurations could result in loss of funds.
 
+8. **Standing WETH approvals are dangerous**: A lingering WETH allowance to `SniperUtilV2` (`0x2B6cd5Be183c388Dd0074d53c52317df1414cd9f`) is the surface a "drain via standing approval" exploit targets — a sibling Clanker fork was drained this way in 2026-05. **As of this SDK version, `bidInAuction` approves only the exact `amountIn` per bid** (no multiplier), so each bid consumes the allowance fully and leaves zero residual. If you bid through an older SDK that approved a multiplier, **revoke your WETH allowance to `SniperUtilV2` before bidding again**. Never grant a max/unlimited WETH approval to these contracts.
+
 **As an agent, you MUST:**
 - Clearly present these risks to the user before their first auction bid
 - Ask for explicit confirmation (e.g., "I understand the risks of auction sniping and want to proceed")
@@ -98,7 +100,7 @@ Before bidding, understand these mechanics:
 - **`bidAmount`** (msg.value): ETH sent to the auction as your bid. Goes to protocol/LP.
 - **`amountIn`** (WETH transfer): The actual swap input. Pulled from your WETH balance via `transferFrom`. **This is separate from the bid.**
 
-The SDK **automatically wraps ETH → WETH and approves the SniperUtilV2** if your WETH balance or allowance is insufficient. You just need enough total ETH.
+The SDK **automatically wraps ETH → WETH and approves the SniperUtilV2 for the exact `amountIn`** (no multiplier — the bid's `transferFrom` consumes the full allowance, so nothing standing survives). You just need enough total ETH.
 
 ### Gas Price = Bid Encoding
 The bid amount is encoded in the transaction's gas price: `bidAmount = (tx.gasprice - gasPeg) × paymentPerGasUnit`. Both `maxFeePerGas` **and** `maxPriorityFeePerGas` must be set to the calculated value, otherwise Base's EIP-1559 will compute a lower effective gas price.
@@ -334,7 +336,7 @@ interface BidInAuctionResult {
 | Max rounds | 5 | Total auction rounds per token |
 | Blocks between auctions | 2 | Rounds occur every 2 blocks |
 | Blocks before first auction | 2 | First auction = deploy block + 2 |
-| Payment per gas unit | 0.0001 ETH (1e14 wei) | Converts gas delta to bid ETH |
+| Payment per gas unit | 0.0001 ETH (1e14 wei) | Converts gas delta to bid ETH. *May be set to 0 by the auction owner as a security mitigation — when 0, the required bid is also 0 (auctions function as a free gas-price race; the bid-payment path is neutered).* |
 | Starting fee | 800,000 (80%) | Fee at auction start |
 | Ending fee | 400,000 (40%) | Fee floor after decay |
 | Decay period | 20 seconds | Time for fee to decay from start to end |

package/skills/deploy-token.md

@@ -281,7 +281,7 @@ import { ADDRESSES, EXTERNAL } from "liquid-sdk";
 ADDRESSES.FACTORY                    // Token factory
 ADDRESSES.HOOK_STATIC_FEE_V2        // Default hook (1% buy + 1% sell)
 ADDRESSES.HOOK_DYNAMIC_FEE_V2       // Dynamic fee hook
-ADDRESSES.LP_LOCKER_FEE_CONVERSION  // Default locker (converts fees to WETH)
+ADDRESSES.LP_LOCKER_FEE_CONVERSION  // Default locker (converts fees to ETH)
 ADDRESSES.SNIPER_AUCTION_V2         // Default MEV module
 ADDRESSES.UNIV4_ETH_DEV_BUY         // Dev buy extension
 EXTERNAL.WETH                       // Base WETH

package/skills/index-tokens.md

@@ -261,8 +261,8 @@ console.log("Pool locked:", now < unlockTime);
 
 ```typescript
 // Check accrued fees
-const fees = await sdk.getAvailableFees(feeOwner);
-const claimable = await sdk.getFeesToClaim(feeOwner);
+const fees = await sdk.getAvailableFees(feeOwner, tokenAddress);
+const claimable = await sdk.getFeesToClaim(feeOwner, tokenAddress);
 console.log("Total fees:", fees);
 console.log("Claimable now:", claimable);
 ```

package/skills/sdk-overview.md

@@ -7,7 +7,7 @@ You are an AI agent working with the `liquid-sdk` package. This file gives you a
 Liquid Protocol deploys ERC-20 tokens on Base (chain ID 8453) with:
 - **Uniswap V4 pools** created and funded automatically
 - **Permanently locked LP** — liquidity cannot be rugged
-- **Configurable fee splits** — reward recipients earn LP fees in WETH
+- **Configurable fee splits** — reward recipients earn LP fees in ETH
 - **MEV protection** — sniper auction prices early trading activity
 - **Extensions** — dev buy, vault lockup/vesting, merkle airdrops
 
@@ -26,7 +26,7 @@ npm install liquid-sdk viem
 | **Deploy** | Launch tokens with custom fees, positions, reward splits, dev buys |
 | **Snipe** | Bid in MEV auctions for early access to new tokens |
 | **Index** | Discover all tokens, query by deployer, paginate by block range |
-| **Fees** | Check and claim accumulated LP fees (converted to WETH) |
+| **Fees** | Check and claim accumulated LP fees (converted to ETH) |
 | **Rewards** | Collect LP rewards, update reward recipients |
 | **Vault** | Check vesting schedules, claim unlocked tokens |
 | **Airdrop** | Check allocations, claim with merkle proofs |
@@ -225,7 +225,7 @@ await sdk.collectRewards(tokenAddress);
 - `rewardBps` must sum to 10000 (100%)
 - BPS splits are **immutable** after deployment — only recipient addresses can change
 - Each admin can only update the recipient at their own index
-- All fees are converted to WETH before distribution (default `FeePreference.Paired`)
+- All fees are converted to ETH before distribution (default `FeePreference.Paired`)
 
 ### Dev Buy (buy tokens at launch)
 
@@ -296,16 +296,16 @@ await sdk.claimAirdrop(tokenAddress, recipientAddress, allocatedAmount, merklePr
 
 ### Fee Claims
 
-LP fees accrue from trading activity. The LP Locker Fee Conversion contract converts all fees to WETH before distributing.
+LP fees accrue from trading activity. The LP Locker Fee Conversion contract converts all fees to ETH before distributing.
 
 ```typescript
 // Check fees
-const available = await sdk.getAvailableFees(ownerAddress);  // total unlocked
-const claimable = await sdk.getFeesToClaim(ownerAddress);    // ready to claim
+const available = await sdk.getAvailableFees(ownerAddress, tokenAddress);  // total unlocked
+const claimable = await sdk.getFeesToClaim(ownerAddress, tokenAddress);    // ready to claim
 
 // Claim
 if (claimable > 0n) {
-  await sdk.claimFees(ownerAddress);
+  await sdk.claimFees(ownerAddress, tokenAddress);
 }
 ```
 
@@ -358,7 +358,7 @@ import { ADDRESSES, EXTERNAL, FEE, TOKEN, DEFAULTS, POOL_POSITIONS } from "liqui
 // Key addresses
 ADDRESSES.FACTORY                    // Token factory
 ADDRESSES.HOOK_STATIC_FEE_V2        // Default hook (1% both ways)
-ADDRESSES.LP_LOCKER_FEE_CONVERSION  // Default locker (fees → WETH)
+ADDRESSES.LP_LOCKER_FEE_CONVERSION  // Default locker (fees → ETH)
 ADDRESSES.SNIPER_AUCTION_V2         // Default MEV module
 
 // Fee constants