liquid-sdk 1.7.1 → 1.7.3
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 +36 -99
- package/CHANGELOG.md +12 -0
- package/README.md +119 -239
- package/dist/index.d.mts +60 -6
- package/dist/index.d.ts +60 -6
- package/dist/index.js +105 -8
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +105 -8
- package/dist/index.mjs.map +1 -1
- package/llms.txt +3 -3
- 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
|
@@ -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, feeToken?)` — Total unlocked fees (bigint, defaults to WETH)
|
|
46
|
+
- `sdk.getFeesToClaim(feeOwner, feeToken?)` — Claimable fees right now (bigint, defaults to WETH)
|
|
47
|
+
- `sdk.claimFees(feeOwner, feeToken?)` — Claim fees (returns txHash, defaults to WETH)
|
|
48
48
|
|
|
49
49
|
### LP Reward Management
|
|
50
50
|
- `sdk.getTokenRewards(tokenAddress)` — Reward config (recipients, bps, admins, poolKey)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "liquid-sdk",
|
|
3
|
-
"version": "1.7.
|
|
3
|
+
"version": "1.7.3",
|
|
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 WETH)
|
|
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);
|
|
265
|
+
const claimable = await sdk.getFeesToClaim(feeOwner);
|
|
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 WETH
|
|
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 WETH) |
|
|
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 WETH 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 WETH before distributing.
|
|
300
300
|
|
|
301
301
|
```typescript
|
|
302
302
|
// Check fees
|
|
303
|
-
const available = await sdk.getAvailableFees(ownerAddress
|
|
304
|
-
const claimable = await sdk.getFeesToClaim(ownerAddress
|
|
303
|
+
const available = await sdk.getAvailableFees(ownerAddress); // total unlocked
|
|
304
|
+
const claimable = await sdk.getFeesToClaim(ownerAddress); // ready to claim
|
|
305
305
|
|
|
306
306
|
// Claim
|
|
307
307
|
if (claimable > 0n) {
|
|
308
|
-
await sdk.claimFees(ownerAddress
|
|
308
|
+
await sdk.claimFees(ownerAddress);
|
|
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 → WETH)
|
|
362
362
|
ADDRESSES.SNIPER_AUCTION_V2 // Default MEV module
|
|
363
363
|
|
|
364
364
|
// Fee constants
|