@bananapus/nana-sdk-core 1.3.0 → 1.4.0

package/dist/cjs/v6/uniswapV4.js

@@ -0,0 +1,336 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNISWAP_V4_MODIFY_LIQUIDITY_TOPIC = exports.UNISWAP_V4_INITIALIZE_TOPIC = exports.UNISWAP_V4_MAX_TICK = exports.UNISWAP_V4_Q96 = exports.UNISWAP_PERMIT2_ADDRESS = exports.UNISWAP_V4_QUOTER_ADDRESSES = exports.UNISWAP_V4_POSITION_MANAGER_ADDRESSES = exports.UNISWAP_V4_POOL_MANAGER_ADDRESSES = void 0;
+exports.uniswapV4Deployment = uniswapV4Deployment;
+exports.uniswapV4PoolId = uniswapV4PoolId;
+exports.uniswapV4PoolStateSlot = uniswapV4PoolStateSlot;
+exports.uniswapV4SqrtPriceX96FromSlot0 = uniswapV4SqrtPriceX96FromSlot0;
+exports.uniswapV4PriceFromSqrtPriceX96 = uniswapV4PriceFromSqrtPriceX96;
+exports.uniswapV4SqrtPriceX96AtTick = uniswapV4SqrtPriceX96AtTick;
+exports.uniswapV4AmountsForLiquidity = uniswapV4AmountsForLiquidity;
+exports.uniswapV4LiquidityForAmounts = uniswapV4LiquidityForAmounts;
+exports.uniswapV4AlignTickDown = uniswapV4AlignTickDown;
+exports.uniswapV4AlignTickUp = uniswapV4AlignTickUp;
+exports.uniswapV4PositionTicks = uniswapV4PositionTicks;
+exports.uniswapV4CounterpartAmount = uniswapV4CounterpartAmount;
+exports.uniswapV4DefaultPriceRange = uniswapV4DefaultPriceRange;
+exports.uniswapV4PositionTokenIdFromLog = uniswapV4PositionTokenIdFromLog;
+exports.isUniswapV4PoolManager = isUniswapV4PoolManager;
+const viem_1 = require("viem");
+/**
+ * Canonical Uniswap V4 PoolManager deployments used by Juicebox v6.
+ * Optimism Sepolia is intentionally absent: deploy-all skips the Uniswap stack
+ * there because Uniswap has not published supported V4 periphery deployments.
+ */
+exports.UNISWAP_V4_POOL_MANAGER_ADDRESSES = {
+    1: "0x000000000004444c5dc75cb358380d2e3de08a90",
+    10: "0x9a13f98cb987694c9f086b1f5eb990eea8264ec3",
+    8453: "0x498581ff718922c3f8e6a244956af099b2652b2b",
+    42161: "0x360e68faccca8ca495c1b759fd9eee466db9fb32",
+    84532: "0x05e73354cfdd6745c338b50bcfdfa3aa6fa03408",
+    421614: "0xfb3e0c6f74eb1a21cc1da29aec80d2dfe6c9a317",
+    11155111: "0xe03a1074c86cfedd5c142c4f04f1a1536e203543",
+};
+/** Canonical Uniswap V4 PositionManager deployments used by Juicebox v6. */
+exports.UNISWAP_V4_POSITION_MANAGER_ADDRESSES = {
+    1: "0xbd216513d74c8cf14cf4747e6aaa6420ff64ee9e",
+    10: "0x3c3ea4b57a46241e54610e5f022e5c45859a1017",
+    8453: "0x7c5f5a4bbd8fd63184577525326123b519429bdc",
+    42161: "0xd88f38f930b7952f2db2432cb002e7abbf3dd869",
+    84532: "0x4b2c77d209d3405f41a037ec6c77f7f5b8e2ca80",
+    421614: "0xac631556d3d4019c95769033b5e719dd77124bac",
+    11155111: "0x429ba70129df741b2ca2a85bc3a2a3328e5c09b4",
+};
+/** Canonical V4Quoter deployments; missing chains must fail closed. */
+exports.UNISWAP_V4_QUOTER_ADDRESSES = {
+    1: "0x52f0e24d1c21c8a0cb1e5a5dd6198556bd9e1203",
+    10: "0x1f3131a13296fb91c90870043742c3cdbff1a8d7",
+    8453: "0x0d5e0f971ed27fbff6c2837bf31316121532048d",
+    42161: "0x3972c00f7ed4885e145823eb7c655375d275a1c5",
+    84532: "0x4a6513c898fe1b2d0e78d3b0e0a4a151589b1cba",
+    421614: "0x7de51022d70a725b508085468052e25e22b5c4c9",
+    11155111: "0x61b3f2011a92d183c7dbadbda940a7555ccf9227",
+};
+/** Permit2 is deployed at the same address on supported EVM chains. */
+exports.UNISWAP_PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+/** Resolve the supported V4 surface for a chain without guessing addresses. */
+function uniswapV4Deployment(chainId) {
+    const poolManager = exports.UNISWAP_V4_POOL_MANAGER_ADDRESSES[chainId];
+    if (!poolManager)
+        return null;
+    return {
+        poolManager,
+        positionManager: exports.UNISWAP_V4_POSITION_MANAGER_ADDRESSES[chainId] ?? null,
+        quoter: exports.UNISWAP_V4_QUOTER_ADDRESSES[chainId] ?? null,
+        permit2: exports.UNISWAP_PERMIT2_ADDRESS,
+    };
+}
+exports.UNISWAP_V4_Q96 = 1n << 96n;
+exports.UNISWAP_V4_MAX_TICK = 887_272;
+const POOL_KEY_TUPLE = [
+    {
+        type: "tuple",
+        components: [
+            { type: "address" },
+            { type: "address" },
+            { type: "uint24" },
+            { type: "int24" },
+            { type: "address" },
+        ],
+    },
+];
+/** `PoolId.unwrap(PoolIdLibrary.toId(key))`. */
+function uniswapV4PoolId(key) {
+    return (0, viem_1.keccak256)((0, viem_1.encodeAbiParameters)(POOL_KEY_TUPLE, [
+        [key.currency0, key.currency1, key.fee, key.tickSpacing, key.hooks],
+    ]));
+}
+/** Storage slot containing the pool's packed slot0 in PoolManager. */
+function uniswapV4PoolStateSlot(poolId) {
+    return (0, viem_1.keccak256)((0, viem_1.encodeAbiParameters)([{ type: "bytes32" }, { type: "uint256" }], [poolId, 6n]));
+}
+/** Extract slot0's low-160-bit sqrtPriceX96 value. */
+function uniswapV4SqrtPriceX96FromSlot0(slot0) {
+    return BigInt(slot0) & ((1n << 160n) - 1n);
+}
+/**
+ * Convert a pool sqrt price into human pair-token units per project token.
+ * Juicebox project tokens use 18 decimals.
+ */
+function uniswapV4PriceFromSqrtPriceX96(sqrtPriceX96, pairIsCurrency0, pairTokenDecimals) {
+    if (sqrtPriceX96 <= 0n)
+        return null;
+    const sqrtPrice = Number(sqrtPriceX96) / 2 ** 96;
+    const rawPrice = sqrtPrice * sqrtPrice;
+    const rawRatio = pairIsCurrency0
+        ? rawPrice > 0
+            ? 1 / rawPrice
+            : null
+        : rawPrice;
+    if (rawRatio === null)
+        return null;
+    const price = rawRatio * 10 ** (18 - pairTokenDecimals);
+    return Number.isFinite(price) && price > 0 ? price : null;
+}
+/** Exact integer port of Uniswap V4 TickMath.getSqrtPriceAtTick. */
+function uniswapV4SqrtPriceX96AtTick(tick) {
+    tick = Math.trunc(tick);
+    const absoluteTick = tick < 0 ? -tick : tick;
+    if (absoluteTick > exports.UNISWAP_V4_MAX_TICK) {
+        throw new Error("Uniswap V4 tick is outside the supported range.");
+    }
+    let price = absoluteTick & 0x1 ? 0xfffcb933bd6fad37aa2d162d1a594001n : 1n << 128n;
+    if (absoluteTick & 0x2)
+        price = (price * 0xfff97272373d413259a46990580e213an) >> 128n;
+    if (absoluteTick & 0x4)
+        price = (price * 0xfff2e50f5f656932ef12357cf3c7fdccn) >> 128n;
+    if (absoluteTick & 0x8)
+        price = (price * 0xffe5caca7e10e4e61c3624eaa0941cd0n) >> 128n;
+    if (absoluteTick & 0x10)
+        price = (price * 0xffcb9843d60f6159c9db58835c926644n) >> 128n;
+    if (absoluteTick & 0x20)
+        price = (price * 0xff973b41fa98c081472e6896dfb254c0n) >> 128n;
+    if (absoluteTick & 0x40)
+        price = (price * 0xff2ea16466c96a3843ec78b326b52861n) >> 128n;
+    if (absoluteTick & 0x80)
+        price = (price * 0xfe5dee046a99a2a811c461f1969c3053n) >> 128n;
+    if (absoluteTick & 0x100)
+        price = (price * 0xfcbe86c7900a88aedcffc83b479aa3a4n) >> 128n;
+    if (absoluteTick & 0x200)
+        price = (price * 0xf987a7253ac413176f2b074cf7815e54n) >> 128n;
+    if (absoluteTick & 0x400)
+        price = (price * 0xf3392b0822b70005940c7a398e4b70f3n) >> 128n;
+    if (absoluteTick & 0x800)
+        price = (price * 0xe7159475a2c29b7443b29c7fa6e889d9n) >> 128n;
+    if (absoluteTick & 0x1000)
+        price = (price * 0xd097f3bdfd2022b8845ad8f792aa5825n) >> 128n;
+    if (absoluteTick & 0x2000)
+        price = (price * 0xa9f746462d870fdf8a65dc1f90e061e5n) >> 128n;
+    if (absoluteTick & 0x4000)
+        price = (price * 0x70d869a156d2a1b890bb3df62baf32f7n) >> 128n;
+    if (absoluteTick & 0x8000)
+        price = (price * 0x31be135f97d08fd981231505542fcfa6n) >> 128n;
+    if (absoluteTick & 0x10000)
+        price = (price * 0x9aa508b5b7a84e1c677de54f3e99bc9n) >> 128n;
+    if (absoluteTick & 0x20000)
+        price = (price * 0x5d6af8dedb81196699c329225ee604n) >> 128n;
+    if (absoluteTick & 0x40000)
+        price = (price * 0x2216e584f5fa1ea926041bedfe98n) >> 128n;
+    if (absoluteTick & 0x80000)
+        price = (price * 0x48a170391f7dc42444e8fa2n) >> 128n;
+    if (tick > 0)
+        price = ((1n << 256n) - 1n) / price;
+    return (price + 0xffffffffn) >> 32n;
+}
+function sortSqrtPrices(a, b) {
+    return a > b ? [b, a] : [a, b];
+}
+function requireSqrtRange(a, b) {
+    if (a <= 0n || b <= 0n || a === b) {
+        throw new Error("A Uniswap V4 sqrt-price range must be positive and non-zero.");
+    }
+}
+function amount0ForLiquidity(sqrtA, sqrtB, liquidity) {
+    const [lower, upper] = sortSqrtPrices(sqrtA, sqrtB);
+    return ((liquidity << 96n) * (upper - lower)) / upper / lower;
+}
+function amount1ForLiquidity(sqrtA, sqrtB, liquidity) {
+    const [lower, upper] = sortSqrtPrices(sqrtA, sqrtB);
+    return (liquidity * (upper - lower)) / exports.UNISWAP_V4_Q96;
+}
+/** Currency amounts represented by liquidity at a current sqrt price. */
+function uniswapV4AmountsForLiquidity(currentSqrtPrice, sqrtPriceA, sqrtPriceB, liquidity) {
+    requireSqrtRange(sqrtPriceA, sqrtPriceB);
+    if (currentSqrtPrice <= 0n || liquidity < 0n) {
+        throw new Error("Uniswap V4 prices must be positive and liquidity cannot be negative.");
+    }
+    const [lower, upper] = sortSqrtPrices(sqrtPriceA, sqrtPriceB);
+    if (currentSqrtPrice <= lower) {
+        return {
+            amount0: amount0ForLiquidity(lower, upper, liquidity),
+            amount1: 0n,
+        };
+    }
+    if (currentSqrtPrice < upper) {
+        return {
+            amount0: amount0ForLiquidity(currentSqrtPrice, upper, liquidity),
+            amount1: amount1ForLiquidity(lower, currentSqrtPrice, liquidity),
+        };
+    }
+    return {
+        amount0: 0n,
+        amount1: amount1ForLiquidity(lower, upper, liquidity),
+    };
+}
+function liquidityForAmount0(sqrtA, sqrtB, amount0) {
+    const [lower, upper] = sortSqrtPrices(sqrtA, sqrtB);
+    return (amount0 * ((lower * upper) / exports.UNISWAP_V4_Q96)) / (upper - lower);
+}
+function liquidityForAmount1(sqrtA, sqrtB, amount1) {
+    const [lower, upper] = sortSqrtPrices(sqrtA, sqrtB);
+    return (amount1 * exports.UNISWAP_V4_Q96) / (upper - lower);
+}
+/** Maximum liquidity supported by two token amounts over a range. */
+function uniswapV4LiquidityForAmounts(currentSqrtPrice, sqrtPriceA, sqrtPriceB, amount0, amount1) {
+    requireSqrtRange(sqrtPriceA, sqrtPriceB);
+    if (currentSqrtPrice <= 0n || amount0 < 0n || amount1 < 0n) {
+        throw new Error("Uniswap V4 prices must be positive and amounts cannot be negative.");
+    }
+    const [lower, upper] = sortSqrtPrices(sqrtPriceA, sqrtPriceB);
+    if (currentSqrtPrice <= lower) {
+        return liquidityForAmount0(lower, upper, amount0);
+    }
+    if (currentSqrtPrice < upper) {
+        const liquidity0 = liquidityForAmount0(currentSqrtPrice, upper, amount0);
+        const liquidity1 = liquidityForAmount1(lower, currentSqrtPrice, amount1);
+        return liquidity0 < liquidity1 ? liquidity0 : liquidity1;
+    }
+    return liquidityForAmount1(lower, upper, amount1);
+}
+function requireTickSpacing(spacing) {
+    if (!Number.isInteger(spacing) || spacing <= 0) {
+        throw new Error("Uniswap V4 tick spacing must be a positive integer.");
+    }
+}
+function requireIntegerTick(tick) {
+    if (!Number.isInteger(tick)) {
+        throw new Error("A Uniswap V4 tick must be an integer.");
+    }
+}
+/** Align a tick down to its nearest usable tick. */
+function uniswapV4AlignTickDown(tick, spacing) {
+    requireTickSpacing(spacing);
+    requireIntegerTick(tick);
+    let remainder = tick % spacing;
+    if (remainder !== 0 && tick < 0)
+        remainder += spacing;
+    return tick - remainder;
+}
+/** Align a tick up to its nearest usable tick. */
+function uniswapV4AlignTickUp(tick, spacing) {
+    requireTickSpacing(spacing);
+    requireIntegerTick(tick);
+    return uniswapV4AlignTickDown(tick + spacing - 1, spacing);
+}
+function signExtend24(value) {
+    return Number(value & 0x800000n ? value - 0x1000000n : value);
+}
+/** Decode PositionManager's packed lower and upper ticks. */
+function uniswapV4PositionTicks(positionInfo) {
+    return {
+        lower: signExtend24((positionInfo >> 8n) & 0xffffffn),
+        upper: signExtend24((positionInfo >> 32n) & 0xffffffn),
+    };
+}
+/**
+ * Human-price counterpart amount for a concentrated-liquidity deposit.
+ * This float helper is for form auto-fill; transaction amounts should use the
+ * exact bigint liquidity helpers above.
+ */
+function uniswapV4CounterpartAmount(amount, inputIsPairToken, currentPrice, minPrice, maxPrice) {
+    if (!(amount > 0) ||
+        !(currentPrice > 0) ||
+        !(minPrice > 0) ||
+        !(maxPrice > minPrice)) {
+        return null;
+    }
+    const currentSqrt = Math.sqrt(currentPrice);
+    const minSqrt = Math.sqrt(minPrice);
+    const maxSqrt = Math.sqrt(maxPrice);
+    if (currentPrice <= minPrice)
+        return inputIsPairToken ? null : 0;
+    if (currentPrice >= maxPrice)
+        return inputIsPairToken ? 0 : null;
+    if (inputIsPairToken) {
+        const liquidity = amount / (currentSqrt - minSqrt);
+        return liquidity * (1 / currentSqrt - 1 / maxSqrt);
+    }
+    const liquidity = amount / (1 / currentSqrt - 1 / maxSqrt);
+    return liquidity * (currentSqrt - minSqrt);
+}
+/** Choose the economic floor/ceiling range when it brackets spot. */
+function uniswapV4DefaultPriceRange(poolPrice, cashOutFloor, issuanceCeiling) {
+    const spot = Number.isFinite(poolPrice) && poolPrice > 0 ? poolPrice : 0;
+    const floor = Number.isFinite(cashOutFloor) && cashOutFloor > 0 ? cashOutFloor : 0;
+    const ceiling = Number.isFinite(issuanceCeiling) && issuanceCeiling > 0
+        ? issuanceCeiling
+        : 0;
+    const economic = spot > 0 && floor > 0 && ceiling > floor && floor < spot && spot < ceiling;
+    let min = economic ? floor : spot > 0 ? spot / 2 : ceiling / 10;
+    let max = economic ? ceiling : spot > 0 ? spot * 2 : ceiling;
+    if (spot > 0 && (!(min > 0) || min >= spot))
+        min = spot / 2;
+    if (spot > 0 && !(max > spot))
+        max = spot * 2;
+    if (!(min > 0) && max > 0)
+        min = max / 10;
+    if (!(max > min))
+        max = min > 0 ? min * 10 : 0;
+    return { min, max, economic };
+}
+exports.UNISWAP_V4_INITIALIZE_TOPIC = (0, viem_1.toEventSelector)("Initialize(bytes32,address,address,uint24,int24,address,uint160,int24)").toLowerCase();
+exports.UNISWAP_V4_MODIFY_LIQUIDITY_TOPIC = (0, viem_1.toEventSelector)("ModifyLiquidity(bytes32,address,int24,int24,int256,bytes32)").toLowerCase();
+/** Extract the PositionManager token id (the position salt) from a pool log. */
+function uniswapV4PositionTokenIdFromLog(log, positionManager) {
+    if (String(log.topics?.[0] ?? "").toLowerCase() !==
+        exports.UNISWAP_V4_MODIFY_LIQUIDITY_TOPIC) {
+        return null;
+    }
+    const sender = String(log.topics?.[2] ?? "")
+        .slice(-40)
+        .toLowerCase();
+    if (sender !== positionManager.slice(2).toLowerCase())
+        return null;
+    const data = String(log.data ?? "");
+    if (!/^0x[0-9a-fA-F]{256}$/.test(data)) {
+        throw new Error("Malformed Uniswap V4 ModifyLiquidity log.");
+    }
+    const tokenId = BigInt(`0x${data.slice(194, 258)}`);
+    return tokenId > 0n ? tokenId : null;
+}
+/** Whether an address is one of the canonical PoolManager deployments. */
+function isUniswapV4PoolManager(address) {
+    const normalized = address.toLowerCase();
+    return Object.values(exports.UNISWAP_V4_POOL_MANAGER_ADDRESSES).some((candidate) => candidate.toLowerCase() === normalized);
+}
+//# sourceMappingURL=uniswapV4.js.map

