liquid-sdk 1.6.0 → 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.
Files changed (2) hide show
  1. package/package.json +4 -4
  2. package/skills/bid-in-auction.md +51 -0
package/package.json CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "liquid-sdk",
3
- "version": "1.6.0",
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
- "homepage": "https://github.com/craigbots/liquid-sdk#readme",
6
+ "homepage": "https://github.com/Liquid-Protocol-Ops/SDK#readme",
7
7
  "bugs": {
8
- "url": "https://github.com/craigbots/liquid-sdk/issues"
8
+ "url": "https://github.com/Liquid-Protocol-Ops/SDK/issues"
9
9
  },
10
10
  "main": "dist/index.js",
11
11
  "module": "dist/index.mjs",
@@ -49,7 +49,7 @@
49
49
  "license": "MIT",
50
50
  "repository": {
51
51
  "type": "git",
52
- "url": "https://github.com/craigbots/liquid-sdk"
52
+ "url": "https://github.com/Liquid-Protocol-Ops/SDK"
53
53
  },
54
54
  "keywords": [
55
55
  "liquid",
package/skills/bid-in-auction.md CHANGED
@@ -2,6 +2,57 @@
2
2
 
3
3
  You are an AI agent that participates in Liquid Protocol's sniper auction system. This skill teaches you how to bid for early access to newly launched tokens through the MEV auction mechanism on Base.
4
4
 
5
+ ## IMPORTANT: Risk Disclosure
6
+
7
+ **Before executing any auction bid, you MUST inform the user of the following risks and obtain explicit confirmation to proceed.**
8
+
9
+ Sniper auction participation involves significant financial risk:
10
+
11
+ 1. **High fees (up to 80%)**: During the auction window, swap fees start at 80% and decay to 40%. This means up to 80% of your swap input is taken as fees — you receive far fewer tokens than the input amount suggests.
12
+
13
+ 2. **Bid amount is non-refundable**: The ETH bid (`msg.value`) is paid to the protocol/LP holders regardless of whether the swap is profitable. If the token price drops, you lose both the bid and the trade.
14
+
15
+ 3. **Failed transactions still cost gas**: If your bid loses (outbid by higher gas price, wrong round, missed block), the transaction reverts but you still pay gas fees. On Base, gas is cheap, but repeated failures add up.
16
+
17
+ 4. **Tokens may have no liquidity or value**: Newly launched tokens are unaudited, may have no community, and can go to zero. The auction gives you early access — it does not guarantee the token has any value.
18
+
19
+ 5. **MEV competition**: Other bots and agents are competing in the same auction. You may be consistently outbid by more sophisticated actors with faster infrastructure.
20
+
21
+ 6. **Timing is critical and unreliable**: The auction is valid for exactly one block (~2 seconds on Base). Network latency, RPC delays, or block reorgs can cause your transaction to land in the wrong block and revert.
22
+
23
+ 7. **Smart contract risk**: The auction contracts are unaudited for this specific deployment. Bugs or misconfigurations could result in loss of funds.
24
+
25
+ **As an agent, you MUST:**
26
+ - Clearly present these risks to the user before their first auction bid
27
+ - Ask for explicit confirmation (e.g., "I understand the risks of auction sniping and want to proceed")
28
+ - Never execute auction bids autonomously without user approval for each bid, unless the user has explicitly granted standing permission
29
+ - Display the fee percentage and total cost (bid + swap + fees) before execution
30
+ - Recommend small amounts for initial bids until the user understands the mechanics
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
+
5
56
  ## How the Sniper Auction Works
6
57
 
7
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: