@rabby-wallet/staking-sdk 0.1.0-alpha.0

package/dist/protocols/univ3/math.js

@@ -0,0 +1,219 @@
+import { InvalidQuoteError, InvalidTickError } from '../../core/errors.js';
+import { MAX_UINT128, parseRawUint128, parseRawUint160, parseRawUint256, } from '../../core/utils/abi.js';
+import { UNIV3_MAX_TICK, UNIV3_MIN_TICK } from './ticks.js';
+// Dependency-free port of the small Uniswap V3 math surface needed for previews.
+// Keep this file limited to tick, sqrt-price, liquidity, and amount conversions.
+export const Q96 = 2n ** 96n;
+export const UNIV3_MIN_SQRT_RATIO = 4295128739n;
+export const UNIV3_MAX_SQRT_RATIO = 1461446703485210103287273052203988822378723970342n;
+const MAX_UINT256 = (1n << 256n) - 1n;
+const mulDivRoundingUp = (multiplicand, multiplier, denominator) => {
+    if (denominator === 0n) {
+        throw new InvalidQuoteError('Division by zero');
+    }
+    const product = multiplicand * multiplier;
+    const result = product / denominator;
+    return product % denominator === 0n ? result : result + 1n;
+};
+const divRoundingUp = (numerator, denominator) => {
+    if (denominator === 0n) {
+        throw new InvalidQuoteError('Division by zero');
+    }
+    const result = numerator / denominator;
+    return numerator % denominator === 0n ? result : result + 1n;
+};
+const sortSqrtRatios = (sqrtRatioAX96, sqrtRatioBX96) => {
+    const sqrtA = parseUniv3SqrtPriceX96(sqrtRatioAX96);
+    const sqrtB = parseUniv3SqrtPriceX96(sqrtRatioBX96);
+    return sqrtA <= sqrtB ? [sqrtA, sqrtB] : [sqrtB, sqrtA];
+};
+export const parseUniv3SqrtPriceX96 = (value) => {
+    const parsed = parseRawUint160(value);
+    if (parsed < UNIV3_MIN_SQRT_RATIO || parsed > UNIV3_MAX_SQRT_RATIO) {
+        throw new InvalidQuoteError(`V3 sqrtPriceX96 is out of bounds: ${parsed}`);
+    }
+    return parsed;
+};
+export const getSqrtRatioAtUniv3Tick = (tick) => {
+    if (!Number.isInteger(tick) || tick < UNIV3_MIN_TICK || tick > UNIV3_MAX_TICK) {
+        throw new InvalidTickError(`Invalid V3 tick: ${tick}`);
+    }
+    const absTick = tick < 0 ? -tick : tick;
+    let ratio = (absTick & 0x1) !== 0
+        ? 0xfffcb933bd6fad37aa2d162d1a594001n
+        : 0x100000000000000000000000000000000n;
+    if ((absTick & 0x2) !== 0) {
+        ratio = (ratio * 0xfff97272373d413259a46990580e213an) >> 128n;
+    }
+    if ((absTick & 0x4) !== 0) {
+        ratio = (ratio * 0xfff2e50f5f656932ef12357cf3c7fdccn) >> 128n;
+    }
+    if ((absTick & 0x8) !== 0) {
+        ratio = (ratio * 0xffe5caca7e10e4e61c3624eaa0941cd0n) >> 128n;
+    }
+    if ((absTick & 0x10) !== 0) {
+        ratio = (ratio * 0xffcb9843d60f6159c9db58835c926644n) >> 128n;
+    }
+    if ((absTick & 0x20) !== 0) {
+        ratio = (ratio * 0xff973b41fa98c081472e6896dfb254c0n) >> 128n;
+    }
+    if ((absTick & 0x40) !== 0) {
+        ratio = (ratio * 0xff2ea16466c96a3843ec78b326b52861n) >> 128n;
+    }
+    if ((absTick & 0x80) !== 0) {
+        ratio = (ratio * 0xfe5dee046a99a2a811c461f1969c3053n) >> 128n;
+    }
+    if ((absTick & 0x100) !== 0) {
+        ratio = (ratio * 0xfcbe86c7900a88aedcffc83b479aa3a4n) >> 128n;
+    }
+    if ((absTick & 0x200) !== 0) {
+        ratio = (ratio * 0xf987a7253ac413176f2b074cf7815e54n) >> 128n;
+    }
+    if ((absTick & 0x400) !== 0) {
+        ratio = (ratio * 0xf3392b0822b70005940c7a398e4b70f3n) >> 128n;
+    }
+    if ((absTick & 0x800) !== 0) {
+        ratio = (ratio * 0xe7159475a2c29b7443b29c7fa6e889d9n) >> 128n;
+    }
+    if ((absTick & 0x1000) !== 0) {
+        ratio = (ratio * 0xd097f3bdfd2022b8845ad8f792aa5825n) >> 128n;
+    }
+    if ((absTick & 0x2000) !== 0) {
+        ratio = (ratio * 0xa9f746462d870fdf8a65dc1f90e061e5n) >> 128n;
+    }
+    if ((absTick & 0x4000) !== 0) {
+        ratio = (ratio * 0x70d869a156d2a1b890bb3df62baf32f7n) >> 128n;
+    }
+    if ((absTick & 0x8000) !== 0) {
+        ratio = (ratio * 0x31be135f97d08fd981231505542fcfa6n) >> 128n;
+    }
+    if ((absTick & 0x10000) !== 0) {
+        ratio = (ratio * 0x9aa508b5b7a84e1c677de54f3e99bc9n) >> 128n;
+    }
+    if ((absTick & 0x20000) !== 0) {
+        ratio = (ratio * 0x5d6af8dedb81196699c329225ee604n) >> 128n;
+    }
+    if ((absTick & 0x40000) !== 0) {
+        ratio = (ratio * 0x2216e584f5fa1ea926041bedfe98n) >> 128n;
+    }
+    if ((absTick & 0x80000) !== 0) {
+        ratio = (ratio * 0x48a170391f7dc42444e8fa2n) >> 128n;
+    }
+    if (tick > 0) {
+        ratio = MAX_UINT256 / ratio;
+    }
+    const remainder = ratio % (1n << 32n);
+    return (ratio >> 32n) + (remainder === 0n ? 0n : 1n);
+};
+export const getUniv3Amount0Delta = ({ sqrtRatioAX96, sqrtRatioBX96, liquidity, roundUp = false, }) => {
+    const [sqrtA, sqrtB] = sortSqrtRatios(sqrtRatioAX96, sqrtRatioBX96);
+    const parsedLiquidity = parseRawUint128(liquidity);
+    if (sqrtA === 0n) {
+        throw new InvalidQuoteError('V3 sqrt price cannot be zero');
+    }
+    const numerator1 = parsedLiquidity << 96n;
+    const numerator2 = sqrtB - sqrtA;
+    if (roundUp) {
+        return divRoundingUp(mulDivRoundingUp(numerator1, numerator2, sqrtB), sqrtA);
+    }
+    return ((numerator1 * numerator2) / sqrtB) / sqrtA;
+};
+export const getUniv3Amount1Delta = ({ sqrtRatioAX96, sqrtRatioBX96, liquidity, roundUp = false, }) => {
+    const [sqrtA, sqrtB] = sortSqrtRatios(sqrtRatioAX96, sqrtRatioBX96);
+    const parsedLiquidity = parseRawUint128(liquidity);
+    const delta = sqrtB - sqrtA;
+    return roundUp
+        ? mulDivRoundingUp(parsedLiquidity, delta, Q96)
+        : (parsedLiquidity * delta) / Q96;
+};
+export const getUniv3LiquidityForAmount0 = ({ sqrtRatioAX96, sqrtRatioBX96, amount0, }) => {
+    const [sqrtA, sqrtB] = sortSqrtRatios(sqrtRatioAX96, sqrtRatioBX96);
+    const parsedAmount0 = parseRawUint256(amount0);
+    const intermediate = (sqrtA * sqrtB) / Q96;
+    return (parsedAmount0 * intermediate) / (sqrtB - sqrtA);
+};
+export const getUniv3LiquidityForAmount1 = ({ sqrtRatioAX96, sqrtRatioBX96, amount1, }) => {
+    const [sqrtA, sqrtB] = sortSqrtRatios(sqrtRatioAX96, sqrtRatioBX96);
+    const parsedAmount1 = parseRawUint256(amount1);
+    return (parsedAmount1 * Q96) / (sqrtB - sqrtA);
+};
+export const getUniv3LiquidityForAmounts = ({ sqrtRatioX96, sqrtRatioAX96, sqrtRatioBX96, amount0, amount1, }) => {
+    const sqrtX = parseUniv3SqrtPriceX96(sqrtRatioX96);
+    const [sqrtA, sqrtB] = sortSqrtRatios(sqrtRatioAX96, sqrtRatioBX96);
+    const parsedAmount0 = parseRawUint256(amount0);
+    const parsedAmount1 = parseRawUint256(amount1);
+    let liquidity;
+    if (sqrtX <= sqrtA) {
+        liquidity = getUniv3LiquidityForAmount0({
+            sqrtRatioAX96: sqrtA,
+            sqrtRatioBX96: sqrtB,
+            amount0: parsedAmount0,
+        });
+    }
+    else if (sqrtX < sqrtB) {
+        const liquidity0 = getUniv3LiquidityForAmount0({
+            sqrtRatioAX96: sqrtX,
+            sqrtRatioBX96: sqrtB,
+            amount0: parsedAmount0,
+        });
+        const liquidity1 = getUniv3LiquidityForAmount1({
+            sqrtRatioAX96: sqrtA,
+            sqrtRatioBX96: sqrtX,
+            amount1: parsedAmount1,
+        });
+        liquidity = liquidity0 < liquidity1 ? liquidity0 : liquidity1;
+    }
+    else {
+        liquidity = getUniv3LiquidityForAmount1({
+            sqrtRatioAX96: sqrtA,
+            sqrtRatioBX96: sqrtB,
+            amount1: parsedAmount1,
+        });
+    }
+    if (liquidity > MAX_UINT128) {
+        throw new InvalidQuoteError(`V3 liquidity exceeds uint128: ${liquidity}`);
+    }
+    return liquidity;
+};
+export const getUniv3AmountsForLiquidity = ({ sqrtRatioX96, sqrtRatioAX96, sqrtRatioBX96, liquidity, roundUp = false, }) => {
+    const sqrtX = parseUniv3SqrtPriceX96(sqrtRatioX96);
+    const [sqrtA, sqrtB] = sortSqrtRatios(sqrtRatioAX96, sqrtRatioBX96);
+    const parsedLiquidity = parseRawUint128(liquidity);
+    if (sqrtX <= sqrtA) {
+        return {
+            amount0: getUniv3Amount0Delta({
+                sqrtRatioAX96: sqrtA,
+                sqrtRatioBX96: sqrtB,
+                liquidity: parsedLiquidity,
+                roundUp,
+            }),
+            amount1: 0n,
+        };
+    }
+    if (sqrtX < sqrtB) {
+        return {
+            amount0: getUniv3Amount0Delta({
+                sqrtRatioAX96: sqrtX,
+                sqrtRatioBX96: sqrtB,
+                liquidity: parsedLiquidity,
+                roundUp,
+            }),
+            amount1: getUniv3Amount1Delta({
+                sqrtRatioAX96: sqrtA,
+                sqrtRatioBX96: sqrtX,
+                liquidity: parsedLiquidity,
+                roundUp,
+            }),
+        };
+    }
+    return {
+        amount0: 0n,
+        amount1: getUniv3Amount1Delta({
+            sqrtRatioAX96: sqrtA,
+            sqrtRatioBX96: sqrtB,
+            liquidity: parsedLiquidity,
+            roundUp,
+        }),
+    };
+};
+//# sourceMappingURL=math.js.map

