liquid-sdk 1.5.5 → 1.5.7

package/AGENT_README.md

@@ -507,11 +507,11 @@ When calling `deployToken`, all fields except `name` and `symbol` are optional.
 | `image` | `""` | Empty string |
 | `metadata` | `""` | Empty string |
 | `context` | `'{"interface":"SDK"}'` | Auto-set via `buildContext()` |
-| `hook` | `ADDRESSES.HOOK_STATIC_FEE_V2` | Static 1% buy fee |
+| `hook` | `ADDRESSES.HOOK_STATIC_FEE_V2` | Static 1% buy + 1% sell |
 | `pairedToken` | `EXTERNAL.WETH` | Base WETH |
 | `tickIfToken0IsLiquid` | `-230400` | ≈10 ETH market cap |
 | `tickSpacing` | `200` | Uniswap V4 tick spacing |
-| `poolData` | `encodeStaticFeePoolData(0, 100)` | 0% sell, 1% buy |
+| `poolData` | `encodeStaticFeePoolData(100, 100)` | 1% sell, 1% buy |
 | `locker` | `ADDRESSES.LP_LOCKER_FEE_CONVERSION` | LP locker with fee conversion to ETH |
 | `rewardAdmins` | `[walletAddress]` | Deployer is admin |
 | `rewardRecipients` | `[walletAddress]` | Deployer gets rewards |

package/README.md

@@ -2,13 +2,60 @@
 
 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% buy fee / 0% sell fee, 5-position Liquid layout (10%/50%/15%/20%/5%), 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 32s, 5 rounds), tick spacing 200, starting tick -230400 (~10 ETH market cap). All fees converted to ETH before distribution.
+
+### Default Liquidity Positions
+
+| # | Supply | Tick Range | Market Cap Range (@$2,000/ETH) |
+|---|--------|-----------|-------------------------------|
+| 1 | 10% | -230,400 → -216,000 | ~$20K → ~$83K |
+| 2 | 50% | -216,000 → -155,000 | ~$83K → ~$37M |
+| 3 | 15% | -202,000 → -155,000 | ~$338K → ~$37M |
+| 4 | 20% | -155,000 → -120,000 | ~$37M → ~$1.2B |
+| 5 | 5% | -141,000 → -120,000 | ~$151M → ~$1.2B |
 
 ## Quick Start
 
@@ -153,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);
 ```
@@ -166,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

@@ -429,7 +429,7 @@ declare const POOL_POSITIONS: {
 /**
  * Liquid protocol defaults.
  *
- * - Hook: Static fee V2, 1% on buys only (fees in ETH), 0% on sells
+ * - Hook: Static fee V2, 1% on both buys and sells
  * - MEV: Sniper Auction V2 — 80% → 40% decaying over 32 seconds
  * - Tick spacing: 200
  * - Starting tick: -230400 (≈10 ETH market cap)
@@ -441,10 +441,10 @@ declare const DEFAULTS: {
     readonly LOCKER: `0x${string}`;
     readonly TICK_SPACING: 200;
     readonly TICK_IF_TOKEN0_IS_LIQUID: -230400;
-    /** Static fee on buys (ETH → token): 1% (100 bps). Fees collected in ETH. */
+    /** Static fee on buys (ETH → token): 1% (100 bps) */
     readonly PAIRED_FEE_BPS: 100;
-    /** Static fee on sells (token → ETH): 0%. No fees in liquid token. */
-    readonly LIQUID_FEE_BPS: 0;
+    /** Static fee on sells (token → ETH): 1% (100 bps) */
+    readonly LIQUID_FEE_BPS: 100;
     /** MEV module: Sniper Auction V2 */
     readonly MEV_MODULE: `0x${string}`;
     /** Sniper auction starting fee: 80% (800,000 uniBps) */

package/dist/index.d.ts

@@ -429,7 +429,7 @@ declare const POOL_POSITIONS: {
 /**
  * Liquid protocol defaults.
  *
- * - Hook: Static fee V2, 1% on buys only (fees in ETH), 0% on sells
+ * - Hook: Static fee V2, 1% on both buys and sells
  * - MEV: Sniper Auction V2 — 80% → 40% decaying over 32 seconds
  * - Tick spacing: 200
  * - Starting tick: -230400 (≈10 ETH market cap)
@@ -441,10 +441,10 @@ declare const DEFAULTS: {
     readonly LOCKER: `0x${string}`;
     readonly TICK_SPACING: 200;
     readonly TICK_IF_TOKEN0_IS_LIQUID: -230400;
-    /** Static fee on buys (ETH → token): 1% (100 bps). Fees collected in ETH. */
+    /** Static fee on buys (ETH → token): 1% (100 bps) */
     readonly PAIRED_FEE_BPS: 100;
-    /** Static fee on sells (token → ETH): 0%. No fees in liquid token. */
-    readonly LIQUID_FEE_BPS: 0;
+    /** Static fee on sells (token → ETH): 1% (100 bps) */
+    readonly LIQUID_FEE_BPS: 100;
     /** MEV module: Sniper Auction V2 */
     readonly MEV_MODULE: `0x${string}`;
     /** Sniper auction starting fee: 80% (800,000 uniBps) */

package/dist/index.js

@@ -164,10 +164,10 @@ var DEFAULTS = {
   LOCKER: ADDRESSES.LP_LOCKER_FEE_CONVERSION,
   TICK_SPACING: 200,
   TICK_IF_TOKEN0_IS_LIQUID: -230400,
-  /** Static fee on buys (ETH → token): 1% (100 bps). Fees collected in ETH. */
+  /** Static fee on buys (ETH → token): 1% (100 bps) */
   PAIRED_FEE_BPS: 100,
-  /** Static fee on sells (token → ETH): 0%. No fees in liquid token. */
-  LIQUID_FEE_BPS: 0,
+  /** Static fee on sells (token → ETH): 1% (100 bps) */
+  LIQUID_FEE_BPS: 100,
   /** MEV module: Sniper Auction V2 */
   MEV_MODULE: ADDRESSES.SNIPER_AUCTION_V2,
   /** Sniper auction starting fee: 80% (800,000 uniBps) */