liquid-sdk 1.5.6 → 1.5.9
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/AGENT_README.md +1 -1
- package/CHANGELOG.md +1 -1
- package/README.md +39 -39
- package/dist/index.d.mts +6 -6
- package/dist/index.d.ts +6 -6
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +2 -2
- package/dist/index.mjs.map +1 -1
- package/llms.txt +1 -1
- package/package.json +1 -1
- package/skills/bid-in-auction.md +3 -3
- package/skills/deploy-token.md +2 -2
package/llms.txt
CHANGED
|
@@ -121,7 +121,7 @@ Every token gets 100 billion supply (18 decimals), a Uniswap V4 pool, and locked
|
|
|
121
121
|
| tickSpacing | 200 |
|
|
122
122
|
| tickIfToken0IsLiquid | -230400 (~10 ETH market cap) |
|
|
123
123
|
| positions | 5-position Liquid layout: 10%/50%/15%/20%/5% |
|
|
124
|
-
| mevModule | Sniper Auction V2 (80%→40% over
|
|
124
|
+
| mevModule | Sniper Auction V2 (80%→40% over 20s) |
|
|
125
125
|
| rewardRecipients | [deployer] at 100% |
|
|
126
126
|
| context | {"interface":"SDK"} |
|
|
127
127
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "liquid-sdk",
|
|
3
|
-
"version": "1.5.
|
|
3
|
+
"version": "1.5.9",
|
|
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/craigbots/liquid-sdk#readme",
|
package/skills/bid-in-auction.md
CHANGED
|
@@ -6,7 +6,7 @@ You are an AI agent that participates in Liquid Protocol's sniper auction system
|
|
|
6
6
|
|
|
7
7
|
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:
|
|
8
8
|
|
|
9
|
-
1. **Fee decay**: The auction starts with an **80% fee** on swaps and decays linearly to **40% over
|
|
9
|
+
1. **Fee decay**: The auction starts with an **80% fee** on swaps and decays linearly to **40% over 20 seconds**
|
|
10
10
|
2. **Gas price bidding**: Bidders compete by setting their transaction gas price **above the pool's gas peg**. The difference between your gas price and the gas peg determines your bid amount
|
|
11
11
|
3. **Rounds**: The auction runs in discrete rounds every 2 blocks (5 rounds max). Each round is valid for exactly **one block** (`nextAuctionBlock`)
|
|
12
12
|
4. **Winner takes the swap**: The highest gas-price transaction in the auction block wins the right to swap at the current fee rate
|
|
@@ -286,7 +286,7 @@ interface BidInAuctionResult {
|
|
|
286
286
|
| Payment per gas unit | 0.0001 ETH (1e14 wei) | Converts gas delta to bid ETH |
|
|
287
287
|
| Starting fee | 800,000 (80%) | Fee at auction start |
|
|
288
288
|
| Ending fee | 400,000 (40%) | Fee floor after decay |
|
|
289
|
-
| Decay period |
|
|
289
|
+
| Decay period | 20 seconds | Time for fee to decay from start to end |
|
|
290
290
|
| Gas peg | ~6.3M wei (dynamic) | Set at pool creation, equals Base baseFee |
|
|
291
291
|
|
|
292
292
|
## Timing Strategy
|
|
@@ -294,7 +294,7 @@ interface BidInAuctionResult {
|
|
|
294
294
|
The auction fee **decays over time**, so there's a tradeoff:
|
|
295
295
|
|
|
296
296
|
- **Bid early** (high fee): You pay up to 80% of the swap as a fee, but you get the tokens before others. Useful if you expect rapid price appreciation.
|
|
297
|
-
- **Bid late** (lower fee): The fee decays to 40% over
|
|
297
|
+
- **Bid late** (lower fee): The fee decays to 40% over 20 seconds. You pay less in fees but risk being outbid or missing the auction window.
|
|
298
298
|
- **Wait for auction to end**: After all 5 rounds complete, trading is at normal pool fees (typically 1%). No auction mechanics apply.
|
|
299
299
|
|
|
300
300
|
```typescript
|
package/skills/deploy-token.md
CHANGED
|
@@ -172,7 +172,7 @@ const result = await sdk.deployToken({
|
|
|
172
172
|
| `positionBps` | `number[]` | 5-tranche Liquid default | Supply % per position (sum = 10000) |
|
|
173
173
|
| `lockerData` | `Hex` | auto-encoded | Locker init data |
|
|
174
174
|
| `mevModule` | `Address` | Sniper Auction V2 | MEV protection module |
|
|
175
|
-
| `mevModuleData` | `Hex` | 80%→40% over
|
|
175
|
+
| `mevModuleData` | `Hex` | 80%→40% over 20s | Encoded auction config |
|
|
176
176
|
| `extensions` | `ExtensionConfig[]` | `[]` | Additional extensions |
|
|
177
177
|
| `devBuy` | `DevBuyParams` | none | Buy tokens at launch |
|
|
178
178
|
|
|
@@ -204,7 +204,7 @@ When `deployToken()` executes, a single transaction:
|
|
|
204
204
|
2. **Initializes a Uniswap V4 pool** paired with WETH
|
|
205
205
|
3. **Locks all LP** in the LP Locker (non-ruggable)
|
|
206
206
|
4. **Configures reward splits** for fee distribution
|
|
207
|
-
5. **Activates MEV protection** (sniper auction: 80%→40% fee decay over
|
|
207
|
+
5. **Activates MEV protection** (sniper auction: 80%→40% fee decay over 20 seconds)
|
|
208
208
|
6. **Executes dev buy** if specified (swaps ETH→tokens in same tx)
|
|
209
209
|
7. **Emits `TokenCreated` event** with all deployment data
|
|
210
210
|
|