package/dist/cjs/v6/uniswapV4.js.map

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

package/dist/cjs/v6/uniswapV4.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=uniswapV4.test.d.ts.map

package/dist/cjs/v6/uniswapV4.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswapV4.test.d.ts","sourceRoot":"","sources":["../../../src/v6/uniswapV4.test.ts"],"names":[],"mappings":""}

package/dist/cjs/v6/uniswapV4.test.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const viem_1 = require("viem");
+const vitest_1 = require("vitest");
+const uniswapV4_js_1 = require("./uniswapV4.js");
+const TOKEN = "0x00000000000000000000000000000000000000aa";
+const HOOK = "0x00000000000000000000000000000000000000cc";
+(0, vitest_1.describe)("Uniswap V4 pool primitives", () => {
+    (0, vitest_1.test)("derives stable pool ids and storage slots", () => {
+        const poolId = (0, uniswapV4_js_1.uniswapV4PoolId)({
+            currency0: viem_1.zeroAddress,
+            currency1: TOKEN,
+            fee: 10_000,
+            tickSpacing: 200,
+            hooks: HOOK,
+        });
+        (0, vitest_1.expect)(poolId).toMatch(/^0x[0-9a-f]{64}$/);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4PoolStateSlot)(poolId)).toMatch(/^0x[0-9a-f]{64}$/);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4PoolId)({
+            currency0: viem_1.zeroAddress,
+            currency1: TOKEN,
+            fee: 10_000,
+            tickSpacing: 200,
+            hooks: HOOK,
+        })).toBe(poolId);
+    });
+    (0, vitest_1.test)("extracts slot0's low 160-bit sqrt price", () => {
+        const highBits = 123n << 160n;
+        const slot = `0x${(highBits | uniswapV4_js_1.UNISWAP_V4_Q96).toString(16).padStart(64, "0")}`;
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4SqrtPriceX96FromSlot0)(slot)).toBe(uniswapV4_js_1.UNISWAP_V4_Q96);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4PriceFromSqrtPriceX96)(uniswapV4_js_1.UNISWAP_V4_Q96, false, 18)).toBe(1);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4PriceFromSqrtPriceX96)(0n, false, 18)).toBeNull();
+    });
+    (0, vitest_1.test)("fails closed on Optimism Sepolia's unsupported V4 stack", () => {
+        (0, vitest_1.expect)(Object.keys(uniswapV4_js_1.UNISWAP_V4_POOL_MANAGER_ADDRESSES)).toHaveLength(7);
+        (0, vitest_1.expect)(uniswapV4_js_1.UNISWAP_V4_POOL_MANAGER_ADDRESSES[11155420]).toBeUndefined();
+        (0, vitest_1.expect)(uniswapV4_js_1.UNISWAP_V4_POSITION_MANAGER_ADDRESSES[11155420]).toBeUndefined();
+        (0, vitest_1.expect)(uniswapV4_js_1.UNISWAP_V4_QUOTER_ADDRESSES[11155420]).toBeUndefined();
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4Deployment)(11155420)).toBeNull();
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4Deployment)(1)).toMatchObject({
+            poolManager: uniswapV4_js_1.UNISWAP_V4_POOL_MANAGER_ADDRESSES[1],
+            positionManager: uniswapV4_js_1.UNISWAP_V4_POSITION_MANAGER_ADDRESSES[1],
+            quoter: uniswapV4_js_1.UNISWAP_V4_QUOTER_ADDRESSES[1],
+        });
+        (0, vitest_1.expect)((0, uniswapV4_js_1.isUniswapV4PoolManager)(uniswapV4_js_1.UNISWAP_V4_POOL_MANAGER_ADDRESSES[1])).toBe(true);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.isUniswapV4PoolManager)(TOKEN)).toBe(false);
+    });
+});
+(0, vitest_1.describe)("Uniswap V4 tick and liquidity math", () => {
+    (0, vitest_1.test)("matches TickMath boundaries and is monotonic", () => {
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4SqrtPriceX96AtTick)(0)).toBe(uniswapV4_js_1.UNISWAP_V4_Q96);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4SqrtPriceX96AtTick)(-uniswapV4_js_1.UNISWAP_V4_MAX_TICK)).toBe(4295128739n);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4SqrtPriceX96AtTick)(uniswapV4_js_1.UNISWAP_V4_MAX_TICK)).toBe(1461446703485210103287273052203988822378723970342n);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4SqrtPriceX96AtTick)(-200)).toBeLessThan((0, uniswapV4_js_1.uniswapV4SqrtPriceX96AtTick)(200));
+        (0, vitest_1.expect)(() => (0, uniswapV4_js_1.uniswapV4SqrtPriceX96AtTick)(uniswapV4_js_1.UNISWAP_V4_MAX_TICK + 1)).toThrow(/outside/);
+    });
+    (0, vitest_1.test)("derived liquidity never consumes more than the supplied amounts", () => {
+        const current = (0, uniswapV4_js_1.uniswapV4SqrtPriceX96AtTick)(0);
+        const lower = (0, uniswapV4_js_1.uniswapV4SqrtPriceX96AtTick)(-6_000);
+        const upper = (0, uniswapV4_js_1.uniswapV4SqrtPriceX96AtTick)(6_000);
+        const amount0 = 10n ** 18n;
+        const amount1 = 10n ** 18n;
+        const liquidity = (0, uniswapV4_js_1.uniswapV4LiquidityForAmounts)(current, lower, upper, amount0, amount1);
+        const needed = (0, uniswapV4_js_1.uniswapV4AmountsForLiquidity)(current, lower, upper, liquidity);
+        (0, vitest_1.expect)(liquidity).toBeGreaterThan(0n);
+        (0, vitest_1.expect)(needed.amount0).toBeLessThanOrEqual(amount0);
+        (0, vitest_1.expect)(needed.amount1).toBeLessThanOrEqual(amount1);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4AmountsForLiquidity)(current, upper, lower, liquidity)).toEqual(needed);
+        (0, vitest_1.expect)(() => (0, uniswapV4_js_1.uniswapV4AmountsForLiquidity)(current, lower, lower, liquidity)).toThrow(/range/);
+    });
+    (0, vitest_1.test)("aligns positive and negative ticks in the correct direction", () => {
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4AlignTickDown)(250, 200)).toBe(200);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4AlignTickDown)(-250, 200)).toBe(-400);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4AlignTickUp)(250, 200)).toBe(400);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4AlignTickUp)(-250, 200)).toBe(-200);
+        (0, vitest_1.expect)(() => (0, uniswapV4_js_1.uniswapV4AlignTickDown)(1.5, 200)).toThrow(/integer/);
+    });
+    (0, vitest_1.test)("unpacks signed lower and upper position ticks", () => {
+        const lower = -600n & 0xffffffn;
+        const upper = 1200n;
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4PositionTicks)((upper << 32n) | (lower << 8n))).toEqual({
+            lower: -600,
+            upper: 1_200,
+        });
+    });
+});
+(0, vitest_1.describe)("Uniswap V4 form projections and logs", () => {
+    (0, vitest_1.test)("counterpart amounts round-trip inside a range", () => {
+        const counterpart = (0, uniswapV4_js_1.uniswapV4CounterpartAmount)(3, true, 1, 0.5, 2);
+        (0, vitest_1.expect)(counterpart).not.toBeNull();
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4CounterpartAmount)(counterpart, false, 1, 0.5, 2)).toBeCloseTo(3);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4CounterpartAmount)(3, true, 2, 0.5, 2)).toBe(0);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4CounterpartAmount)(3, false, 2, 0.5, 2)).toBeNull();
+    });
+    (0, vitest_1.test)("prefers an economic corridor only when it brackets spot", () => {
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4DefaultPriceRange)(1, 0.5, 2)).toEqual({
+            min: 0.5,
+            max: 2,
+            economic: true,
+        });
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4DefaultPriceRange)(3, 0.5, 2)).toEqual({
+            min: 1.5,
+            max: 6,
+            economic: false,
+        });
+    });
+    (0, vitest_1.test)("extracts only PositionManager-issued position salts", () => {
+        const positionManager = uniswapV4_js_1.UNISWAP_V4_POSITION_MANAGER_ADDRESSES[1];
+        const data = (0, viem_1.encodeAbiParameters)([
+            { type: "int24" },
+            { type: "int24" },
+            { type: "int256" },
+            { type: "bytes32" },
+        ], [-200, 200, 1n, (0, viem_1.pad)("0x2a", { size: 32 })]);
+        const log = {
+            topics: [
+                uniswapV4_js_1.UNISWAP_V4_MODIFY_LIQUIDITY_TOPIC,
+                viem_1.zeroHash,
+                (0, viem_1.pad)(positionManager, { size: 32 }),
+            ],
+            data,
+        };
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4PositionTokenIdFromLog)(log, positionManager)).toBe(42n);
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4PositionTokenIdFromLog)(log, TOKEN)).toBeNull();
+        (0, vitest_1.expect)((0, uniswapV4_js_1.uniswapV4PositionTokenIdFromLog)({ ...log, topics: [viem_1.zeroHash, ...log.topics.slice(1)] }, positionManager)).toBeNull();
+    });
+});
+//# sourceMappingURL=uniswapV4.test.js.map