package/dist/protocols/univ3/math.js.map

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

package/dist/protocols/univ3/quote.d.ts

@@ -0,0 +1,117 @@
+export type Univ3RangePreset = '10%' | '20%' | '40%';
+export type Univ3PresetRangeMode = 'each-side' | 'total-width';
+export interface Univ3QuotePoolState {
+    tickCurrent: number;
+    tickSpacing: number;
+    sqrtPriceX96: string | bigint;
+    liquidity?: string | bigint;
+    token0?: string;
+    token1?: string;
+    fee?: string | number | bigint;
+}
+export interface Univ3RangeTickQuote {
+    tickLower: number;
+    tickUpper: number;
+    tickLowerRaw: number;
+    tickUpperRaw: number;
+    lowerBps: number;
+    upperBps: number;
+    mode: Univ3PresetRangeMode | 'amount-ratio';
+}
+export interface QuoteUniv3LiquidityParams {
+    poolState: Univ3QuotePoolState;
+    amount0Desired: string | bigint;
+    amount1Desired: string | bigint;
+    tickLower: number;
+    tickUpper: number;
+    slippageBps?: number;
+}
+export interface QuoteUniv3RangeDepositParams {
+    poolState: Univ3QuotePoolState;
+    amount0Desired: string | bigint;
+    amount1Desired: string | bigint;
+    rangeStrategy: Univ3RangeStrategy;
+    slippageBps?: number;
+}
+export type Univ3RangeStrategy = {
+    type: 'preset';
+    preset: Univ3RangePreset;
+    mode?: Univ3PresetRangeMode;
+} | {
+    type: 'amount-ratio';
+    constraints?: Univ3AmountRatioRangeConstraints;
+};
+export interface Univ3AmountRatioRangeConstraints {
+    mustIncludeCurrentPrice?: boolean;
+    targetWidthBps?: number;
+    maxWidthBps?: number;
+    minWidthBps?: number;
+    searchStepBps?: number;
+}
+export interface Univ3LiquidityQuote {
+    tickLower: number;
+    tickUpper: number;
+    liquidity: bigint;
+    amount0: bigint;
+    amount1: bigint;
+    amount0Desired: bigint;
+    amount1Desired: bigint;
+    amount0Unused: bigint;
+    amount1Unused: bigint;
+    amount0Min: bigint;
+    amount1Min: bigint;
+    mintParams: {
+        tickLower: number;
+        tickUpper: number;
+        amount0Desired: string;
+        amount1Desired: string;
+        amount0Min: string;
+        amount1Min: string;
+    };
+    increaseLiquidityParams: {
+        amount0Desired: string;
+        amount1Desired: string;
+        amount0Min: string;
+        amount1Min: string;
+    };
+}
+export interface Univ3RangeDepositQuote extends Univ3LiquidityQuote {
+    range: Univ3RangeTickQuote;
+}
+export interface QuoteUniv3DecreaseLiquidityParams {
+    poolState: Univ3QuotePoolState;
+    tickLower: number;
+    tickUpper: number;
+    liquidity: string | bigint;
+    slippageBps?: number;
+    tokensOwed0?: string | bigint;
+    tokensOwed1?: string | bigint;
+}
+export interface Univ3DecreaseLiquidityQuote {
+    tickLower: number;
+    tickUpper: number;
+    liquidity: bigint;
+    amount0: bigint;
+    amount1: bigint;
+    amount0Min: bigint;
+    amount1Min: bigint;
+    tokensOwed0: bigint;
+    tokensOwed1: bigint;
+    estimatedCollectAmount0: bigint;
+    estimatedCollectAmount1: bigint;
+    decreaseLiquidityParams: {
+        liquidity: string;
+        amount0Min: string;
+        amount1Min: string;
+    };
+}
+export declare const getUniv3PresetRangeTicks: ({ tickCurrent, tickSpacing, preset, mode, }: {
+    tickCurrent: number;
+    tickSpacing: number;
+    preset: Univ3RangePreset;
+    mode?: Univ3PresetRangeMode;
+}) => Univ3RangeTickQuote;
+export declare const quoteUniv3Liquidity: ({ poolState, amount0Desired, amount1Desired, tickLower, tickUpper, slippageBps, }: QuoteUniv3LiquidityParams) => Univ3LiquidityQuote;
+export declare const quoteUniv3RangeDeposit: ({ poolState, amount0Desired, amount1Desired, rangeStrategy, slippageBps, }: QuoteUniv3RangeDepositParams) => Univ3RangeDepositQuote;
+export declare const quoteUniv3DecreaseLiquidity: ({ poolState, tickLower, tickUpper, liquidity, slippageBps, tokensOwed0, tokensOwed1, }: QuoteUniv3DecreaseLiquidityParams) => Univ3DecreaseLiquidityQuote;
+//# sourceMappingURL=quote.d.ts.map

