lpsignal 0.9.0 → 0.11.0

package/dist/liquidity/core.js

@@ -0,0 +1,366 @@
+/**
+ * Concentrated-liquidity math and the official position-manager calls (Uniswap v3 / PancakeSwap v3
+ * NonfungiblePositionManager, Aerodrome / Velodrome Slipstream) — the same code the lpsignal.app web app runs, kept in
+ * step with it. Pure: nothing here signs or sends; recipients are always the caller's own address.
+ *
+ * Math is the pools' own, in integers: TickMath.getSqrtRatioAtTick, LiquidityAmounts, SqrtPriceMath (rounding as the
+ * contracts do), and the Uniswap SDK's slippage rule for the minimum amounts.
+ */
+import { encodeFunctionData } from 'viem';
+/** position managers per chain and dex — the ones whose factory created the pools we track (src/chains.ts `npms`) */
+export const NPM = {
+    ethereum: { uniswap_v3: '0xc36442b4a4522e871399cd717abdd847ab11fe88', pancake_v3: '0x46a15b0b27311cedf172ab29e4f4766fbe7f4364' },
+    bsc: { uniswap_v3: '0x7b8a01b39d58278b5de7e48c8449c9f4f5170613', pancake_v3: '0x46a15b0b27311cedf172ab29e4f4766fbe7f4364' },
+    base: { uniswap_v3: '0x03a520b32c04bf3beef7beb72e919cf822ed34f1', pancake_v3: '0x46a15b0b27311cedf172ab29e4f4766fbe7f4364', aerodrome_cl: '0x827922686190790b37229fd06084350e74485b72' },
+    arbitrum: { uniswap_v3: '0xc36442b4a4522e871399cd717abdd847ab11fe88', pancake_v3: '0x46a15b0b27311cedf172ab29e4f4766fbe7f4364' },
+    optimism: { uniswap_v3: '0xc36442b4a4522e871399cd717abdd847ab11fe88', velodrome_cl: '0x416b433906b1b72fa758e166e239c43d68dc6f29' },
+    polygon: { uniswap_v3: '0xc36442b4a4522e871399cd717abdd847ab11fe88' },
+};
+export const CHAIN_ID = { ethereum: 1, bsc: 56, base: 8453, arbitrum: 42161, optimism: 10, polygon: 137 };
+/** the wrapped native coin the position managers wrap msg.value into (their WETH9()) */
+export const WRAPPED = {
+    ethereum: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2', bsc: '0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c', base: '0x4200000000000000000000000000000000000006',
+    arbitrum: '0x82af49447d8a07e3bd95bd0d56f35241523fbab1', optimism: '0x4200000000000000000000000000000000000006', polygon: '0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270',
+};
+export const EXPLORER = {
+    ethereum: 'https://etherscan.io', base: 'https://basescan.org', arbitrum: 'https://arbiscan.io', optimism: 'https://optimistic.etherscan.io',
+    bsc: 'https://bscscan.com', polygon: 'https://polygonscan.com',
+};
+export const NATIVE_SYMBOL = { ethereum: 'ETH', bsc: 'BNB', base: 'ETH', arbitrum: 'ETH', optimism: 'ETH', polygon: 'POL' };
+/** USDT on Ethereum refuses to change a non-zero allowance to another non-zero one: reset it to 0 first */
+export const ZERO_FIRST = { ethereum: ['0xdac17f958d2ee523a2206206994597c13d831ec7'] };
+export const isSlipstream = (dex) => dex === 'aerodrome_cl' || dex === 'velodrome_cl';
+export function npmOf(chain, dex) {
+    return NPM[chain]?.[dex] ?? null;
+}
+// ---- TickMath (Uniswap v3 core, exact) ----
+export const MIN_TICK = -887272;
+export const MAX_TICK = 887272;
+export const MIN_SQRT_RATIO = 4295128739n;
+export const MAX_SQRT_RATIO = 1461446703485210103287273052203988822378723970342n;
+const Q96 = 1n << 96n;
+const MAX_U256 = (1n << 256n) - 1n;
+const RATIOS = [
+    [0x2, 0xfff97272373d413259a46990580e213an], [0x4, 0xfff2e50f5f656932ef12357cf3c7fdccn], [0x8, 0xffe5caca7e10e4e61c3624eaa0941cd0n],
+    [0x10, 0xffcb9843d60f6159c9db58835c926644n], [0x20, 0xff973b41fa98c081472e6896dfb254c0n], [0x40, 0xff2ea16466c96a3843ec78b326b52861n],
+    [0x80, 0xfe5dee046a99a2a811c461f1969c3053n], [0x100, 0xfcbe86c7900a88aedcffc83b479aa3a4n], [0x200, 0xf987a7253ac413176f2b074cf7815e54n],
+    [0x400, 0xf3392b0822b70005940c7a398e4b70f3n], [0x800, 0xe7159475a2c29b7443b29c7fa6e889d9n], [0x1000, 0xd097f3bdfd2022b8845ad8f792aa5825n],
+    [0x2000, 0xa9f746462d870fdf8a65dc1f90e061e5n], [0x4000, 0x70d869a156d2a1b890bb3df62baf32f7n], [0x8000, 0x31be135f97d08fd981231505542fcfa6n],
+    [0x10000, 0x9aa508b5b7a84e1c677de54f3e99bc9n], [0x20000, 0x5d6af8dedb81196699c329225ee604n], [0x40000, 0x2216e584f5fa1ea926041bedfe98n],
+    [0x80000, 0x48a170391f7dc42444e8fa2n],
+];
+export function sqrtRatioAtTick(tick) {
+    if (!Number.isInteger(tick) || tick < MIN_TICK || tick > MAX_TICK)
+        throw new RangeError(`tick ${tick}`);
+    const abs = Math.abs(tick);
+    let ratio = abs & 0x1 ? 0xfffcb933bd6fad37aa2d162d1a594001n : 0x100000000000000000000000000000000n;
+    for (const [bit, mul] of RATIOS)
+        if (abs & bit)
+            ratio = (ratio * mul) >> 128n;
+    if (tick > 0)
+        ratio = MAX_U256 / ratio;
+    // Q128.128 → Q64.96, rounding up
+    return (ratio >> 32n) + (ratio % (1n << 32n) === 0n ? 0n : 1n);
+}
+// ---- ranges ----
+const LN = Math.log(1.0001);
+/** the full range: the extreme ticks rounded inward to the spacing (the widest legal position) */
+export function fullRange(tickSpacing) {
+    const s = Math.max(1, tickSpacing);
+    return [Math.ceil(MIN_TICK / s) * s, Math.floor(MAX_TICK / s) * s];
+}
+/** ±rangeBp of price around `tick`, widened outward to the tick grid, always containing the price (0 = full range) — as the backtests */
+export function rangeTicks(tick, rangeBp, tickSpacing) {
+    const s = Math.max(1, tickSpacing);
+    const [minT, maxT] = fullRange(s);
+    if (rangeBp === 0)
+        return [minT, maxT];
+    const r = rangeBp / 1e4;
+    let lo = Math.floor((tick - Math.log(1 + r) / LN) / s) * s;
+    let hi = Math.ceil((tick + Math.log(1 + r) / LN) / s) * s;
+    if (lo > tick)
+        lo = Math.floor(tick / s) * s;
+    if (hi <= tick)
+        hi = (Math.floor(tick / s) + 1) * s;
+    // (|| 0: no -0 from flooring a small negative)
+    return [Math.max(lo, minT) || 0, Math.min(hi, maxT) || 0];
+}
+// ---- LiquidityAmounts / SqrtPriceMath ----
+const mulDiv = (a, b, d) => (a * b) / d;
+const mulDivUp = (a, b, d) => { const p = a * b; return p / d + (p % d === 0n ? 0n : 1n); };
+const sort2 = (a, b) => (a > b ? [b, a] : [a, b]);
+function liquidityFor0(sa, sb, amount0) {
+    [sa, sb] = sort2(sa, sb);
+    return mulDiv(amount0, mulDiv(sa, sb, Q96), sb - sa);
+}
+function liquidityFor1(sa, sb, amount1) {
+    [sa, sb] = sort2(sa, sb);
+    return mulDiv(amount1, Q96, sb - sa);
+}
+/** the liquidity the position manager mints for these desired amounts (LiquidityAmounts.getLiquidityForAmounts) */
+export function liquidityForAmounts(sp, sa, sb, amount0, amount1) {
+    [sa, sb] = sort2(sa, sb);
+    if (sp <= sa)
+        return liquidityFor0(sa, sb, amount0);
+    if (sp < sb) {
+        const l0 = liquidityFor0(sp, sb, amount0), l1 = liquidityFor1(sa, sp, amount1);
+        return l0 < l1 ? l0 : l1;
+    }
+    return liquidityFor1(sa, sb, amount1);
+}
+function amount0Delta(sa, sb, l, up) {
+    [sa, sb] = sort2(sa, sb);
+    const n1 = l << 96n, n2 = sb - sa;
+    return up ? (mulDivUp(mulDivUp(n1, n2, sb), 1n, sa)) : mulDiv(n1, n2, sb) / sa;
+}
+function amount1Delta(sa, sb, l, up) {
+    [sa, sb] = sort2(sa, sb);
+    return up ? mulDivUp(l, sb - sa, Q96) : mulDiv(l, sb - sa, Q96);
+}
+/** the token amounts liquidity `l` takes at price `sp` (rounded up = what a mint pulls; down = what it is worth) */
+export function amountsForLiquidity(sp, sa, sb, l, up) {
+    [sa, sb] = sort2(sa, sb);
+    if (sp <= sa)
+        return [amount0Delta(sa, sb, l, up), 0n];
+    if (sp < sb)
+        return [amount0Delta(sp, sb, l, up), amount1Delta(sa, sp, l, up)];
+    return [0n, amount1Delta(sa, sb, l, up)];
+}
+/**
+ * Given one side's amount, the other side the range needs at the current price (0 when the range takes only one
+ * token at this price; null when the given side is not used at all there).
+ */
+export function otherAmount(side, amount, sp, tickLower, tickUpper) {
+    const sa = sqrtRatioAtTick(tickLower), sb = sqrtRatioAtTick(tickUpper);
+    if (side === 0 && sp >= sb)
+        return null;
+    if (side === 1 && sp <= sa)
+        return null;
+    if (sp <= sa || sp >= sb)
+        return 0n;
+    const l = side === 0 ? liquidityFor0(sp, sb, amount) : liquidityFor1(sa, sp, amount);
+    return amountsForLiquidity(sp, sa, sb, l, true)[side === 0 ? 1 : 0];
+}
+/** which tokens a range takes at this price */
+export function sidesUsed(sp, tickLower, tickUpper) {
+    const sa = sqrtRatioAtTick(tickLower), sb = sqrtRatioAtTick(tickUpper);
+    return { token0: sp < sb, token1: sp > sa };
+}
+const BPS = 10000n;
+/** isqrt of a non-negative bigint */
+function isqrt(n) {
+    if (n < 2n)
+        return n;
+    let x = BigInt(Math.floor(Math.sqrt(Number(n))));
+    while (x * x > n)
+        x--;
+    while ((x + 1n) * (x + 1n) <= n)
+        x++;
+    return x;
+}
+/** sqrt price after the price moves by `bps` (signed) — the price is the square: sp * sqrt(1 + bps/1e4) */
+function movedSqrt(sp, bps) {
+    const s = (sp * isqrt((BPS + bps) * 10n ** 36n / BPS)) / 10n ** 18n;
+    return s < MIN_SQRT_RATIO ? MIN_SQRT_RATIO : s >= MAX_SQRT_RATIO ? MAX_SQRT_RATIO - 1n : s;
+}
+/**
+ * The amounts to send for these desired amounts, and the minimums under a price move of up to `slippageBps` before the
+ * transaction lands. The position manager re-derives the liquidity from the desired amounts AT THE PRICE IT MEETS, so
+ * the minimum of each token is what it would actually take at the worse end of the band — token0 at the upper price,
+ * token1 at the lower (each is monotonic in the price) — never the liquidity fixed now valued there (that is higher
+ * than what a moved price takes, and would revert a move well inside the tolerance).
+ */
+export function mintAmounts(sp, tickLower, tickUpper, desired0, desired1, slippageBps) {
+    const sa = sqrtRatioAtTick(tickLower), sb = sqrtRatioAtTick(tickUpper);
+    const liquidity = liquidityForAmounts(sp, sa, sb, desired0, desired1);
+    const s = BigInt(Math.round(slippageBps));
+    if (s < 0n || s >= BPS)
+        throw new RangeError('slippage');
+    // what minting `liquidity` pulls at the current price (never more than desired)
+    const [use0, use1] = amountsForLiquidity(sp, sa, sb, liquidity, true);
+    const amount0Desired = use0 < desired0 ? use0 : desired0, amount1Desired = use1 < desired1 ? use1 : desired1;
+    const l = liquidityForAmounts(sp, sa, sb, amount0Desired, amount1Desired);
+    // what the manager would take at the band's ends (less token0 when the price rises, less token1 when it falls),
+    // rounded down below what it really pulls (it rounds up)
+    const up = movedSqrt(sp, s), down = movedSqrt(sp, -s);
+    const [min0] = amountsForLiquidity(up, sa, sb, liquidityForAmounts(up, sa, sb, amount0Desired, amount1Desired), false);
+    const [, min1] = amountsForLiquidity(down, sa, sb, liquidityForAmounts(down, sa, sb, amount0Desired, amount1Desired), false);
+    return { liquidity: l, amount0Desired, amount1Desired, amount0Min: min0 < amount0Desired ? min0 : amount0Desired, amount1Min: min1 < amount1Desired ? min1 : amount1Desired };
+}
+// ---- calls ----
+const MINT_V3 = [{
+        type: 'function', name: 'mint', stateMutability: 'payable',
+        inputs: [{ name: 'params', type: 'tuple', components: [
+                    { name: 'token0', type: 'address' }, { name: 'token1', type: 'address' }, { name: 'fee', type: 'uint24' },
+                    { name: 'tickLower', type: 'int24' }, { name: 'tickUpper', type: 'int24' },
+                    { name: 'amount0Desired', type: 'uint256' }, { name: 'amount1Desired', type: 'uint256' },
+                    { name: 'amount0Min', type: 'uint256' }, { name: 'amount1Min', type: 'uint256' },
+                    { name: 'recipient', type: 'address' }, { name: 'deadline', type: 'uint256' },
+                ] }],
+        outputs: [{ name: 'tokenId', type: 'uint256' }, { name: 'liquidity', type: 'uint128' }, { name: 'amount0', type: 'uint256' }, { name: 'amount1', type: 'uint256' }],
+    }];
+const MINT_SLIPSTREAM = [{
+        type: 'function', name: 'mint', stateMutability: 'payable',
+        inputs: [{ name: 'params', type: 'tuple', components: [
+                    { name: 'token0', type: 'address' }, { name: 'token1', type: 'address' }, { name: 'tickSpacing', type: 'int24' },
+                    { name: 'tickLower', type: 'int24' }, { name: 'tickUpper', type: 'int24' },
+                    { name: 'amount0Desired', type: 'uint256' }, { name: 'amount1Desired', type: 'uint256' },
+                    { name: 'amount0Min', type: 'uint256' }, { name: 'amount1Min', type: 'uint256' },
+                    { name: 'recipient', type: 'address' }, { name: 'deadline', type: 'uint256' }, { name: 'sqrtPriceX96', type: 'uint160' },
+                ] }],
+        outputs: [{ name: 'tokenId', type: 'uint256' }, { name: 'liquidity', type: 'uint128' }, { name: 'amount0', type: 'uint256' }, { name: 'amount1', type: 'uint256' }],
+    }];
+const PERIPHERY = [
+    { type: 'function', name: 'multicall', stateMutability: 'payable', inputs: [{ name: 'data', type: 'bytes[]' }], outputs: [{ name: 'results', type: 'bytes[]' }] },
+    { type: 'function', name: 'refundETH', stateMutability: 'payable', inputs: [], outputs: [] },
+];
+export const ERC20 = [
+    { type: 'function', name: 'approve', stateMutability: 'nonpayable', inputs: [{ name: 'spender', type: 'address' }, { name: 'amount', type: 'uint256' }], outputs: [{ type: 'bool' }] },
+    { type: 'function', name: 'allowance', stateMutability: 'view', inputs: [{ name: 'owner', type: 'address' }, { name: 'spender', type: 'address' }], outputs: [{ type: 'uint256' }] },
+    { type: 'function', name: 'balanceOf', stateMutability: 'view', inputs: [{ name: 'owner', type: 'address' }], outputs: [{ type: 'uint256' }] },
+];
+/** the first two fields of slot0 — the same on Uniswap v3, PancakeSwap v3 and Slipstream (the rest differ) */
+export const SLOT0 = [{ type: 'function', name: 'slot0', stateMutability: 'view', inputs: [], outputs: [{ name: 'sqrtPriceX96', type: 'uint160' }, { name: 'tick', type: 'int24' }] }];
+/** the mint transaction (with the native coin: multicall(mint, refundETH) carrying the value) */
+export function mintCall(m) {
+    const npm = npmOf(m.chain, m.dex);
+    if (!npm)
+        throw new Error(`no position manager for ${m.dex} on ${m.chain}`);
+    if (!(m.tickLower < m.tickUpper) || m.tickLower % m.tickSpacing !== 0 || m.tickUpper % m.tickSpacing !== 0)
+        throw new Error('range not on the tick grid');
+    if (m.nativeSide !== null && (m.nativeSide === 0 ? m.token0 : m.token1).toLowerCase() !== WRAPPED[m.chain]?.toLowerCase())
+        throw new Error('not the wrapped native token');
+    const a = m.amounts;
+    const common = {
+        token0: m.token0, token1: m.token1, tickLower: m.tickLower, tickUpper: m.tickUpper,
+        amount0Desired: a.amount0Desired, amount1Desired: a.amount1Desired, amount0Min: a.amount0Min, amount1Min: a.amount1Min,
+        recipient: m.recipient, deadline: m.deadline,
+    };
+    const mint = isSlipstream(m.dex)
+        // sqrtPriceX96 = 0: the pool exists (non-zero would ask the factory to create it, and revert)
+        ? encodeFunctionData({ abi: MINT_SLIPSTREAM, functionName: 'mint', args: [{ ...common, tickSpacing: m.tickSpacing, sqrtPriceX96: 0n }] })
+        : encodeFunctionData({ abi: MINT_V3, functionName: 'mint', args: [{ ...common, fee: m.fee }] });
+    if (m.nativeSide === null)
+        return { to: npm, data: mint, value: 0n };
+    const value = m.nativeSide === 0 ? a.amount0Desired : a.amount1Desired;
+    const refund = encodeFunctionData({ abi: PERIPHERY, functionName: 'refundETH' });
+    return { to: npm, data: encodeFunctionData({ abi: PERIPHERY, functionName: 'multicall', args: [[mint, refund]] }), value };
+}
+export function approveCall(token, spender, amount) {
+    return { to: token, data: encodeFunctionData({ abi: ERC20, functionName: 'approve', args: [spender, amount] }), value: 0n };
+}
+/** the approvals a mint needs, given the current allowances (exact amounts, never unlimited) */
+export function approvalsNeeded(chain, npm, needs) {
+    const out = [];
+    for (const n of needs) {
+        if (n.amount === 0n || n.allowance >= n.amount)
+            continue;
+        if (n.allowance > 0n && (ZERO_FIRST[chain] ?? []).includes(n.token.toLowerCase()))
+            out.push(approveCall(n.token, npm, 0n));
+        out.push(approveCall(n.token, npm, n.amount));
+    }
+    return out;
+}
+/** token units ⇄ text, exact (no floats) */
+export function parseUnits(text, decimals) {
+    const m = /^\s*(\d*)(?:\.(\d*))?\s*$/.exec(text);
+    if (!m || (!m[1] && !m[2]))
+        return null;
+    const frac = (m[2] ?? '');
+    if (frac.length > decimals)
+        return null;
+    return BigInt((m[1] || '0') + frac.padEnd(decimals, '0'));
+}
+export function formatUnits(v, decimals, maxFrac = 6) {
+    const neg = v < 0n, a = neg ? -v : v;
+    const base = 10n ** BigInt(decimals);
+    const int = a / base, frac = (a % base).toString().padStart(decimals, '0').slice(0, maxFrac).replace(/0+$/, '');
+    return `${neg ? '-' : ''}${int.toString()}${frac ? `.${frac}` : ''}`;
+}
+/** human price of token0 in token1 at a tick */
+export const priceAtTick = (tick, decimals0, decimals1) => Math.exp(tick * LN) * 10 ** (decimals0 - decimals1);
+/**
+ * Everything a mint needs, from the pool's live price and what the user wants to put in: the range (±rangeBp around
+ * the price, on the grid), the amounts and minimums, the approvals still missing (for the amounts the user entered,
+ * so a re-plan at a fresh price before the mint never needs another one), and the mint itself.
+ */
+export function planMint(pool, slot0, input) {
+    const npm = npmOf(pool.chain, pool.dex);
+    if (!npm)
+        throw new Error(`no position manager for ${pool.dex} on ${pool.chain}`);
+    const [tickLower, tickUpper] = rangeTicks(slot0.tick, input.rangeBp, pool.tickSpacing);
+    const amounts = mintAmounts(slot0.sqrtPriceX96, tickLower, tickUpper, input.desired0, input.desired1, input.slippageBps);
+    if (amounts.liquidity === 0n)
+        throw new Error('amount too small');
+    const approvals = approvalsNeeded(pool.chain, npm, [
+        ...(input.nativeSide === 0 ? [] : [{ token: pool.token0, amount: input.desired0, allowance: input.allowance0 }]),
+        ...(input.nativeSide === 1 ? [] : [{ token: pool.token1, amount: input.desired1, allowance: input.allowance1 }]),
+    ]);
+    const mint = mintCall({ ...pool, tickLower, tickUpper, amounts, recipient: input.recipient, deadline: input.deadline, nativeSide: input.nativeSide });
+    return { tickLower, tickUpper, amounts, approvals, mint };
+}
+// ---- removing liquidity ----
+const MAX_U128 = (1n << 128n) - 1n;
+/** the position-manager calls for reading and removing a position (the same on Uniswap v3, PancakeSwap v3, Slipstream) */
+export const NPM_READ = [
+    { type: 'function', name: 'balanceOf', stateMutability: 'view', inputs: [{ name: 'owner', type: 'address' }], outputs: [{ type: 'uint256' }] },
+    { type: 'function', name: 'tokenOfOwnerByIndex', stateMutability: 'view', inputs: [{ name: 'owner', type: 'address' }, { name: 'index', type: 'uint256' }], outputs: [{ type: 'uint256' }] },
+    // Uniswap / PancakeSwap: field 4 is the fee; Slipstream: the tick spacing (both fit an int24/uint24 word)
+    { type: 'function', name: 'positions', stateMutability: 'view', inputs: [{ name: 'tokenId', type: 'uint256' }], outputs: [
+            { name: 'nonce', type: 'uint96' }, { name: 'operator', type: 'address' }, { name: 'token0', type: 'address' }, { name: 'token1', type: 'address' },
+            { name: 'feeOrSpacing', type: 'int24' }, { name: 'tickLower', type: 'int24' }, { name: 'tickUpper', type: 'int24' }, { name: 'liquidity', type: 'uint128' },
+            { name: 'feeGrowthInside0LastX128', type: 'uint256' }, { name: 'feeGrowthInside1LastX128', type: 'uint256' }, { name: 'tokensOwed0', type: 'uint128' }, { name: 'tokensOwed1', type: 'uint128' },
+        ] },
+];
+const NPM_WRITE = [
+    { type: 'function', name: 'decreaseLiquidity', stateMutability: 'payable', inputs: [{ name: 'params', type: 'tuple', components: [
+                    { name: 'tokenId', type: 'uint256' }, { name: 'liquidity', type: 'uint128' }, { name: 'amount0Min', type: 'uint256' }, { name: 'amount1Min', type: 'uint256' }, { name: 'deadline', type: 'uint256' },
+                ] }], outputs: [{ name: 'amount0', type: 'uint256' }, { name: 'amount1', type: 'uint256' }] },
+    { type: 'function', name: 'collect', stateMutability: 'payable', inputs: [{ name: 'params', type: 'tuple', components: [
+                    { name: 'tokenId', type: 'uint256' }, { name: 'recipient', type: 'address' }, { name: 'amount0Max', type: 'uint128' }, { name: 'amount1Max', type: 'uint128' },
+                ] }], outputs: [{ name: 'amount0', type: 'uint256' }, { name: 'amount1', type: 'uint256' }] },
+    { type: 'function', name: 'multicall', stateMutability: 'payable', inputs: [{ name: 'data', type: 'bytes[]' }], outputs: [{ name: 'results', type: 'bytes[]' }] },
+];
+export const COLLECT_ABI = NPM_WRITE;
+/** whether a position belongs to this pool (same tokens and fee — Slipstream: tick spacing) */
+export function inPool(pos, pool) {
+    return pos.token0.toLowerCase() === pool.token0.toLowerCase() && pos.token1.toLowerCase() === pool.token1.toLowerCase()
+        && pos.feeOrSpacing === (isSlipstream(pool.dex) ? pool.tickSpacing : pool.fee);
+}
+/**
+ * Taking `share` (basis points of the position, 1..10000) out: the liquidity, what it is worth now, and the minimums
+ * under a price move of up to `slippageBps` (each token at its worse price, as the Uniswap SDK's burn rule).
+ */
+export function removeAmounts(sp, pos, shareBps, slippageBps) {
+    if (!Number.isInteger(shareBps) || shareBps < 1 || shareBps > 10_000)
+        throw new RangeError('share');
+    const s = BigInt(Math.round(slippageBps));
+    if (s < 0n || s >= BPS)
+        throw new RangeError('slippage');
+    const liquidity = shareBps === 10_000 ? pos.liquidity : (pos.liquidity * BigInt(shareBps)) / BPS;
+    const sa = sqrtRatioAtTick(pos.tickLower), sb = sqrtRatioAtTick(pos.tickUpper);
+    const [amount0, amount1] = amountsForLiquidity(sp, sa, sb, liquidity, false);
+    // a rising price leaves less token0, a falling one less token1
+    const [min0] = amountsForLiquidity(movedSqrt(sp, s), sa, sb, liquidity, false);
+    const [, min1] = amountsForLiquidity(movedSqrt(sp, -s), sa, sb, liquidity, false);
+    return { liquidity, amount0, amount1, amount0Min: min0 < amount0 ? min0 : amount0, amount1Min: min1 < amount1 ? min1 : amount1 };
+}
+/** collect everything owed (fees + what was decreased) to the wallet — the same call simulated shows the uncollected fees */
+export function collectCall(chain, dex, tokenId, recipient) {
+    const npm = npmOf(chain, dex);
+    if (!npm)
+        throw new Error(`no position manager for ${dex} on ${chain}`);
+    return { to: npm, data: encodeFunctionData({ abi: NPM_WRITE, functionName: 'collect', args: [{ tokenId, recipient, amount0Max: MAX_U128, amount1Max: MAX_U128 }] }), value: 0n };
+}
+/**
+ * One transaction: decrease the liquidity (with minimums and a deadline), then collect it all — principal and fees —
+ * to the wallet itself. `liquidity` 0 = fees only (collect).
+ */
+export function removeCall(chain, dex, tokenId, amounts, recipient, deadline) {
+    const collect = collectCall(chain, dex, tokenId, recipient);
+    if (amounts.liquidity === 0n)
+        return collect;
+    const decrease = encodeFunctionData({ abi: NPM_WRITE, functionName: 'decreaseLiquidity', args: [{ tokenId, liquidity: amounts.liquidity, amount0Min: amounts.amount0Min, amount1Min: amounts.amount1Min, deadline }] });
+    return { to: collect.to, data: encodeFunctionData({ abi: NPM_WRITE, functionName: 'multicall', args: [[decrease, collect.data]] }), value: 0n };
+}
+//# sourceMappingURL=core.js.map