package/dist/cjs/v6/uniswapV4.test.js.map

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

package/dist/esm/utils/index.d.ts

@@ -5,6 +5,7 @@ export * from "./deploy.js";
 export * from "./fee.js";
 export * from "./format.js";
 export * from "./hook.js";
+export * from "./ipfs.js";
 export * from "./revnet.js";
 export * from "./ruleset.js";
 export * from "./token.js";

package/dist/esm/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/esm/utils/index.js

@@ -5,6 +5,7 @@ export * from "./deploy.js";
 export * from "./fee.js";
 export * from "./format.js";
 export * from "./hook.js";
+export * from "./ipfs.js";
 export * from "./revnet.js";
 export * from "./ruleset.js";
 export * from "./token.js";

package/dist/esm/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/esm/utils/ipfs.d.ts

@@ -1,12 +1,44 @@
 export declare function ipfsGatewayUrl(cid: string | undefined, gatewayHostname?: string): string;
+/** Return an `ipfs://` URI for a CID and optional path. */
+export declare function ipfsUri(cid: string, path?: string): string;
+/** Whether a value uses the native `ipfs://` URI scheme. */
+export declare function isIpfsUri(value: string): boolean;
+/**
+ * Extract the immutable `<cid>[/path]` part of an IPFS URI or HTTP gateway URL.
+ *
+ * Both path gateways (`https://host/ipfs/<cid>`) and CID subdomain gateways
+ * (`https://<cid>.ipfs.host/path`) are recognized. Returns `null` for ordinary
+ * HTTP URLs and malformed values.
+ */
+export declare function ipfsAssetPath(value: string): string | null;
+/** Return the CID (without a path) from an IPFS URI or gateway URL. */
+export declare function cidFromIpfsUri(value: string): string | null;
+/** A lightweight CIDv0 / base32 CIDv1 shape check. */
+export declare function isIpfsCid(value: string): boolean;
 /**
  * Return a hex-encoded CID to store on-chain.
  * Hex-encoded CIDs are used to store some CIDs on-chain because they are more gas-efficient.
  */
