liquid-sdk 1.5.6 → 1.5.9

package/AGENT_README.md

@@ -519,7 +519,7 @@ When calling `deployToken`, all fields except `name` and `symbol` are optional.
 | `tickLower` | `[-230400, -198600, -168600]` | 3-tranche Liquid default |
 | `tickUpper` | `[-198600, -168600, -122600]` | 3-tranche Liquid default |
 | `positionBps` | `[4000, 5000, 1000]` | 40% / 50% / 10% |
-| `mevModule` | `ADDRESSES.SNIPER_AUCTION_V2` | 80%→40% over 32s |
+| `mevModule` | `ADDRESSES.SNIPER_AUCTION_V2` | 80%→40% over 20s |
 | `extensions` | `[]` | No extensions |
 
 ---

package/CHANGELOG.md

@@ -37,7 +37,7 @@ All notable changes to `liquid-sdk` will be documented in this file.
 ### Changed
 - Default hook switched to `HOOK_STATIC_FEE_V2` with proper two-layer pool data encoding
 - Default positions changed from single full-range to 3-tranche Liquid preset
-- Default MEV module switched to `SNIPER_AUCTION_V2` with 80%→40% decay over 32s
+- Default MEV module switched to `SNIPER_AUCTION_V2` with 80%→40% decay over 20s
 
 ## [1.0.0] - 2025-02-15
 

package/README.md