package/dist/liquidity/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/liquidity/core.ts"],"names":[],"mappings":"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"}

package/dist/liquidity/index.d.ts

@@ -0,0 +1,211 @@
+/**
+ * `lpsignal/liquidity` — add and remove concentrated liquidity from your own wallet, on the pools' official position
+ * managers (Uniswap v3, PancakeSwap v3, Aerodrome / Velodrome Slipstream): no LPSignal contract, no fee, the position
+ * always minted to / collected by your own address. Uses viem (a peer dependency): you pass a PublicClient to read the
+ * chain and, to send, your own WalletClient — your keys never reach this SDK.
+ *
+ *   const pool = (await lps.pool('base', '0x…')).pool;            // tokens, decimals, fee, tick spacing
+ *   const plan = await planAddLiquidity(publicClient, pool, { owner, amount0: parseEther('1'), rangeBp: 500 });
+ *   await sendPlan(walletClient, publicClient, [...plan.approvals, plan.mint]);
+ *
+ * Never re-send a mint whose receipt you have not seen: a second one would add the same amounts again (sendPlan
+ * throws TxPending with the hash instead of guessing).
+ *
+ * Swapping one pool token for the other (e.g. for the side you are short of) goes through the KyberSwap aggregator with
+ * LPSignal's fee (0.25%, 0.05% in stable pools, taken from the input) — planSwap checks every answer of the aggregator
+ * against the pool's own price and the calldata it builds, then sendPlan sends it like any other plan.
+ */
+import { type Address, type Hex, type PublicClient, type WalletClient } from 'viem';
+import { type Call, type MintPlan, type Position } from './core.js';
+export * from './core.js';
+export * from './swap.js';
+/** a pool as the API returns it (`client.pool(chain, address).pool`) — only these fields are used */
+export interface PoolInfo {
+    chain: string;
+    address: string;
+    dex: string;
+    token0: string;
+    token1: string;
+    decimals0: number;
+    decimals1: number;
+    fee: number;
+    tickSpacing: number;
+    pairClass?: string;
+}
+export interface AddOptions {
+    /** the wallet that pays and receives the position */
+    owner: Address;
+    /** what to put in, in raw units; give one side and the other is computed for the range at the current price */
+    amount0?: bigint;
+    amount1?: bigint;
+    /** half-width of the range in basis points of price around the current price (500 = ±5%); 0 = full range */
+    rangeBp: number;
+    /** the largest price move tolerated before the transaction lands (default 50 = 0.5%) */
+    slippageBps?: number;
+    /** pay this side in the chain's native coin (it must be the wrapped native token) */
+    nativeSide?: 0 | 1 | null;
+    /** seconds until the mint expires (default 20 minutes) */
+    deadlineS?: number;
+}
+/** a transaction of a plan, bound to the chain and the account it was planned for (sendPlan checks both) */
+export interface PlanCall extends Call {
+    chainId: number;
+    from: Address;
+}
+export interface AddPlan extends Omit<MintPlan, 'approvals' | 'mint'> {
+    approvals: PlanCall[];
+    mint: PlanCall;
+    amount0: bigint;
+    amount1: bigint;
+    deadline: number;
+}
+/** the approvals (exact amounts) and the mint for adding liquidity now, read from the chain */
+export declare function planAddLiquidity(client: PublicClient, pool: PoolInfo, o: AddOptions): Promise<AddPlan>;
+export interface WalletPosition extends Position {
+    chain: string;
+    dex: string;
+    npm: Address;
+    pool: Address;
+}
+/**
+ * The wallet's positions on one chain's position managers that still hold liquidity or fees, each with its pool
+ * (from the manager's factory). Positions staked in a Slipstream gauge belong to the gauge and are not listed.
+ */
+export declare function positions(client: PublicClient, chain: string, owner: Address): Promise<WalletPosition[]>;
+/** what collecting now would pay (fees owed, incl. those accrued since the last update) */
+export declare function uncollectedFees(client: PublicClient, pos: WalletPosition, owner: Address): Promise<[bigint, bigint]>;
+export interface RemoveOptions {
+    owner: Address;
+    /** basis points of the position to take out (10000 = all); 0 = collect the fees only */
+    shareBps: number;
+    slippageBps?: number;
+    deadlineS?: number;
+    /**
+     * the block of your previous removal from this position (sendPlan's result): the position is read at a block at
+     * least this new, else StaleRead — a lagging RPC must never return the liquidity from before it (a repeated partial
+     * removal would take the original share again)
+     */
+    minBlock?: bigint;
+}
+/** the RPC is behind a block this plan must see */
+export declare class StaleRead extends Error {
+    readonly head: bigint;
+    readonly minBlock: bigint;
+    constructor(head: bigint, minBlock: bigint);
+}
+export interface RemovePlan {
+    call: PlanCall;
+    liquidity: bigint;
+    amount0: bigint;
+    amount1: bigint;
+    amount0Min: bigint;
+    amount1Min: bigint;
+    deadline: number;
+}
+/**
+ * One transaction: decrease `shareBps` of what the position holds NOW (read from the chain) and collect it all —
+ * principal and fees — to the owner. A repeated partial removal would take that share again: send it once.
+ */
+export declare function planRemoveLiquidity(client: PublicClient, pos: WalletPosition, o: RemoveOptions): Promise<RemovePlan>;
+export interface SwapOptions {
+    /** the wallet that pays and receives */
+    owner: Address;
+    /** the pool token paid in (0 = token0, 1 = token1); the other one is bought */
+    fromSide: 0 | 1;
+    /** how much is paid in, raw units */
+    amountIn: bigint;
+    /** pay in / receive the chain's native coin instead of that side's wrapped token */
+    fromNative?: boolean;
+    toNative?: boolean;
+    /** the price move tolerated (default 50 = 0.5%) */
+    slippageBps?: number;
+    /** the least the swap must deliver (e.g. the shortfall it is for): refused (SwapRefused 'moved') below it */
+    minOut?: bigint;
+    /** seconds until it expires (default 10 minutes): send the plan right away, quotes move */
+    deadlineS?: number;
+}
+export interface SwapPlan {
+    /** an exact approval of the aggregator's router, if the allowance is short (none for a native input) */
+    approvals: PlanCall[];
+    swap: PlanCall;
+    amountIn: bigint;
+    quoteOut: bigint;
+    /** what the router guarantees to deliver or it reverts */
+    minReturn: bigint;
+    /** LPSignal's fee, bps of the input */
+    feeBps: number;
+    /** simulated from the owner before returning (not when an approval must land first) */
+    simulated: boolean;
+    deadline: number;
+}
+/**
+ * A swap between the pool's two tokens through the KyberSwap aggregator, with LPSignal's fee. The aggregator's answers
+ * are checked, never trusted: the quote must be within the allowed impact of the pool's own price (SwapRefused
+ * 'impact'), and the calldata is decoded — router, swap() only, tokens, amount, value, recipient = owner, exactly our
+ * fee, flags, no permit, the split, and a minimum no lower than the pool-price floor, `minOut` and the quote less the
+ * slippage (SwapRefused 'calldata'); then simulated (SwapRefused 'simulation'). The router itself pays at least that
+ * minimum or reverts. Send it with sendPlan; a swap's deadline is in calldata nobody can check, so a send of unknown
+ * outcome must be resolved by its own transaction before swapping again (sendPlan blocks the account meanwhile).
+ */
+export declare function planSwap(client: PublicClient, pool: PoolInfo, o: SwapOptions): Promise<SwapPlan>;
+/** a transaction was sent but its receipt was not seen in time: it may still land — do not send it again blindly */
+export declare class TxPending extends Error {
+    readonly hash: Hex;
+    constructor(hash: Hex, cause?: unknown);
+}
+/** a transaction that landed and reverted */
+export declare class TxReverted extends Error {
+    readonly hash: Hex;
+    constructor(hash: Hex);
+}
+/**
+ * the wallet failed while sending, without saying whether the transaction went out (no hash): it may have been
+ * broadcast. Check whether `nonce` of `from` was used (your wallet's history, or the account's nonce on chain) before
+ * sending anything again.
+ */
+export declare class TxUnknown extends Error {
+    readonly from: Address;
+    readonly nonce: number | null;
+    /** `nonce` null = the account's nonce manager chose it: check the wallet's history */
+    constructor(from: Address, nonce: number | null, cause: unknown);
+}
+/**
+ * After a send of unknown outcome (TxUnknown, TxPending) or one replaced in the wallet (TxReplaced) nothing more is sent from that account on that chain in this
+ * process until you have checked what became of it and call `unblock` — a queued plan would otherwise read the same
+ * nonce and replace or duplicate it.
+ */
+export declare class AccountBlocked extends Error {
+    readonly chainId: number;
+    readonly account: Address;
+    readonly reason: Error;
+    constructor(chainId: number, account: Address, reason: Error);
+}
+/** you checked the transaction that made sending from this account unsafe: sending may go on */
+export declare function unblock(chainId: number, account: Address): void;
+/** a transaction cancelled or replaced by a different one in the wallet: the plan stops (a speed-up is fine) */
+export declare class TxReplaced extends Error {
+    readonly hash: Hex;
+    readonly reason: 'cancelled' | 'replaced';
+    readonly replacement: Hex;
+    constructor(hash: Hex, reason: 'cancelled' | 'replaced', replacement: Hex);
+}
+export interface SendOptions {
+    /** how long to wait for each receipt (default 3 min); then TxPending */
+    timeoutMs?: number;
+    /**
+     * also wait until each transaction's block is finalized and still canonical before the next one / returning
+     * (recommended before another PARTIAL removal from the same position: a reorg could otherwise drop the first one
+     * while the second reads the old liquidity, and both land)
+     */
+    finalized?: boolean;
+}
+/**
+ * Sends a plan's calls in order from your wallet, each after the previous one's receipt (approvals before the mint).
+ * Every call must be for the chain and the account the wallet is on (refused otherwise). Returns each one's hash and
+ * block (pass the last block as `minBlock` to your next removal from the same position). Throws TxReverted, TxReplaced
+ * (cancelled or replaced in the wallet; a speed-up of the same call is accepted), or TxPending if a receipt is not seen.
+ */
+export declare function sendPlan(wallet: WalletClient, client: PublicClient, calls: PlanCall[], opts?: SendOptions): Promise<{
+    hash: Hex;
+    blockNumber: bigint;
+}[]>;