-export declare function encodeIpfsUri(cid: string): string;
+export declare function encodeIpfsUri(cid: string): `0x${string}`;
 /**
  * Return the IPFS CID from a given hex-endoded string.
  * Hex-encoded CIDs are used to store some CIDs on-chain because they are more gas-efficient.
  */
 export declare function decodeEncodedIpfsUri(hex: string): string;
+/** Strict alias describing the on-chain representation more explicitly. */
+export declare const cidV0ToBytes32: typeof encodeIpfsUri;
+/**
+ * Decode a bytes32 sha2-256 digest into a CIDv0, returning `null` for the zero
+ * value or malformed input instead of throwing.
+ */
+export declare function bytes32ToCidV0(value: string): string | null;
+/**
+ * Decode a stored tier metadata digest into equivalent immutable URI forms.
+ *
+ * The first candidate is the conventional DAG-PB CIDv0 used by Juicebox 721
+ * metadata. The second is a raw-codec CIDv1 over the same multihash, retained
+ * as a fallback for content that was pinned with a raw block codec. Legacy
+ * 33-byte values with a leading version marker are accepted as well.
+ */
+export declare function decodeEncodedIpfsUriCandidates(value: string | undefined | null): readonly [string, string] | null;
 //# sourceMappingURL=ipfs.d.ts.map

package/dist/esm/utils/ipfs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ipfs.d.ts","sourceRoot":"","sources":["../../../src/utils/ipfs.ts"],"names":[],"mappings":"AAIA,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,UAExC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,UAQ/C"}
+{"version":3,"file":"ipfs.d.ts","sourceRoot":"","sources":["../../../src/utils/ipfs.ts"],"names":[],"mappings":"AAaA,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAIR;AAED,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwB1D;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED,sDAAsD;AACtD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKhD;AA2GD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,iBAWxC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,UAS/C;AAED,2EAA2E;AAC3E,eAAO,MAAM,cAAc,sBAAgB,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3D;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAC/B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAgBlC"}