@@ -2,13 +2,50 @@
 
 TypeScript SDK for the Liquid Protocol token launcher on Base. Deploy tokens, manage pools, and claim fees using [viem](https://viem.sh).
 
+## Agent Skills
+
+The SDK ships with **agent skill files** — self-contained markdown guides that AI agents can load into their context to autonomously interact with Liquid Protocol on Base.
+
+| Skill | File | What it teaches |
+|-------|------|-----------------|
+| **Deploy Token** | `skills/deploy-token.md` | Full deployment workflows — minimal deploy, dev buy, custom fees, custom positions, reward splits, validation rules |
+| **Bid in Auction** | `skills/bid-in-auction.md` | MEV sniper auction — WETH handling, gas price encoding, block timing, automated sniper example |
+| **Index Tokens** | `skills/index-tokens.md` | Token discovery — bulk queries, single lookup, pagination, real-time monitoring, data enrichment |
+
+### Using Skills with Your Agent
+
+```python
+# Python — load a skill into your agent's context
+with open("node_modules/liquid-sdk/skills/deploy-token.md") as f:
+    agent.system_prompt += f.read()
+```
+
+```typescript
+// TypeScript — read skill for an MCP server or agent framework
+import { readFileSync } from "fs";
+const skill = readFileSync("node_modules/liquid-sdk/skills/bid-in-auction.md", "utf-8");
+```
+
+For Claude Code, reference skills in your `CLAUDE.md`:
+```
+For token deployment, follow the instructions in node_modules/liquid-sdk/skills/deploy-token.md
+```
+
+### Additional Agent Docs
+
+| File | Purpose |
+|------|---------|
+| `AGENT_README.md` | Complete API reference with every method, type, and default (700+ lines) |
+| `llms.txt` | Compact summary for LLM context windows |
+| `CLAUDE.md` | Agent guide with architecture, defaults, and invariants |
+
 ## Installation
 
 ```bash
 npm install liquid-sdk viem
 ```
 
-> **Defaults**: Static 1% fee (both buy and sell), 5-position Liquid layout, Sniper Auction MEV (80%→40% over 32s, 5 rounds), tick spacing 200, starting tick -230400 (~10 ETH market cap).
+> **Defaults**: Static 1% fee (both buy and sell), 5-position Liquid layout, Sniper Auction MEV (80%→40% over 20s, 5 rounds), tick spacing 200, starting tick -230400 (~10 ETH market cap). All fees converted to ETH before distribution.
 
 ### Default Liquidity Positions
 
@@ -163,7 +200,7 @@ console.log("Locker:", info.deployment.locker);
 const rewards = await liquid.getTokenRewards(tokenAddress);
 await liquid.collectRewards(tokenAddress);
 
-// Fee claims
+// Fee claims (all fees converted to ETH by default)
 const claimable = await liquid.getFeesToClaim(ownerAddress, tokenAddress);
 await liquid.claimFees(ownerAddress, tokenAddress);
 ```
@@ -176,43 +213,6 @@ const claimable = await liquid.getVaultClaimable(tokenAddress);
 await liquid.claimVault(tokenAddress);
 ```
 
-## Agent Skills
-
-The SDK ships with **agent skill files** — self-contained markdown guides that AI agents can load into their context to autonomously use the SDK. Find them in `node_modules/liquid-sdk/skills/` after install.
-
-| Skill | File | What it teaches |
-|-------|------|-----------------|
-| **Deploy Token** | `skills/deploy-token.md` | Full deployment workflows — minimal deploy, dev buy, custom fees, custom positions, reward splits, validation rules |
-| **Bid in Auction** | `skills/bid-in-auction.md` | MEV sniper auction — WETH handling, gas price encoding, block timing, automated sniper example |
-| **Index Tokens** | `skills/index-tokens.md` | Token discovery — bulk queries, single lookup, pagination, real-time monitoring, data enrichment |
-
-### Using Skills with Your Agent
-
-```python
-# Python — load a skill into your agent's context
-with open("node_modules/liquid-sdk/skills/deploy-token.md") as f:
-    agent.system_prompt += f.read()
-```
-
-```typescript
-// TypeScript — read skill for an MCP server or agent framework
-import { readFileSync } from "fs";
-const skill = readFileSync("node_modules/liquid-sdk/skills/bid-in-auction.md", "utf-8");
-```
-
-For Claude Code, reference skills in your `CLAUDE.md`:
-```
-For token deployment, follow the instructions in node_modules/liquid-sdk/skills/deploy-token.md
-```
-
-### Additional Agent Docs
-
-| File | Purpose |
-|------|---------|
-| `AGENT_README.md` | Complete API reference with every method, type, and default (700+ lines) |
-| `llms.txt` | Compact summary for LLM context windows |
-| `CLAUDE.md` | Agent guide with architecture, defaults, and invariants |
-
 ## Constants & ABIs
 
 All production addresses, fee parameters, and contract ABIs are exported:

package/dist/index.d.mts

@@ -89,7 +89,7 @@ interface DeployTokenParams {
     lockerData?: Hex;
     /** MEV module address. Defaults to SNIPER_AUCTION_V2 */
     mevModule?: Address;
-    /** MEV module data. Defaults to 80%→40% decay over 32s */
+    /** MEV module data. Defaults to 80%→40% decay over 20s */
     mevModuleData?: Hex;
     /** Extension configs (vault, airdrop, etc.) */
     extensions?: ExtensionConfig[];
@@ -430,7 +430,7 @@ declare const POOL_POSITIONS: {
  * Liquid protocol defaults.
  *
  * - Hook: Static fee V2, 1% on both buys and sells
- * - MEV: Sniper Auction V2 — 80% → 40% decaying over 32 seconds
+ * - MEV: Sniper Auction V2 — 80% → 40% decaying over 20 seconds
  * - Tick spacing: 200
  * - Starting tick: -230400 (≈10 ETH market cap)
  * - Positions: 3-tranche Liquid default (40/50/10)
@@ -451,8 +451,8 @@ declare const DEFAULTS: {
     readonly SNIPER_STARTING_FEE: 800000;
     /** Sniper auction ending fee: 40% (400,000 uniBps) */
     readonly SNIPER_ENDING_FEE: 400000;
-    /** Sniper auction decay period: 32 seconds */
-    readonly SNIPER_SECONDS_TO_DECAY: 32;
+    /** Sniper auction decay period: 20 seconds */
+    readonly SNIPER_SECONDS_TO_DECAY: 20;
 };
 declare const DEFAULT_CHAIN: {
     blockExplorers: {
@@ -2388,11 +2388,11 @@ interface SniperAuctionConfig {
  *
  * @example
  * ```ts
- * // 80% → 40% over 32 seconds (default)
+ * // 80% → 40% over 20 seconds (default)
  * const mevData = encodeSniperAuctionData({
  *   startingFee: 800_000,
  *   endingFee: 400_000,
- *   secondsToDecay: 32,
+ *   secondsToDecay: 20,
  * });
  * ```
  */

package/dist/index.d.ts

@@ -89,7 +89,7 @@ interface DeployTokenParams {
     lockerData?: Hex;
     /** MEV module address. Defaults to SNIPER_AUCTION_V2 */
     mevModule?: Address;
-    /** MEV module data. Defaults to 80%→40% decay over 32s */
+    /** MEV module data. Defaults to 80%→40% decay over 20s */
     mevModuleData?: Hex;
     /** Extension configs (vault, airdrop, etc.) */
     extensions?: ExtensionConfig[];
@@ -430,7 +430,7 @@ declare const POOL_POSITIONS: {
  * Liquid protocol defaults.
  *
  * - Hook: Static fee V2, 1% on both buys and sells
- * - MEV: Sniper Auction V2 — 80% → 40% decaying over 32 seconds
+ * - MEV: Sniper Auction V2 — 80% → 40% decaying over 20 seconds
  * - Tick spacing: 200
  * - Starting tick: -230400 (≈10 ETH market cap)
  * - Positions: 3-tranche Liquid default (40/50/10)
@@ -451,8 +451,8 @@ declare const DEFAULTS: {
     readonly SNIPER_STARTING_FEE: 800000;
     /** Sniper auction ending fee: 40% (400,000 uniBps) */
     readonly SNIPER_ENDING_FEE: 400000;
-    /** Sniper auction decay period: 32 seconds */
-    readonly SNIPER_SECONDS_TO_DECAY: 32;
+    /** Sniper auction decay period: 20 seconds */
+    readonly SNIPER_SECONDS_TO_DECAY: 20;
 };
 declare const DEFAULT_CHAIN: {
     blockExplorers: {
@@ -2388,11 +2388,11 @@ interface SniperAuctionConfig {
  *
  * @example
  * ```ts
- * // 80% → 40% over 32 seconds (default)
+ * // 80% → 40% over 20 seconds (default)
  * const mevData = encodeSniperAuctionData({
  *   startingFee: 800_000,
  *   endingFee: 400_000,
- *   secondsToDecay: 32,
+ *   secondsToDecay: 20,
  * });
  * ```
  */

package/dist/index.js

@@ -174,8 +174,8 @@ var DEFAULTS = {
   SNIPER_STARTING_FEE: 8e5,
   /** Sniper auction ending fee: 40% (400,000 uniBps) */
   SNIPER_ENDING_FEE: 4e5,
-  /** Sniper auction decay period: 32 seconds */
-  SNIPER_SECONDS_TO_DECAY: 32
+  /** Sniper auction decay period: 20 seconds */
+  SNIPER_SECONDS_TO_DECAY: 20
 };
 var DEFAULT_CHAIN = import_chains.base;
 var DEFAULT_CHAIN_ID = 8453;