package/dist/protocols/univ3/quote.d.ts.map

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

package/dist/protocols/univ3/quote.js

@@ -0,0 +1,315 @@
+import { InvalidQuoteError, InvalidTickError } from '../../core/errors.js';
+import { parseRawUint128, parseRawUint256, } from '../../core/utils/abi.js';
+import { getSqrtRatioAtUniv3Tick, getUniv3AmountsForLiquidity, getUniv3LiquidityForAmounts, parseUniv3SqrtPriceX96, } from './math.js';
+import { assertUniv3TickRange, getUniv3UsableTickCeil, getUniv3UsableTickFloor, } from './ticks.js';
+const BPS_DENOMINATOR = 10000n;
+const LN_1_0001 = Math.log(1.0001);
+const presetToBps = (preset) => {
+    switch (preset) {
+        case '10%':
+            return 1_000;
+        case '20%':
+            return 2_000;
+        case '40%':
+            return 4_000;
+        default:
+            throw new InvalidQuoteError(`Unsupported V3 range preset: ${preset}`);
+    }
+};
+const parseBps = (label, value, fallback) => {
+    const parsed = value ?? fallback;
+    if (!Number.isInteger(parsed) || parsed < 0 || parsed > 10_000) {
+        throw new InvalidQuoteError(`Invalid ${label}: ${String(parsed)}`);
+    }
+    return parsed;
+};
+const parsePositiveBps = (label, value, fallback) => {
+    const parsed = parseBps(label, value, fallback);
+    if (parsed <= 0) {
+        throw new InvalidQuoteError(`${label} must be greater than zero`);
+    }
+    return parsed;
+};
+const parseSlippageBps = (value) => {
+    const parsed = parseBps('slippageBps', value, 0);
+    return BigInt(parsed);
+};
+const applySlippage = (amount, slippageBps) => (amount * (BPS_DENOMINATOR - slippageBps)) / BPS_DENOMINATOR;
+const assertTickCurrent = (tickCurrent) => {
+    if (!Number.isInteger(tickCurrent)) {
+        throw new InvalidQuoteError(`Invalid V3 current tick: ${tickCurrent}`);
+    }
+};
+const targetTicksFromBps = ({ tickCurrent, tickSpacing, lowerBps, upperBps, }) => {
+    assertTickCurrent(tickCurrent);
+    if (lowerBps <= 0 || lowerBps >= 10_000) {
+        throw new InvalidQuoteError(`Invalid lowerBps: ${lowerBps}`);
+    }
+    if (upperBps <= 0) {
+        throw new InvalidQuoteError(`Invalid upperBps: ${upperBps}`);
+    }
+    const lowerMultiplier = 1 - lowerBps / 10_000;
+    const upperMultiplier = 1 + upperBps / 10_000;
+    const tickLowerRaw = Math.floor(tickCurrent + Math.log(lowerMultiplier) / LN_1_0001);
+    const tickUpperRaw = Math.ceil(tickCurrent + Math.log(upperMultiplier) / LN_1_0001);
+    const tickLower = getUniv3UsableTickFloor(tickLowerRaw, tickSpacing);
+    const tickUpper = getUniv3UsableTickCeil(tickUpperRaw, tickSpacing);
+    assertUniv3TickRange({ tickLower, tickUpper, tickSpacing });
+    return {
+        tickLower,
+        tickUpper,
+        tickLowerRaw,
+        tickUpperRaw,
+        lowerBps,
+        upperBps,
+        mode: 'amount-ratio',
+    };
+};
+const amountUsedIsWithinDesired = ({ amount0, amount1, desired0, desired1, }) => amount0 <= desired0 && amount1 <= desired1;
+const quoteLiquidityForParsedAmounts = ({ poolState, desired0, desired1, tickLower, tickUpper, slippageBps, }) => {
+    assertUniv3TickRange({
+        tickLower,
+        tickUpper,
+        tickSpacing: poolState.tickSpacing,
+    });
+    const sqrtPriceX96 = parseUniv3SqrtPriceX96(poolState.sqrtPriceX96);
+    const sqrtRatioAX96 = getSqrtRatioAtUniv3Tick(tickLower);
+    const sqrtRatioBX96 = getSqrtRatioAtUniv3Tick(tickUpper);
+    let liquidity = getUniv3LiquidityForAmounts({
+        sqrtRatioX96: sqrtPriceX96,
+        sqrtRatioAX96,
+        sqrtRatioBX96,
+        amount0: desired0,
+        amount1: desired1,
+    });
+    if (liquidity === 0n) {
+        throw new InvalidQuoteError('V3 liquidity quote is zero');
+    }
+    let amounts = getUniv3AmountsForLiquidity({
+        sqrtRatioX96: sqrtPriceX96,
+        sqrtRatioAX96,
+        sqrtRatioBX96,
+        liquidity,
+        roundUp: true,
+    });
+    let guard = 0;
+    while (liquidity > 0n &&
+        !amountUsedIsWithinDesired({
+            amount0: amounts.amount0,
+            amount1: amounts.amount1,
+            desired0,
+            desired1,
+        })) {
+        liquidity -= 1n;
+        amounts = getUniv3AmountsForLiquidity({
+            sqrtRatioX96: sqrtPriceX96,
+            sqrtRatioAX96,
+            sqrtRatioBX96,
+            liquidity,
+            roundUp: true,
+        });
+        guard += 1;
+        if (guard > 256) {
+            throw new InvalidQuoteError('Unable to fit V3 liquidity into desired amounts');
+        }
+    }
+    if (liquidity === 0n) {
+        throw new InvalidQuoteError('V3 liquidity quote is zero');
+    }
+    const amount0Min = applySlippage(amounts.amount0, slippageBps);
+    const amount1Min = applySlippage(amounts.amount1, slippageBps);
+    return {
+        tickLower,
+        tickUpper,
+        liquidity,
+        amount0: amounts.amount0,
+        amount1: amounts.amount1,
+        amount0Desired: desired0,
+        amount1Desired: desired1,
+        amount0Unused: desired0 > amounts.amount0 ? desired0 - amounts.amount0 : 0n,
+        amount1Unused: desired1 > amounts.amount1 ? desired1 - amounts.amount1 : 0n,
+        amount0Min,
+        amount1Min,
+        mintParams: {
+            tickLower,
+            tickUpper,
+            amount0Desired: amounts.amount0.toString(),
+            amount1Desired: amounts.amount1.toString(),
+            amount0Min: amount0Min.toString(),
+            amount1Min: amount1Min.toString(),
+        },
+        increaseLiquidityParams: {
+            amount0Desired: amounts.amount0.toString(),
+            amount1Desired: amounts.amount1.toString(),
+            amount0Min: amount0Min.toString(),
+            amount1Min: amount1Min.toString(),
+        },
+    };
+};
+export const getUniv3PresetRangeTicks = ({ tickCurrent, tickSpacing, preset, mode = 'each-side', }) => {
+    const presetBps = presetToBps(preset);
+    const sideBps = mode === 'total-width' ? presetBps / 2 : presetBps;
+    const range = targetTicksFromBps({
+        tickCurrent,
+        tickSpacing,
+        lowerBps: sideBps,
+        upperBps: sideBps,
+    });
+    return {
+        ...range,
+        mode,
+    };
+};
+export const quoteUniv3Liquidity = ({ poolState, amount0Desired, amount1Desired, tickLower, tickUpper, slippageBps, }) => {
+    const desired0 = parseRawUint256(amount0Desired);
+    const desired1 = parseRawUint256(amount1Desired);
+    if (desired0 === 0n && desired1 === 0n) {
+        throw new InvalidQuoteError('V3 quote requires a non-zero desired amount');
+    }
+    return quoteLiquidityForParsedAmounts({
+        poolState,
+        desired0,
+        desired1,
+        tickLower,
+        tickUpper,
+        slippageBps: parseSlippageBps(slippageBps),
+    });
+};
+const quoteAmountRatioRange = ({ poolState, desired0, desired1, constraints, slippageBps, }) => {
+    const mustIncludeCurrentPrice = constraints?.mustIncludeCurrentPrice ?? true;
+    if (!mustIncludeCurrentPrice) {
+        throw new InvalidQuoteError('amount-ratio ranges outside the current price are not supported yet');
+    }
+    const targetWidthBps = parsePositiveBps('targetWidthBps', constraints?.targetWidthBps, constraints?.maxWidthBps ?? 4_000);
+    const maxWidthBps = parsePositiveBps('maxWidthBps', constraints?.maxWidthBps, targetWidthBps);
+    const minWidthBps = parseBps('minWidthBps', constraints?.minWidthBps, 2);
+    const searchStepBps = parsePositiveBps('searchStepBps', constraints?.searchStepBps, Math.max(1, Math.floor(targetWidthBps / 200)));
+    if (targetWidthBps > maxWidthBps) {
+        throw new InvalidQuoteError('targetWidthBps cannot exceed maxWidthBps');
+    }
+    if (minWidthBps >= targetWidthBps) {
+        throw new InvalidQuoteError('minWidthBps must be lower than targetWidthBps');
+    }
+    let best;
+    const evaluate = (lowerBps) => {
+        const upperBps = targetWidthBps - lowerBps;
+        if (lowerBps <= 0 || upperBps <= 0)
+            return;
+        let range;
+        try {
+            range = targetTicksFromBps({
+                tickCurrent: poolState.tickCurrent,
+                tickSpacing: poolState.tickSpacing,
+                lowerBps,
+                upperBps,
+            });
+            const quote = quoteLiquidityForParsedAmounts({
+                poolState,
+                desired0,
+                desired1,
+                tickLower: range.tickLower,
+                tickUpper: range.tickUpper,
+                slippageBps,
+            });
+            const candidate = { ...quote, range };
+            if (!best || candidate.liquidity > best.liquidity) {
+                best = candidate;
+            }
+        }
+        catch (error) {
+            if (error instanceof InvalidQuoteError || error instanceof InvalidTickError)
+                return;
+            throw error;
+        }
+    };
+    for (let lowerBps = Math.max(1, minWidthBps); lowerBps <= targetWidthBps - Math.max(1, minWidthBps); lowerBps += searchStepBps) {
+        evaluate(lowerBps);
+    }
+    if (best) {
+        const bestLowerBps = best.range.lowerBps;
+        const refineStart = Math.max(1, bestLowerBps - searchStepBps);
+        const refineEnd = Math.min(targetWidthBps - 1, bestLowerBps + searchStepBps);
+        for (let lowerBps = refineStart; lowerBps <= refineEnd; lowerBps += 1) {
+            evaluate(lowerBps);
+        }
+    }
+    if (!best) {
+        throw new InvalidQuoteError('Unable to find a valid V3 amount-ratio range');
+    }
+    return best;
+};
+export const quoteUniv3RangeDeposit = ({ poolState, amount0Desired, amount1Desired, rangeStrategy, slippageBps, }) => {
+    const desired0 = parseRawUint256(amount0Desired);
+    const desired1 = parseRawUint256(amount1Desired);
+    if (desired0 === 0n && desired1 === 0n) {
+        throw new InvalidQuoteError('V3 quote requires a non-zero desired amount');
+    }
+    const parsedSlippageBps = parseSlippageBps(slippageBps);
+    if (rangeStrategy.type === 'preset') {
+        const range = getUniv3PresetRangeTicks({
+            tickCurrent: poolState.tickCurrent,
+            tickSpacing: poolState.tickSpacing,
+            preset: rangeStrategy.preset,
+            mode: rangeStrategy.mode,
+        });
+        const quote = quoteLiquidityForParsedAmounts({
+            poolState,
+            desired0,
+            desired1,
+            tickLower: range.tickLower,
+            tickUpper: range.tickUpper,
+            slippageBps: parsedSlippageBps,
+        });
+        return { ...quote, range };
+    }
+    return quoteAmountRatioRange({
+        poolState,
+        desired0,
+        desired1,
+        constraints: rangeStrategy.constraints,
+        slippageBps: parsedSlippageBps,
+    });
+};
+export const quoteUniv3DecreaseLiquidity = ({ poolState, tickLower, tickUpper, liquidity, slippageBps, tokensOwed0 = 0n, tokensOwed1 = 0n, }) => {
+    assertUniv3TickRange({
+        tickLower,
+        tickUpper,
+        tickSpacing: poolState.tickSpacing,
+    });
+    const parsedLiquidity = parseRawUint128(liquidity);
+    if (parsedLiquidity === 0n) {
+        throw new InvalidQuoteError('V3 decrease quote requires non-zero liquidity');
+    }
+    const sqrtPriceX96 = parseUniv3SqrtPriceX96(poolState.sqrtPriceX96);
+    const amounts = getUniv3AmountsForLiquidity({
+        sqrtRatioX96: sqrtPriceX96,
+        sqrtRatioAX96: getSqrtRatioAtUniv3Tick(tickLower),
+        sqrtRatioBX96: getSqrtRatioAtUniv3Tick(tickUpper),
+        liquidity: parsedLiquidity,
+        roundUp: false,
+    });
+    const parsedSlippageBps = parseSlippageBps(slippageBps);
+    const amount0Min = applySlippage(amounts.amount0, parsedSlippageBps);
+    const amount1Min = applySlippage(amounts.amount1, parsedSlippageBps);
+    const parsedTokensOwed0 = parseRawUint256(tokensOwed0);
+    const parsedTokensOwed1 = parseRawUint256(tokensOwed1);
+    return {
+        tickLower,
+        tickUpper,
+        liquidity: parsedLiquidity,
+        amount0: amounts.amount0,
+        amount1: amounts.amount1,
+        amount0Min,
+        amount1Min,
+        tokensOwed0: parsedTokensOwed0,
+        tokensOwed1: parsedTokensOwed1,
+        estimatedCollectAmount0: amounts.amount0 + parsedTokensOwed0,
+        estimatedCollectAmount1: amounts.amount1 + parsedTokensOwed1,
+        decreaseLiquidityParams: {
+            liquidity: parsedLiquidity.toString(),
+            amount0Min: amount0Min.toString(),
+            amount1Min: amount1Min.toString(),
+        },
+    };
+};
+//# sourceMappingURL=quote.js.map