liquid-sdk 1.6.0 → 1.6.1
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 +4 -4
- package/skills/bid-in-auction.md +27 -0
package/package.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "liquid-sdk",
|
|
3
|
-
"version": "1.6.
|
|
3
|
+
"version": "1.6.1",
|
|
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/
|
|
6
|
+
"homepage": "https://github.com/Liquid-Protocol-Ops/SDK#readme",
|
|
7
7
|
"bugs": {
|
|
8
|
-
"url": "https://github.com/
|
|
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/
|
|
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,33 @@
|
|
|
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
|
+
|
|
5
32
|
## How the Sniper Auction Works
|
|
6
33
|
|
|
7
34
|
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:
|