liquid-sdk 1.7.3 → 1.7.4
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 +112 -46
- package/CHANGELOG.md +10 -0
- package/README.md +239 -119
- package/dist/index.d.mts +55 -26
- package/dist/index.d.ts +55 -26
- package/dist/index.js +46 -3
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +43 -2
- package/dist/index.mjs.map +1 -1
- package/llms.txt +6 -6
- package/package.json +1 -1
- package/skills/deploy-token.md +1 -1
- package/skills/index-tokens.md +2 -2
- package/skills/sdk-overview.md +8 -8
package/llms.txt
CHANGED
|
@@ -30,7 +30,7 @@ console.log(result.tokenAddress);
|
|
|
30
30
|
Liquid Protocol deploys ERC-20 tokens on Base (chain 8453) with:
|
|
31
31
|
- Uniswap V4 liquidity pools (created automatically)
|
|
32
32
|
- Locked LP with configurable reward splits
|
|
33
|
-
- MEV protection (sniper auction
|
|
33
|
+
- MEV protection (sniper auction with descending fees)
|
|
34
34
|
- Optional extensions: dev buy, vault lockup/vesting, merkle airdrops
|
|
35
35
|
|
|
36
36
|
Every token gets 100 billion supply (18 decimals), a Uniswap V4 pool, and locked liquidity.
|
|
@@ -42,9 +42,9 @@ Every token gets 100 billion supply (18 decimals), a Uniswap V4 pool, and locked
|
|
|
42
42
|
- `sdk.buildDevBuyExtension(devBuy)` — Build extension config for buying tokens at launch
|
|
43
43
|
|
|
44
44
|
### Fee Management
|
|
45
|
-
- `sdk.getAvailableFees(feeOwner,
|
|
46
|
-
- `sdk.getFeesToClaim(feeOwner,
|
|
47
|
-
- `sdk.claimFees(feeOwner,
|
|
45
|
+
- `sdk.getAvailableFees(feeOwner, tokenAddress)` — Total unlocked fees (bigint)
|
|
46
|
+
- `sdk.getFeesToClaim(feeOwner, tokenAddress)` — Claimable fees right now (bigint)
|
|
47
|
+
- `sdk.claimFees(feeOwner, tokenAddress)` — Claim fees (returns txHash)
|
|
48
48
|
|
|
49
49
|
### LP Reward Management
|
|
50
50
|
- `sdk.getTokenRewards(tokenAddress)` — Reward config (recipients, bps, admins, poolKey)
|
|
@@ -86,8 +86,8 @@ Every token gets 100 billion supply (18 decimals), a Uniswap V4 pool, and locked
|
|
|
86
86
|
- `sdk.getAuctionMaxRounds()` — Max auction rounds
|
|
87
87
|
- `sdk.getAuctionGasPriceForBid(gasPeg, bidAmount)` — Calculate gas price for bid
|
|
88
88
|
|
|
89
|
-
### MEV
|
|
90
|
-
- `sdk.
|
|
89
|
+
### MEV Descending Fees
|
|
90
|
+
- `sdk.getMevDescendingFeesBlockDelay()` — Configured block delay (also: `getMevBlockDelay()` deprecated alias)
|
|
91
91
|
- `sdk.getPoolUnlockTime(poolId)` — When MEV lock expires (unix timestamp)
|
|
92
92
|
|
|
93
93
|
### Factory & Allowlist
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "liquid-sdk",
|
|
3
|
-
"version": "1.7.
|
|
3
|
+
"version": "1.7.4",
|
|
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",
|
package/skills/deploy-token.md
CHANGED
|
@@ -281,7 +281,7 @@ import { ADDRESSES, EXTERNAL } from "liquid-sdk";
|
|
|
281
281
|
ADDRESSES.FACTORY // Token factory
|
|
282
282
|
ADDRESSES.HOOK_STATIC_FEE_V2 // Default hook (1% buy + 1% sell)
|
|
283
283
|
ADDRESSES.HOOK_DYNAMIC_FEE_V2 // Dynamic fee hook
|
|
284
|
-
ADDRESSES.LP_LOCKER_FEE_CONVERSION // Default locker (converts fees to
|
|
284
|
+
ADDRESSES.LP_LOCKER_FEE_CONVERSION // Default locker (converts fees to ETH)
|
|
285
285
|
ADDRESSES.SNIPER_AUCTION_V2 // Default MEV module
|
|
286
286
|
ADDRESSES.UNIV4_ETH_DEV_BUY // Dev buy extension
|
|
287
287
|
EXTERNAL.WETH // Base WETH
|
package/skills/index-tokens.md
CHANGED
|
@@ -261,8 +261,8 @@ console.log("Pool locked:", now < unlockTime);
|
|
|
261
261
|
|
|
262
262
|
```typescript
|
|
263
263
|
// Check accrued fees
|
|
264
|
-
const fees = await sdk.getAvailableFees(feeOwner);
|
|
265
|
-
const claimable = await sdk.getFeesToClaim(feeOwner);
|
|
264
|
+
const fees = await sdk.getAvailableFees(feeOwner, tokenAddress);
|
|
265
|
+
const claimable = await sdk.getFeesToClaim(feeOwner, tokenAddress);
|
|
266
266
|
console.log("Total fees:", fees);
|
|
267
267
|
console.log("Claimable now:", claimable);
|
|
268
268
|
```
|
package/skills/sdk-overview.md
CHANGED
|
@@ -7,7 +7,7 @@ You are an AI agent working with the `liquid-sdk` package. This file gives you a
|
|
|
7
7
|
Liquid Protocol deploys ERC-20 tokens on Base (chain ID 8453) with:
|
|
8
8
|
- **Uniswap V4 pools** created and funded automatically
|
|
9
9
|
- **Permanently locked LP** — liquidity cannot be rugged
|
|
10
|
-
- **Configurable fee splits** — reward recipients earn LP fees in
|
|
10
|
+
- **Configurable fee splits** — reward recipients earn LP fees in ETH
|
|
11
11
|
- **MEV protection** — sniper auction prices early trading activity
|
|
12
12
|
- **Extensions** — dev buy, vault lockup/vesting, merkle airdrops
|
|
13
13
|
|
|
@@ -26,7 +26,7 @@ npm install liquid-sdk viem
|
|
|
26
26
|
| **Deploy** | Launch tokens with custom fees, positions, reward splits, dev buys |
|
|
27
27
|
| **Snipe** | Bid in MEV auctions for early access to new tokens |
|
|
28
28
|
| **Index** | Discover all tokens, query by deployer, paginate by block range |
|
|
29
|
-
| **Fees** | Check and claim accumulated LP fees (converted to
|
|
29
|
+
| **Fees** | Check and claim accumulated LP fees (converted to ETH) |
|
|
30
30
|
| **Rewards** | Collect LP rewards, update reward recipients |
|
|
31
31
|
| **Vault** | Check vesting schedules, claim unlocked tokens |
|
|
32
32
|
| **Airdrop** | Check allocations, claim with merkle proofs |
|
|
@@ -225,7 +225,7 @@ await sdk.collectRewards(tokenAddress);
|
|
|
225
225
|
- `rewardBps` must sum to 10000 (100%)
|
|
226
226
|
- BPS splits are **immutable** after deployment — only recipient addresses can change
|
|
227
227
|
- Each admin can only update the recipient at their own index
|
|
228
|
-
- All fees are converted to
|
|
228
|
+
- All fees are converted to ETH before distribution (default `FeePreference.Paired`)
|
|
229
229
|
|
|
230
230
|
### Dev Buy (buy tokens at launch)
|
|
231
231
|
|
|
@@ -296,16 +296,16 @@ await sdk.claimAirdrop(tokenAddress, recipientAddress, allocatedAmount, merklePr
|
|
|
296
296
|
|
|
297
297
|
### Fee Claims
|
|
298
298
|
|
|
299
|
-
LP fees accrue from trading activity. The LP Locker Fee Conversion contract converts all fees to
|
|
299
|
+
LP fees accrue from trading activity. The LP Locker Fee Conversion contract converts all fees to ETH before distributing.
|
|
300
300
|
|
|
301
301
|
```typescript
|
|
302
302
|
// Check fees
|
|
303
|
-
const available = await sdk.getAvailableFees(ownerAddress); // total unlocked
|
|
304
|
-
const claimable = await sdk.getFeesToClaim(ownerAddress); // ready to claim
|
|
303
|
+
const available = await sdk.getAvailableFees(ownerAddress, tokenAddress); // total unlocked
|
|
304
|
+
const claimable = await sdk.getFeesToClaim(ownerAddress, tokenAddress); // ready to claim
|
|
305
305
|
|
|
306
306
|
// Claim
|
|
307
307
|
if (claimable > 0n) {
|
|
308
|
-
await sdk.claimFees(ownerAddress);
|
|
308
|
+
await sdk.claimFees(ownerAddress, tokenAddress);
|
|
309
309
|
}
|
|
310
310
|
```
|
|
311
311
|
|
|
@@ -358,7 +358,7 @@ import { ADDRESSES, EXTERNAL, FEE, TOKEN, DEFAULTS, POOL_POSITIONS } from "liqui
|
|
|
358
358
|
// Key addresses
|
|
359
359
|
ADDRESSES.FACTORY // Token factory
|
|
360
360
|
ADDRESSES.HOOK_STATIC_FEE_V2 // Default hook (1% both ways)
|
|
361
|
-
ADDRESSES.LP_LOCKER_FEE_CONVERSION // Default locker (fees →
|
|
361
|
+
ADDRESSES.LP_LOCKER_FEE_CONVERSION // Default locker (fees → ETH)
|
|
362
362
|
ADDRESSES.SNIPER_AUCTION_V2 // Default MEV module
|
|
363
363
|
|
|
364
364
|
// Fee constants
|