liquid-sdk 1.6.1 → 1.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "liquid-sdk",
3
- "version": "1.6.1",
3
+ "version": "1.6.2",
4
4
  "description": "TypeScript SDK to deploy ERC-20 tokens with Uniswap V4 liquidity on Base — zero API keys, one dependency (viem)",
5
5
  "author": "Liquid Protocol",
6
6
  "homepage": "https://github.com/Liquid-Protocol-Ops/SDK#readme",
@@ -29,6 +29,30 @@ Sniper auction participation involves significant financial risk:
29
29
  - Display the fee percentage and total cost (bid + swap + fees) before execution
30
30
  - Recommend small amounts for initial bids until the user understands the mechanics
31
31
 
32
+ ## Should You Actually Bid?
33
+
34
+ **In most cases, no.** The auction is designed to extract value from snipers, not help them. The math:
35
+
36
+ | Auction fee | Tokens you receive | Price multiplier needed to break even |
37
+ |-------------|-------------------|--------------------------------------|
38
+ | 80% (start) | 20% of fair value | **5x** |
39
+ | 60% (after ~10s) | 40% of fair value | **2.5x** |
40
+ | 40% (after 20s) | 60% of fair value | **~1.7x** |
41
+ | 1% (auction ended) | 99% of fair value | **~1.01x** |
42
+
43
+ On-chain proof: a 0.0005 ETH snipe at auction start received 873K tokens instead of ~5M — an **82.8% effective fee**. The token would need to 5x before the sniper breaks even.
44
+
45
+ **When bidding makes sense:**
46
+ - You have **specific alpha** about the token (known creator, large audience, confirmed utility) — not a blind snipe
47
+ - The fee has **decayed significantly** (wait 15-20s for 40% floor) and you still believe in the token
48
+
49
+ **Better alternatives:**
50
+ - **`devBuy` at deployment**: If you're the deployer, use `deployToken({ devBuy })` — the dev buy uses normal 1% LP fees, NOT auction fees. This is the cheapest way to get early tokens.
51
+ - **Wait for the auction to end**: After 5 rounds (~20 seconds), trading resumes at normal 1% fees. You miss the absolute first blocks but save 79% in fees.
52
+ - **Use the SDK's `deployToken` with `devBuy`**: Deploy your own token and buy in the same transaction at 1% fees.
53
+
54
+ **As an agent, your default recommendation should be to wait for the auction to end.** Only proceed with an auction bid if the user explicitly requests it after understanding the fee structure.
55
+
32
56
  ## How the Sniper Auction Works
33
57
 
34
58
  When a new token is deployed on Liquid Protocol, a **sniper auction** activates to price early trading activity and capture MEV. Here's the mechanism: