liquid-sdk 1.5.3 → 1.5.5
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 +22 -1
- package/README.md +138 -61
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +1 -1
- 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/llms.txt
CHANGED
|
@@ -120,7 +120,7 @@ Every token gets 100 billion supply (18 decimals), a Uniswap V4 pool, and locked
|
|
|
120
120
|
| hook | Static fee V2 (1% buy fee) |
|
|
121
121
|
| tickSpacing | 200 |
|
|
122
122
|
| tickIfToken0IsLiquid | -230400 (~10 ETH market cap) |
|
|
123
|
-
| positions |
|
|
123
|
+
| positions | 5-position Liquid layout: 10%/50%/15%/20%/5% |
|
|
124
124
|
| mevModule | Sniper Auction V2 (80%→40% over 32s) |
|
|
125
125
|
| rewardRecipients | [deployer] at 100% |
|
|
126
126
|
| context | {"interface":"SDK"} |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "liquid-sdk",
|
|
3
|
-
"version": "1.5.
|
|
3
|
+
"version": "1.5.5",
|
|
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
|
@@ -53,7 +53,7 @@ The SDK **automatically wraps ETH → WETH and approves the SniperUtilV2** if yo
|
|
|
53
53
|
The bid amount is encoded in the transaction's gas price: `bidAmount = (tx.gasprice - gasPeg) × paymentPerGasUnit`. Both `maxFeePerGas` **and** `maxPriorityFeePerGas` must be set to the calculated value, otherwise Base's EIP-1559 will compute a lower effective gas price.
|
|
54
54
|
|
|
55
55
|
### Gas Estimation Must Be Skipped
|
|
56
|
-
`eth_estimateGas` simulates at `baseFee` (~5M wei on Base), which is below the `gasPeg` (~6.3M wei). This causes the auction check to fail during estimation. The SDK sets `gas:
|
|
56
|
+
`eth_estimateGas` simulates at `baseFee` (~5M wei on Base), which is below the `gasPeg` (~6.3M wei). This causes the auction check to fail during estimation. The SDK sets `gas: 800_000n` manually.
|
|
57
57
|
|
|
58
58
|
### Block Timing is Critical
|
|
59
59
|
The auction is valid at **exactly** `nextAuctionBlock` — not before, not after. Submit your transaction ~1 block early (when `currentBlock === nextAuctionBlock - 1`) to land in the target block. Base has ~2s block time.
|
|
@@ -255,7 +255,7 @@ await snipeToken("0x...", "0.001", "0.001");
|
|
|
255
255
|
6. Call `sdk.bidInAuction(params, gasPrice)` — SDK handles:
|
|
256
256
|
- Auto-wrapping ETH → WETH for `amountIn`
|
|
257
257
|
- Auto-approving SniperUtilV2 for WETH
|
|
258
|
-
- Setting `gas:
|
|
258
|
+
- Setting `gas: 800_000n` (skipping estimation)
|
|
259
259
|
- Setting `maxFeePerGas` and `maxPriorityFeePerGas` to the calculated value
|
|
260
260
|
7. Transaction lands in `nextAuctionBlock` → snipe complete
|
|
261
261
|
|
|
@@ -311,7 +311,7 @@ console.log(`Current fee: ${feePercent}%`);
|
|
|
311
311
|
| `Unauthorized()` | `0x82b42900` | Fee Locker hasn't authorized the Sniper Auction as depositor | Protocol admin must call `FeeLocker.addDepositor(SniperAuctionAddress)` |
|
|
312
312
|
| `NotAuctionBlock()` | — | Tx didn't land in `nextAuctionBlock` | Submit 1 block early, tx must mine in the exact auction block |
|
|
313
313
|
| WETH `transferFrom` revert | — | Insufficient WETH balance or allowance | SDK handles this automatically; ensure enough ETH for wrap |
|
|
314
|
-
| Gas estimation failure | — | `eth_estimateGas` runs at baseFee < gasPeg | SDK sets `gas:
|
|
314
|
+
| Gas estimation failure | — | `eth_estimateGas` runs at baseFee < gasPeg | SDK sets `gas: 800_000n` manually |
|
|
315
315
|
|
|
316
316
|
## Read-Only Auction Queries (No Wallet Needed)
|
|
317
317
|
|