@exponent-labs/market-three-math 0.9.13 → 0.9.14

package/build/existingPositionEqualization.d.ts

@@ -0,0 +1,63 @@
+import type { LpPositionCLMM, Ticks } from "@exponent-labs/exponent-fetcher";
+export type CrossingEqualizationDirection = "add" | "remove";
+export type CrossingEqualizationPlanStep = {
+    shareIndex: number;
+    tickIdx: number;
+    direction: CrossingEqualizationDirection;
+    shareDeltaRaw: bigint;
+    ptDelta: bigint;
+    syDelta: bigint;
+};
+export type ExistingPositionEqualization = {
+    sySpent: bigint;
+    ptSpent: bigint;
+    syReleased: bigint;
+    ptReleased: bigint;
+    plan: CrossingEqualizationPlanStep[];
+};
+export type ExistingPositionBudgetEffect = {
+    userMaxSy: bigint;
+    userMaxPt: bigint;
+    effectiveMaxSy: bigint;
+    effectiveMaxPt: bigint;
+    fixedSySpent: bigint;
+    fixedPtSpent: bigint;
+    fixedSyReleased: bigint;
+    fixedPtReleased: bigint;
+};
+/**
+ * Mirrors `precalc_existing_position_add_liquidity` from the CLMM program.
+ *
+ * The returned `ptSpent` and `sySpent` are the exact token budget that must be
+ * reserved before adding more liquidity to a position with an active crossing split.
+ * All PreciseNumber operations are performed on raw fixed-point `bigint` values so
+ * the rounding matches the contract's `fast_floor_u128`, `fast_mul_ratio`, and
+ * `muldiv_ceil_u128` paths.
+ */
+export declare function computeExistingPositionEqualization(ticks: Ticks, position: LpPositionCLMM): ExistingPositionEqualization;
+/**
+ * Mirrors the contract's `compute_existing_position_budget_effect`.
+ *
+ * It throws the same invariant class when the supplied user budgets cannot cover
+ * the fixed equalization spend, for example `userMaxPt=0` while `ptSpent>0`.
+ */
+export declare function computeExistingPositionBudgetEffect(params: {
+    ticks: Ticks;
+    position: LpPositionCLMM;
+    userMaxSy: bigint;
+    userMaxPt: bigint;
+}): ExistingPositionBudgetEffect;
+/**
+ * Mirrors `required_user_max_sy/pt`: expands a desired post-equalization budget
+ * into the user-facing max token amounts that should be passed to the instruction.
+ */
+export declare function computeRequiredUserMaxForExistingPositionEqualization(params: {
+    ticks: Ticks;
+    position: LpPositionCLMM;
+    desiredEffectiveMaxSy: bigint;
+    desiredEffectiveMaxPt: bigint;
+}): {
+    userMaxSy: bigint;
+    userMaxPt: bigint;
+    equalization: ExistingPositionEqualization;
+};

package/build/existingPositionEqualization.js

@@ -0,0 +1,241 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeExistingPositionEqualization = computeExistingPositionEqualization;
+exports.computeExistingPositionBudgetEffect = computeExistingPositionBudgetEffect;
+exports.computeRequiredUserMaxForExistingPositionEqualization = computeRequiredUserMaxForExistingPositionEqualization;
+const SENTINEL_TICK_INDEX = 0xffffffff;
+const PRECISE_NUMBER_DENOM = 1000000000000n;
+const U64_MAX = (1n << 64n) - 1n;
+const U128_MAX = (1n << 128n) - 1n;
+const invariantError = (message) => new Error(`CrossingEqualizationInvariantViolated: ${message}`);
+const assertU64 = (value, label) => {
+    if (value < 0n || value > U64_MAX) {
+        throw invariantError(`${label} does not fit in u64: ${value.toString()}`);
+    }
+    return value;
+};
+const assertU128 = (value, label) => {
+    if (value < 0n || value > U128_MAX) {
+        throw invariantError(`${label} does not fit in u128: ${value.toString()}`);
+    }
+    return value;
+};
+const checkedAddU64 = (left, right, label) => assertU64(left + right, label);
+const checkedSubU64 = (left, right, label) => {
+    if (right > left) {
+        throw invariantError(`${label} underflow: ${left.toString()} - ${right.toString()}`);
+    }
+    return left - right;
+};
+const checkedMulU128 = (left, right, label) => assertU128(left * right, label);
+const ceilMulDivU128 = (left, right, denominator, label) => {
+    if (denominator <= 0n) {
+        throw invariantError(`${label} division by zero`);
+    }
+    const product = checkedMulU128(left, right, `${label} product`);
+    return assertU128(product + denominator - 1n, `${label} ceil numerator`) / denominator;
+};
+const fastFloorU128 = (rawPreciseNumber) => assertU128(rawPreciseNumber, "precise number raw") / PRECISE_NUMBER_DENOM;
+const fastMulRatioRaw = (rawPreciseNumber, numerator, denominator, label) => {
+    if (denominator <= 0n) {
+        throw invariantError(`${label} division by zero`);
+    }
+    const raw = assertU128(rawPreciseNumber, `${label} raw precise number`);
+    const product = checkedMulU128(raw, numerator, `${label} product`);
+    return product / denominator;
+};
+const getTickByIndex = (ticks, tickIdx) => {
+    const tick = ticks.ticksTree[tickIdx - 1];
+    if (!tick || tick.apyBasePoints <= 0) {
+        throw invariantError(`missing tick at index ${tickIdx}`);
+    }
+    return tick;
+};
+const getTickKey = (ticks, tickIdx) => getTickByIndex(ticks, tickIdx).apyBasePoints;
+const successorIdx = (ticks, tickIdx) => {
+    const tickKey = getTickKey(ticks, tickIdx);
+    let best = null;
+    for (let index = 0; index < ticks.ticksTree.length; index++) {
+        const key = ticks.ticksTree[index].apyBasePoints;
+        if (key <= tickKey) {
+            continue;
+        }
+        if (!best || key < best.key) {
+            best = { tickIdx: index + 1, key };
+        }
+    }
+    return best?.tickIdx ?? null;
+};
+const isCrossingSplitActive = (position) => position.crossingSplit.crossLeftIdx !== SENTINEL_TICK_INDEX &&
+    position.crossingSplit.crossRightIdx !== SENTINEL_TICK_INDEX;
+const shareIsWithinCrossingRange = (ticks, position, share) => {
+    const shareLeftKey = getTickKey(ticks, share.tickIdx);
+    let shareRightIdx = share.rightTickIdx;
+    if (share.rightTickIdx === SENTINEL_TICK_INDEX) {
+        shareRightIdx = successorIdx(ticks, share.tickIdx);
+    }
+    if (shareRightIdx == null) {
+        return false;
+    }
+    const shareRightKey = getTickKey(ticks, shareRightIdx);
+    const crossLeftKey = getTickKey(ticks, position.crossingSplit.crossLeftIdx);
+    const crossRightKey = getTickKey(ticks, position.crossingSplit.crossRightIdx);
+    return shareLeftKey >= crossLeftKey && shareRightKey <= crossRightKey;
+};
+const computeAddDeltas = (params) => {
+    const ptDelta = params.ownedPt > 0n
+        ? assertU64(ceilMulDivU128(params.ownedPt, params.liquidityDelta, params.lActual, "PT equalization in"), "PT equalization in")
+        : 0n;
+    const syDelta = params.ownedSy > 0n
+        ? assertU64(ceilMulDivU128(params.ownedSy, params.liquidityDelta, params.lActual, "SY equalization in"), "SY equalization in")
+        : 0n;
+    return [ptDelta, syDelta];
+};
+const computeRemoveDeltas = (params) => {
+    const burnShares = fastFloorU128(params.shareDeltaRaw);
+    const ptDelta = assertU64(checkedMulU128(burnShares, params.node.principalPt, "PT equalization out product") / params.supply, "PT equalization out");
+    const syDelta = assertU64(checkedMulU128(burnShares, params.node.principalSy, "SY equalization out product") / params.supply, "SY equalization out");
+    return [ptDelta, syDelta];
+};
+const summarizePlan = (plan) => {
+    let sySpent = 0n;
+    let ptSpent = 0n;
+    let syReleased = 0n;
+    let ptReleased = 0n;
+    for (const step of plan) {
+        if (step.direction === "add") {
+            sySpent = checkedAddU64(sySpent, step.syDelta, "equalization sy spent");
+            ptSpent = checkedAddU64(ptSpent, step.ptDelta, "equalization pt spent");
+            continue;
+        }
+        syReleased = checkedAddU64(syReleased, step.syDelta, "equalization sy released");
+        ptReleased = checkedAddU64(ptReleased, step.ptDelta, "equalization pt released");
+    }
+    return {
+        sySpent,
+        ptSpent,
+        syReleased,
+        ptReleased,
+        plan,
+    };
+};
+/**
+ * Mirrors `precalc_existing_position_add_liquidity` from the CLMM program.
+ *
+ * The returned `ptSpent` and `sySpent` are the exact token budget that must be
+ * reserved before adding more liquidity to a position with an active crossing split.
+ * All PreciseNumber operations are performed on raw fixed-point `bigint` values so
+ * the rounding matches the contract's `fast_floor_u128`, `fast_mul_ratio`, and
+ * `muldiv_ceil_u128` paths.
+ */
+function computeExistingPositionEqualization(ticks, position) {
+    if (!isCrossingSplitActive(position)) {
+        return summarizePlan([]);
+    }
+    const lActual = assertU64(position.crossingSplit.lpBalanceCrossing, "lpBalanceCrossing");
+    const lpBalance = assertU64(position.lpBalance, "lpBalance");
+    if (lpBalance === lActual) {
+        return summarizePlan([]);
+    }
+    if (lActual === 0n) {
+        throw invariantError("active crossing split has zero actual liquidity");
+    }
+    const direction = lpBalance > lActual ? "add" : "remove";
+    const liquidityDelta = lpBalance > lActual ? lpBalance - lActual : lActual - lpBalance;
+    const plan = [];
+    let sawCrossingRangeShare = false;
+    let skippedCrossingShareDueToDust = false;
+    for (let shareIndex = 0; shareIndex < position.shareTrackers.length; shareIndex++) {
+        const share = position.shareTrackers[shareIndex];
+        if (!shareIsWithinCrossingRange(ticks, position, share)) {
+            continue;
+        }
+        sawCrossingRangeShare = true;
+        const node = getTickByIndex(ticks, share.tickIdx);
+        const supply = fastFloorU128(node.principalShareSupply);
+        if (supply === 0n) {
+            skippedCrossingShareDueToDust = true;
+            continue;
+        }
+        const shareFloor = fastFloorU128(share.lpShare);
+        if (shareFloor === 0n) {
+            skippedCrossingShareDueToDust = true;
+            continue;
+        }
+        const ownedPt = assertU64(checkedMulU128(shareFloor, node.principalPt, "owned PT product") / supply, "owned PT");
+        const ownedSy = assertU64(checkedMulU128(shareFloor, node.principalSy, "owned SY product") / supply, "owned SY");
+        const shareDeltaRaw = fastMulRatioRaw(share.lpShare, liquidityDelta, lActual, "share delta");
+        let deltas;
+        if (direction === "add") {
+            deltas = computeAddDeltas({
+                ownedPt,
+                ownedSy,
+                liquidityDelta,
+                lActual,
+            });
+        }
+        else {
+            deltas = computeRemoveDeltas({
+                shareDeltaRaw,
+                node,
+                supply,
+            });
+        }
+        const [ptDelta, syDelta] = deltas;
+        if (shareDeltaRaw === 0n && ptDelta === 0n && syDelta === 0n) {
+            skippedCrossingShareDueToDust = true;
+            continue;
+        }
+        plan.push({
+            shareIndex,
+            tickIdx: share.tickIdx,
+            direction,
+            shareDeltaRaw,
+            ptDelta,
+            syDelta,
+        });
+    }
+    if (plan.length === 0 && sawCrossingRangeShare && skippedCrossingShareDueToDust) {
+        return summarizePlan([]);
+    }
+    if (plan.length === 0) {
+        throw invariantError("active crossing split has no equalizable crossing-range shares");
+    }
+    return summarizePlan(plan);
+}
+/**
+ * Mirrors the contract's `compute_existing_position_budget_effect`.
+ *
+ * It throws the same invariant class when the supplied user budgets cannot cover
+ * the fixed equalization spend, for example `userMaxPt=0` while `ptSpent>0`.
+ */
+function computeExistingPositionBudgetEffect(params) {
+    const equalization = computeExistingPositionEqualization(params.ticks, params.position);
+    const effectiveMaxSy = checkedAddU64(checkedSubU64(params.userMaxSy, equalization.sySpent, "effective max SY"), equalization.syReleased, "effective max SY");
+    const effectiveMaxPt = checkedAddU64(checkedSubU64(params.userMaxPt, equalization.ptSpent, "effective max PT"), equalization.ptReleased, "effective max PT");
+    return {
+        userMaxSy: params.userMaxSy,
+        userMaxPt: params.userMaxPt,
+        effectiveMaxSy,
+        effectiveMaxPt,
+        fixedSySpent: equalization.sySpent,
+        fixedPtSpent: equalization.ptSpent,
+        fixedSyReleased: equalization.syReleased,
+        fixedPtReleased: equalization.ptReleased,
+    };
+}
+/**
+ * Mirrors `required_user_max_sy/pt`: expands a desired post-equalization budget
+ * into the user-facing max token amounts that should be passed to the instruction.
+ */
+function computeRequiredUserMaxForExistingPositionEqualization(params) {
+    const equalization = computeExistingPositionEqualization(params.ticks, params.position);
+    const userMaxSy = checkedSubU64(checkedAddU64(params.desiredEffectiveMaxSy, equalization.sySpent, "required user max SY"), equalization.syReleased, "required user max SY");
+    const userMaxPt = checkedSubU64(checkedAddU64(params.desiredEffectiveMaxPt, equalization.ptSpent, "required user max PT"), equalization.ptReleased, "required user max PT");
+    return {
+        userMaxSy,
+        userMaxPt,
+        equalization,
+    };
+}
+//# sourceMappingURL=existingPositionEqualization.js.map

package/build/existingPositionEqualization.js.map

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

package/build/index.d.ts

@@ -17,6 +17,8 @@ export { EffSnap, TicksWrapper, calculateFeeRate, getFeeFromAmount } from "./uti
 export { simulateBuyYt, simulateSellYt, simulateBuyYtWithSyIn } from "./ytTrades";
 export type { BuyYtSimulationArgs, BuyYtSimulationResult, SellYtSimulationArgs, SellYtSimulationResult, } from "./ytTrades";
 export { simulateAddLiquidity, computeLiquidityTargetAndTokenNeeds, computeTokenNeedsWithCrossing, getCrossingTickStateFromTicks, scaleCrossingTickInputs, calculateLpOut, estimateBalancedDeposit, calcDepositSyAndPtFromBaseAmount, simulateWrapperProvideLiquidity, simulateSwapAndSupply, } from "./addLiquidity";
+export { computeExistingPositionBudgetEffect, computeExistingPositionEqualization, computeRequiredUserMaxForExistingPositionEqualization, } from "./existingPositionEqualization";
+export type { CrossingEqualizationDirection, CrossingEqualizationPlanStep, ExistingPositionBudgetEffect, ExistingPositionEqualization, } from "./existingPositionEqualization";
 export { getPtAndSyOnWithdrawLiquidity } from "./withdrawLiquidity";
 export { bisectSearch2 } from "./bisect";
 export { buildLiquidityHistogram, buildLiquidityHistogramSimple } from "./liquidityHistogram";

package/build/index.js

@@ -25,7 +25,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SwapDirection = exports.buildLiquidityHistogramSimple = exports.buildLiquidityHistogram = exports.bisectSearch2 = exports.getPtAndSyOnWithdrawLiquidity = exports.simulateSwapAndSupply = exports.simulateWrapperProvideLiquidity = exports.calcDepositSyAndPtFromBaseAmount = exports.estimateBalancedDeposit = exports.calculateLpOut = exports.scaleCrossingTickInputs = exports.getCrossingTickStateFromTicks = exports.computeTokenNeedsWithCrossing = exports.computeLiquidityTargetAndTokenNeeds = exports.simulateAddLiquidity = exports.simulateBuyYtWithSyIn = exports.simulateSellYt = exports.simulateBuyYt = exports.getFeeFromAmount = exports.calculateFeeRate = exports.TicksWrapper = exports.EffSnap = exports.QuoteDirection = exports.getSwapQuote = exports.simulateSwap = exports.getSuccessorTickIdxByIdx = exports.calcPtPriceInAsset = exports.convertApyBpToApy = exports.convertApyToApyBp = exports.findTickByKey = exports.getImpliedRate = exports.getPredecessorTickKey = exports.getSuccessorTickKey = exports.getActiveLiquidity = exports.normalizedTimeRemaining = void 0;
+exports.SwapDirection = exports.buildLiquidityHistogramSimple = exports.buildLiquidityHistogram = exports.bisectSearch2 = exports.getPtAndSyOnWithdrawLiquidity = exports.computeRequiredUserMaxForExistingPositionEqualization = exports.computeExistingPositionEqualization = exports.computeExistingPositionBudgetEffect = exports.simulateSwapAndSupply = exports.simulateWrapperProvideLiquidity = exports.calcDepositSyAndPtFromBaseAmount = exports.estimateBalancedDeposit = exports.calculateLpOut = exports.scaleCrossingTickInputs = exports.getCrossingTickStateFromTicks = exports.computeTokenNeedsWithCrossing = exports.computeLiquidityTargetAndTokenNeeds = exports.simulateAddLiquidity = exports.simulateBuyYtWithSyIn = exports.simulateSellYt = exports.simulateBuyYt = exports.getFeeFromAmount = exports.calculateFeeRate = exports.TicksWrapper = exports.EffSnap = exports.QuoteDirection = exports.getSwapQuote = exports.simulateSwap = exports.getSuccessorTickIdxByIdx = exports.calcPtPriceInAsset = exports.convertApyBpToApy = exports.convertApyToApyBp = exports.findTickByKey = exports.getImpliedRate = exports.getPredecessorTickKey = exports.getSuccessorTickKey = exports.getActiveLiquidity = exports.normalizedTimeRemaining = void 0;
 // Export types
 __exportStar(require("./types"), exports);
 // Export utility functions
@@ -69,6 +69,10 @@ Object.defineProperty(exports, "estimateBalancedDeposit", { enumerable: true, ge
 Object.defineProperty(exports, "calcDepositSyAndPtFromBaseAmount", { enumerable: true, get: function () { return addLiquidity_1.calcDepositSyAndPtFromBaseAmount; } });
 Object.defineProperty(exports, "simulateWrapperProvideLiquidity", { enumerable: true, get: function () { return addLiquidity_1.simulateWrapperProvideLiquidity; } });
 Object.defineProperty(exports, "simulateSwapAndSupply", { enumerable: true, get: function () { return addLiquidity_1.simulateSwapAndSupply; } });
+var existingPositionEqualization_1 = require("./existingPositionEqualization");
+Object.defineProperty(exports, "computeExistingPositionBudgetEffect", { enumerable: true, get: function () { return existingPositionEqualization_1.computeExistingPositionBudgetEffect; } });
+Object.defineProperty(exports, "computeExistingPositionEqualization", { enumerable: true, get: function () { return existingPositionEqualization_1.computeExistingPositionEqualization; } });
+Object.defineProperty(exports, "computeRequiredUserMaxForExistingPositionEqualization", { enumerable: true, get: function () { return existingPositionEqualization_1.computeRequiredUserMaxForExistingPositionEqualization; } });
 var withdrawLiquidity_1 = require("./withdrawLiquidity");
 Object.defineProperty(exports, "getPtAndSyOnWithdrawLiquidity", { enumerable: true, get: function () { return withdrawLiquidity_1.getPtAndSyOnWithdrawLiquidity; } });
 // Export bisect search utility

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;;AAEH,eAAe;AACf,0CAAuB;AAEvB,2BAA2B;AAC3B,iCAWgB;AAVd,gHAAA,uBAAuB,OAAA;AACvB,2GAAA,kBAAkB,OAAA;AAClB,4GAAA,mBAAmB,OAAA;AACnB,8GAAA,qBAAqB,OAAA;AACrB,uGAAA,cAAc,OAAA;AACd,sGAAA,aAAa,OAAA;AACb,0GAAA,iBAAiB,OAAA;AACjB,0GAAA,iBAAiB,OAAA;AACjB,2GAAA,kBAAkB,OAAA;AAClB,iHAAA,wBAAwB,OAAA;AAG1B,wBAAwB;AACxB,mCAAuC;AAA9B,sGAAA,YAAY,OAAA;AACrB,iCAAsD;AAA7C,qGAAA,YAAY,OAAA;AAAE,uGAAA,cAAc,OAAA;AAErC,sBAAsB;AACtB,qCAAqF;AAA5E,kGAAA,OAAO,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAElE,4BAA4B;AAC5B,uCAAiF;AAAxE,yGAAA,aAAa,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAQ7D,iCAAiC;AACjC,+CAWuB;AAVrB,oHAAA,oBAAoB,OAAA;AACpB,mIAAA,mCAAmC,OAAA;AACnC,6HAAA,6BAA6B,OAAA;AAC7B,6HAAA,6BAA6B,OAAA;AAC7B,uHAAA,uBAAuB,OAAA;AACvB,8GAAA,cAAc,OAAA;AACd,uHAAA,uBAAuB,OAAA;AACvB,gIAAA,gCAAgC,OAAA;AAChC,+HAAA,+BAA+B,OAAA;AAC/B,qHAAA,qBAAqB,OAAA;AAGvB,yDAAmE;AAA1D,kIAAA,6BAA6B,OAAA;AAEtC,+BAA+B;AAC/B,mCAAwC;AAA/B,uGAAA,aAAa,OAAA;AAEtB,uCAAuC;AACvC,2DAA6F;AAApF,6HAAA,uBAAuB,OAAA;AAAE,mIAAA,6BAA6B,OAAA;AAc/D,iCAAuC;AAA9B,sGAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;;AAEH,eAAe;AACf,0CAAuB;AAEvB,2BAA2B;AAC3B,iCAWgB;AAVd,gHAAA,uBAAuB,OAAA;AACvB,2GAAA,kBAAkB,OAAA;AAClB,4GAAA,mBAAmB,OAAA;AACnB,8GAAA,qBAAqB,OAAA;AACrB,uGAAA,cAAc,OAAA;AACd,sGAAA,aAAa,OAAA;AACb,0GAAA,iBAAiB,OAAA;AACjB,0GAAA,iBAAiB,OAAA;AACjB,2GAAA,kBAAkB,OAAA;AAClB,iHAAA,wBAAwB,OAAA;AAG1B,wBAAwB;AACxB,mCAAuC;AAA9B,sGAAA,YAAY,OAAA;AACrB,iCAAsD;AAA7C,qGAAA,YAAY,OAAA;AAAE,uGAAA,cAAc,OAAA;AAErC,sBAAsB;AACtB,qCAAqF;AAA5E,kGAAA,OAAO,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAElE,4BAA4B;AAC5B,uCAAiF;AAAxE,yGAAA,aAAa,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAQ7D,iCAAiC;AACjC,+CAWuB;AAVrB,oHAAA,oBAAoB,OAAA;AACpB,mIAAA,mCAAmC,OAAA;AACnC,6HAAA,6BAA6B,OAAA;AAC7B,6HAAA,6BAA6B,OAAA;AAC7B,uHAAA,uBAAuB,OAAA;AACvB,8GAAA,cAAc,OAAA;AACd,uHAAA,uBAAuB,OAAA;AACvB,gIAAA,gCAAgC,OAAA;AAChC,+HAAA,+BAA+B,OAAA;AAC/B,qHAAA,qBAAqB,OAAA;AAEvB,+EAIuC;AAHrC,mJAAA,mCAAmC,OAAA;AACnC,mJAAA,mCAAmC,OAAA;AACnC,qKAAA,qDAAqD,OAAA;AASvD,yDAAmE;AAA1D,kIAAA,6BAA6B,OAAA;AAEtC,+BAA+B;AAC/B,mCAAwC;AAA/B,uGAAA,aAAa,OAAA;AAEtB,uCAAuC;AACvC,2DAA6F;AAApF,6HAAA,uBAAuB,OAAA;AAAE,mIAAA,6BAA6B,OAAA;AAc/D,iCAAuC;AAA9B,sGAAA,aAAa,OAAA"}

package/build/swapLegacy.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CLMM Swap simulation
+ * Ported from exponent_clmm/src/state/market_three/helpers/swap.rs
+ */
+import { MarketThreeState, SwapArgs, SwapDirection, SwapOutcome } from "./types";
+/**
+ * Simulate a swap on the CLMM market
+ * This is a pure function that does not mutate the market state
+ * Returns the swap outcome including amounts and final state
+ */
+export declare function simulateSwap(marketState: MarketThreeState, args: SwapArgs): SwapOutcome;
+/**
+ * Calculate the expected output for a given input amount
+ * This is a convenience wrapper around simulateSwap
+ */
+export declare function getSwapQuote(marketState: MarketThreeState, amountIn: number, direction: SwapDirection): SwapOutcome;

package/build/swapLegacy.js

@@ -0,0 +1,229 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSwapQuote = exports.simulateSwap = void 0;
+/**
+ * CLMM Swap simulation
+ * Ported from exponent_clmm/src/state/market_three/helpers/swap.rs
+ */
+const types_1 = require("./types");
+const utils_1 = require("./utils");
+const BASE_POINTS = 10000;
+/**
+ * Simulate a swap on the CLMM market
+ * This is a pure function that does not mutate the market state
+ * Returns the swap outcome including amounts and final state
+ */
+function simulateSwap(marketState, args) {
+    const { financials, configurationOptions, ticks } = marketState;
+    const secondsRemaining = Math.max(0, Number(financials.expirationTs) - Date.now() / 1000);
+    // Create effective price snapshot
+    const snapshot = new utils_1.EffSnap((0, utils_1.normalizedTimeRemaining)(secondsRemaining), args.syExchangeRate);
+    // Current state
+    let currentPriceSpot = ticks.currentSpotPrice;
+    let currentLeftBoundaryIndex = ticks.currentTick;
+    // Use currentPrefixSum if available, otherwise fall back to calculating it
+    let activeLiquidityU64 = ticks.currentPrefixSum ?? 0n;
+    let activeLiquidityF64 = Number(activeLiquidityU64);
+    // Fees
+    const lpFeeRate = (0, utils_1.calculateFeeRate)(configurationOptions.lnFeeRateRoot, secondsRemaining);
+    const protocolFeeBps = configurationOptions.treasuryFeeBps;
+    // Check price limits
+    if (args.priceSpotLimit !== undefined) {
+        if (args.direction === types_1.SwapDirection.PtToSy) {
+            if (args.priceSpotLimit < currentPriceSpot) {
+                throw new Error("Price limit violated: limit must be >= current price for PtToSy");
+            }
+        }
+        else {
+            if (args.priceSpotLimit > currentPriceSpot) {
+                throw new Error("Price limit violated: limit must be <= current price for SyToPt");
+            }
+        }
+    }
+    // Accumulators
+    let amountOutNet = 0;
+    let feeLpOut = 0;
+    let feeProtocolOut = 0;
+    let amountInLeft = args.amountIn;
+    // Main loop across contiguous intervals
+    let iterations = 0;
+    const maxIterations = 1000;
+    while (amountInLeft > 0 && iterations < maxIterations) {
+        iterations++;
+        // Get right boundary of current interval
+        const rightBoundaryIndexOpt = (0, utils_1.getSuccessorTickKey)(ticks, currentLeftBoundaryIndex);
+        if (rightBoundaryIndexOpt === null) {
+            if (args.direction === types_1.SwapDirection.SyToPt) {
+                // Cross to create a new interval
+                const predecessor = (0, utils_1.getPredecessorTickKey)(ticks, currentLeftBoundaryIndex);
+                if (predecessor === null)
+                    break;
+                // When crossing downward (SyToPt), update state
+                currentPriceSpot = (0, utils_1.getImpliedRate)(currentLeftBoundaryIndex); // Boundary we're crossing
+                currentLeftBoundaryIndex = predecessor; // New left boundary
+                // Update active liquidity by subtracting liquidity_net at boundary
+                const boundaryTick = (0, utils_1.findTickByKey)(ticks, predecessor);
+                if (boundaryTick) {
+                    activeLiquidityU64 = (0, utils_1.bigIntMax)(0n, activeLiquidityU64 - boundaryTick.tick.liquidityNet);
+                    activeLiquidityF64 = Number(activeLiquidityU64);
+                }
+                continue;
+            }
+            else {
+                // No more liquidity available
+                break;
+            }
+        }
+        const rightBoundaryIndex = rightBoundaryIndexOpt;
+        // Get anchor prices for interval boundaries
+        const anchorULeft = (0, utils_1.getImpliedRate)(currentLeftBoundaryIndex);
+        const anchorURight = (0, utils_1.getImpliedRate)(rightBoundaryIndex);
+        // Effective price at current spot
+        const cEffOld = snapshot.getEffectivePrice(currentPriceSpot);
+        // Get principal ledgers for the interval
+        const currentTickData = (0, utils_1.findTickByKey)(ticks, currentLeftBoundaryIndex);
+        const principalPt = currentTickData?.tick.principalPt ?? 0n;
+        const principalSy = currentTickData?.tick.principalSy ?? 0n;
+        const eps = configurationOptions.epsilonClamp;
+        // Calculate kappa (scaling factor based on available principal)
+        // Y_max = (L/τ) * (C(u_old) - C(u_right))
+        const cEffAtBoundary = snapshot.getEffectivePrice(anchorURight);
+        const yMaxToBoundaryF = (Number(activeLiquidityF64) / snapshot.timeFactor) * (cEffOld - cEffAtBoundary);
+        const kappaSy = yMaxToBoundaryF > 0 ? Number(principalSy) / Number(yMaxToBoundaryF) : 0;
+        const duToLeft = currentPriceSpot - anchorULeft;
+        const ptMaxToLeftF = Number(activeLiquidityF64) * duToLeft;
+        const kappaPt = ptMaxToLeftF > 0 ? Number(principalPt) / ptMaxToLeftF : 0;
+        const kappa = Math.min(kappaPt, kappaSy, 1.0);
+        const lTradeF64 = Number(activeLiquidityF64) * kappa;
+        if (args.direction === types_1.SwapDirection.PtToSy) {
+            // PT -> SY swap (buying SY with PT)
+            const duByInput = lTradeF64 > 0 ? amountInLeft / lTradeF64 : 0;
+            const duToBoundary = anchorURight - currentPriceSpot;
+            const duActual = Math.min(duByInput, duToBoundary);
+            if (duToBoundary <= eps) {
+                // Cross boundary
+                const boundaryTick = (0, utils_1.findTickByKey)(ticks, rightBoundaryIndex);
+                if (boundaryTick) {
+                    activeLiquidityU64 += boundaryTick.tick.liquidityNet;
+                    activeLiquidityF64 = Number(activeLiquidityU64);
+                }
+                currentLeftBoundaryIndex = rightBoundaryIndex;
+                currentPriceSpot = anchorURight;
+                continue;
+            }
+            // Token flows for this segment
+            const ptInSegment = Math.floor(lTradeF64 * duActual);
+            const anchorUNew = currentPriceSpot + duActual;
+            const cEffNew = snapshot.getEffectivePrice(anchorUNew);
+            const syOutGross = Math.floor((lTradeF64 / snapshot.timeFactor) * (cEffOld - cEffNew));
+            const syOutGrossClamped = Math.min(syOutGross, Number(principalSy));
+            if (syOutGrossClamped > 0) {
+                const totalFeeOut = (0, utils_1.getFeeFromAmount)(syOutGrossClamped, lpFeeRate);
+                const protocolFeeOut = Math.floor((totalFeeOut * protocolFeeBps) / BASE_POINTS);
+                const lpFeeOut = totalFeeOut - protocolFeeOut;
+                const syOutNet = syOutGrossClamped - totalFeeOut;
+                amountOutNet += syOutNet;
+                feeLpOut += lpFeeOut;
+                feeProtocolOut += protocolFeeOut;
+            }
+            amountInLeft -= ptInSegment;
+            currentPriceSpot = anchorUNew;
+        }
+        else {
+            // SY -> PT swap (buying PT with SY)
+            const cEffLeft = snapshot.getEffectivePrice(anchorULeft);
+            const deltaCByInput = lTradeF64 > 0 ? (snapshot.timeFactor / lTradeF64) * amountInLeft : 0;
+            const deltaCToLeftBoundary = Math.max(0, cEffLeft - cEffOld);
+            const deltaCActual = Math.min(deltaCByInput, deltaCToLeftBoundary);
+            if (deltaCToLeftBoundary <= eps) {
+                // Cross boundary to the left
+                const predecessor = (0, utils_1.getPredecessorTickKey)(ticks, currentLeftBoundaryIndex);
+                if (predecessor === null)
+                    break;
+                // Update active liquidity
+                const boundaryTick = (0, utils_1.findTickByKey)(ticks, currentLeftBoundaryIndex);
+                if (boundaryTick) {
+                    activeLiquidityU64 = (0, utils_1.bigIntMax)(0n, activeLiquidityU64 - boundaryTick.tick.liquidityNet);
+                    activeLiquidityF64 = Number(activeLiquidityU64);
+                }
+                currentPriceSpot = (0, utils_1.getImpliedRate)(currentLeftBoundaryIndex);
+                currentLeftBoundaryIndex = predecessor;
+                continue;
+            }
+            // New effective price and spot price after consuming ΔC
+            const cEffNew = cEffOld + deltaCActual;
+            const spotPriceNew = snapshot.spotPriceFromEffectivePrice(cEffNew);
+            // Token flows
+            const syInSegmentF = (lTradeF64 / snapshot.timeFactor) * (cEffNew - cEffOld);
+            const duAbs = currentPriceSpot - spotPriceNew;
+            const ptOutGrossF = lTradeF64 * duAbs;
+            // Clamp gross PT by available principal
+            const ptOutGrossU64 = (0, utils_1.bigIntMin)(BigInt(Math.floor(ptOutGrossF)), principalPt);
+            const syInSegmentU64 = BigInt(Math.floor(syInSegmentF));
+            if (ptOutGrossU64 === 0n) {
+                // Nothing to pay out; try to cross
+                const predecessor = (0, utils_1.getPredecessorTickKey)(ticks, currentLeftBoundaryIndex);
+                if (predecessor === null)
+                    break;
+                // Update active liquidity
+                const boundaryTick = (0, utils_1.findTickByKey)(ticks, currentLeftBoundaryIndex);
+                if (boundaryTick) {
+                    activeLiquidityU64 = (0, utils_1.bigIntMax)(0n, activeLiquidityU64 - boundaryTick.tick.liquidityNet);
+                    activeLiquidityF64 = Number(activeLiquidityU64);
+                }
+                currentPriceSpot = (0, utils_1.getImpliedRate)(currentLeftBoundaryIndex);
+                currentLeftBoundaryIndex = predecessor;
+                continue;
+            }
+            // Fees in token_out (PT)
+            const totalFeeOut = (0, utils_1.getFeeFromAmount)(Number(ptOutGrossU64), lpFeeRate);
+            const protocolFeeOut = Math.floor((totalFeeOut * protocolFeeBps) / BASE_POINTS);
+            const lpFeeOut = totalFeeOut - protocolFeeOut;
+            const ptOutNet = Number(ptOutGrossU64) - totalFeeOut;
+            // Accumulate to user
+            amountOutNet += ptOutNet;
+            feeLpOut += lpFeeOut;
+            feeProtocolOut += protocolFeeOut;
+            // Consume input and advance state
+            amountInLeft -= Number(syInSegmentU64);
+            currentPriceSpot = spotPriceNew;
+            // If we hit boundary, cross
+            if (Math.abs(currentPriceSpot - anchorULeft) <= eps && amountInLeft > 0) {
+                const predecessor = (0, utils_1.getPredecessorTickKey)(ticks, currentLeftBoundaryIndex);
+                if (predecessor === null)
+                    break;
+                // Update active liquidity
+                const boundaryTick = (0, utils_1.findTickByKey)(ticks, currentLeftBoundaryIndex);
+                if (boundaryTick) {
+                    activeLiquidityU64 = (0, utils_1.bigIntMax)(0n, activeLiquidityU64 - boundaryTick.tick.liquidityNet);
+                    activeLiquidityF64 = Number(activeLiquidityU64);
+                }
+                currentPriceSpot = (0, utils_1.getImpliedRate)(currentLeftBoundaryIndex);
+                currentLeftBoundaryIndex = predecessor;
+            }
+        }
+    }
+    return {
+        amountInConsumed: args.amountIn - amountInLeft,
+        amountOut: amountOutNet,
+        lpFeeChargedOutToken: feeLpOut,
+        protocolFeeChargedOutToken: feeProtocolOut,
+        finalSpotPrice: currentPriceSpot,
+        finalTickIndex: currentLeftBoundaryIndex,
+    };
+}
+exports.simulateSwap = simulateSwap;
+/**
+ * Calculate the expected output for a given input amount
+ * This is a convenience wrapper around simulateSwap
+ */
+function getSwapQuote(marketState, amountIn, direction) {
+    return simulateSwap(marketState, {
+        direction,
+        amountIn,
+        syExchangeRate: marketState.currentSyExchangeRate,
+        isCurrentFlashSwap: false,
+    });
+}
+exports.getSwapQuote = getSwapQuote;
+//# sourceMappingURL=swapLegacy.js.map

package/build/swapLegacy.js.map

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

package/build/utils.d.ts

@@ -107,11 +107,11 @@ export declare function findTickByKey(ticks: Ticks, tickKey: number): {
  */
 export declare function findTickByIndex(ticks: Ticks, index: number): Tick;
 /**
- * Convert APY percentage to basis points
+ * Convert APY percentage to CLMM tick-key units.
  */
 export declare function convertApyToApyBp(apyPercent: number): number;
 /**
- * Convert basis points to APY percentage
+ * Convert CLMM tick-key units to APY percentage.
  */
 export declare function convertApyBpToApy(apyBp: number): number;
 export declare function bigIntMax(...args: bigint[]): bigint;

package/build/utils.js

@@ -203,17 +203,18 @@ function findTickByKey(ticks, tickKey) {
 function findTickByIndex(ticks, index) {
     return ticks.ticksTree.at(index - 1) ?? null;
 }
+const CLMM_TICK_KEY_SCALE = 10_000;
 /**
- * Convert APY percentage to basis points
+ * Convert APY percentage to CLMM tick-key units.
  */
 function convertApyToApyBp(apyPercent) {
-    return Math.round(apyPercent * 100);
+    return Math.round(apyPercent * CLMM_TICK_KEY_SCALE);
 }
 /**
- * Convert basis points to APY percentage
+ * Convert CLMM tick-key units to APY percentage.
  */
 function convertApyBpToApy(apyBp) {
-    return apyBp / 100;
+    return apyBp / CLMM_TICK_KEY_SCALE;
 }
 function bigIntMax(...args) {
     return args.reduce((m, e) => (e > m ? e : m));

package/build/utils.js.map

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

package/jest.config.ts

@@ -0,0 +1,9 @@
+import type { Config } from "@jest/types"
+
+const config: Config.InitialOptions = {
+  preset: "ts-jest",
+  testEnvironment: "node",
+  testMatch: ["**/*.test.ts"],
+}
+
+export default config

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exponent-labs/market-three-math",
-  "version": "0.9.13",
+  "version": "0.9.14",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "license": "AGPL-3.0",
@@ -10,7 +10,7 @@
     "test:live": "ts-node examples/test-live-market.ts"
   },
   "dependencies": {
-    "@exponent-labs/exponent-fetcher": "0.9.13",
+    "@exponent-labs/exponent-fetcher": "0.9.14",
     "@solana/web3.js": "^1.95.8"
   },
   "devDependencies": {

package/src/existingPositionEqualization.test.ts

@@ -0,0 +1,162 @@
+import { PublicKey } from "@solana/web3.js"
+
+import type { LpPositionCLMM, Ticks } from "@exponent-labs/exponent-fetcher"
+
+import {
+  computeExistingPositionBudgetEffect,
+  computeExistingPositionEqualization,
+  computeRequiredUserMaxForExistingPositionEqualization,
+} from "./existingPositionEqualization"
+
+const PRECISE_NUMBER_DENOM = 1_000_000_000_000n
+const SENTINEL_TICK_INDEX = 0xffffffff
+const PUBLIC_KEY = PublicKey.default
+
+const preciseRaw = (value: bigint) => value * PRECISE_NUMBER_DENOM
+
+const makeTicks = (): Ticks => ({
+  currentTick: 1,
+  ticksTree: [
+    {
+      apyBasePoints: 63_000,
+      impliedRate: 1.063,
+      principalPt: 500n,
+      principalSy: 700n,
+      principalShareSupply: preciseRaw(100n),
+      liquidityNet: 0n,
+      liquidityGross: 0n,
+      feeGrowthOutsidePt: 0n,
+      feeGrowthOutsideSy: 0n,
+      farms: [],
+      emissions: [],
+      lastSplitEpoch: 0n,
+      frozenLiquidity: 0n,
+    },
+    {
+      apyBasePoints: 65_000,
+      impliedRate: 1.065,
+      principalPt: 0n,
+      principalSy: 0n,
+      principalShareSupply: 0n,
+      liquidityNet: 0n,
+      liquidityGross: 0n,
+      feeGrowthOutsidePt: 0n,
+      feeGrowthOutsideSy: 0n,
+      farms: [],
+      emissions: [],
+      lastSplitEpoch: 0n,
+      frozenLiquidity: 0n,
+    },
+  ],
+  market: PUBLIC_KEY,
+  feeGrowthIndexGlobalPt: 0n,
+  feeGrowthIndexGlobalSy: 0n,
+  currentPrefixSum: 0n,
+  currentSpotPrice: 1.062,
+})
+
+const makePosition = (): LpPositionCLMM => ({
+  owner: PUBLIC_KEY,
+  market: PUBLIC_KEY,
+  feeInsideLastPt: 0n,
+  feeInsideLastSy: 0n,
+  lpBalance: 200n,
+  tokensOwedSy: 0n,
+  tokensOwedPt: 0n,
+  lowerTickIdx: 1,
+  upperTickIdx: 2,
+  farms: [],
+  shareTrackers: [
+    {
+      tickIdx: 1,
+      rightTickIdx: 2,
+      splitEpoch: 0n,
+      lpShare: preciseRaw(100n),
+      emissions: [],
+    },
+  ],
+  crossingSplit: {
+    crossLeftIdx: 1,
+    crossRightIdx: 2,
+    lpBalanceCrossing: 100n,
+    isActive: true,
+  },
+})
+
+describe("existing position equalization", () => {
+  it("matches the contract add-direction budget math with integer rounding", () => {
+    const equalization = computeExistingPositionEqualization(makeTicks(), makePosition())
+
+    expect(equalization.sySpent).toBe(700n)
+    expect(equalization.ptSpent).toBe(500n)
+    expect(equalization.syReleased).toBe(0n)
+    expect(equalization.ptReleased).toBe(0n)
+    expect(equalization.plan).toEqual([
+      {
+        shareIndex: 0,
+        tickIdx: 1,
+        direction: "add",
+        shareDeltaRaw: preciseRaw(100n),
+        ptDelta: 500n,
+        syDelta: 700n,
+      },
+    ])
+  })
+
+  it("throws when user budgets cannot cover fixed equalization spend", () => {
+    expect(() =>
+      computeExistingPositionBudgetEffect({
+        ticks: makeTicks(),
+        position: makePosition(),
+        userMaxSy: 700n,
+        userMaxPt: 499n,
+      }),
+    ).toThrow("CrossingEqualizationInvariantViolated")
+
+    expect(
+      computeExistingPositionBudgetEffect({
+        ticks: makeTicks(),
+        position: makePosition(),
+        userMaxSy: 700n,
+        userMaxPt: 500n,
+      }),
+    ).toMatchObject({
+      effectiveMaxSy: 0n,
+      effectiveMaxPt: 0n,
+      fixedSySpent: 700n,
+      fixedPtSpent: 500n,
+    })
+  })
+
+  it("expands desired effective budgets to user-facing instruction inputs", () => {
+    expect(
+      computeRequiredUserMaxForExistingPositionEqualization({
+        ticks: makeTicks(),
+        position: makePosition(),
+        desiredEffectiveMaxSy: 10n,
+        desiredEffectiveMaxPt: 20n,
+      }),
+    ).toMatchObject({
+      userMaxSy: 710n,
+      userMaxPt: 520n,
+    })
+  })
+
+  it("returns a no-op for inactive crossing splits", () => {
+    const position = makePosition()
+    position.crossingSplit = {
+      crossLeftIdx: SENTINEL_TICK_INDEX,
+      crossRightIdx: SENTINEL_TICK_INDEX,
+      lpBalanceCrossing: 0n,
+      isActive: false,
+    }
+
+    expect(computeExistingPositionEqualization(makeTicks(), position)).toMatchObject({
+      sySpent: 0n,
+      ptSpent: 0n,
+      syReleased: 0n,
+      ptReleased: 0n,
+      plan: [],
+    })
+  })
+})

package/src/existingPositionEqualization.ts

@@ -0,0 +1,367 @@
+import type { LpPositionCLMM, Tick, Ticks } from "@exponent-labs/exponent-fetcher"
+
+const SENTINEL_TICK_INDEX = 0xffffffff
+const PRECISE_NUMBER_DENOM = 1_000_000_000_000n
+const U64_MAX = (1n << 64n) - 1n
+const U128_MAX = (1n << 128n) - 1n
+
+export type CrossingEqualizationDirection = "add" | "remove"
+
+export type CrossingEqualizationPlanStep = {
+  shareIndex: number
+  tickIdx: number
+  direction: CrossingEqualizationDirection
+  shareDeltaRaw: bigint
+  ptDelta: bigint
+  syDelta: bigint
+}
+
+export type ExistingPositionEqualization = {
+  sySpent: bigint
+  ptSpent: bigint
+  syReleased: bigint
+  ptReleased: bigint
+  plan: CrossingEqualizationPlanStep[]
+}
+
+export type ExistingPositionBudgetEffect = {
+  userMaxSy: bigint
+  userMaxPt: bigint
+  effectiveMaxSy: bigint
+  effectiveMaxPt: bigint
+  fixedSySpent: bigint
+  fixedPtSpent: bigint
+  fixedSyReleased: bigint
+  fixedPtReleased: bigint
+}
+
+const invariantError = (message: string) => new Error(`CrossingEqualizationInvariantViolated: ${message}`)
+
+const assertU64 = (value: bigint, label: string): bigint => {
+  if (value < 0n || value > U64_MAX) {
+    throw invariantError(`${label} does not fit in u64: ${value.toString()}`)
+  }
+  return value
+}
+
+const assertU128 = (value: bigint, label: string): bigint => {
+  if (value < 0n || value > U128_MAX) {
+    throw invariantError(`${label} does not fit in u128: ${value.toString()}`)
+  }
+  return value
+}
+
+const checkedAddU64 = (left: bigint, right: bigint, label: string) => assertU64(left + right, label)
+
+const checkedSubU64 = (left: bigint, right: bigint, label: string) => {
+  if (right > left) {
+    throw invariantError(`${label} underflow: ${left.toString()} - ${right.toString()}`)
+  }
+  return left - right
+}
+
+const checkedMulU128 = (left: bigint, right: bigint, label: string) => assertU128(left * right, label)
+
+const ceilMulDivU128 = (left: bigint, right: bigint, denominator: bigint, label: string) => {
+  if (denominator <= 0n) {
+    throw invariantError(`${label} division by zero`)
+  }
+
+  const product = checkedMulU128(left, right, `${label} product`)
+  return assertU128(product + denominator - 1n, `${label} ceil numerator`) / denominator
+}
+
+const fastFloorU128 = (rawPreciseNumber: bigint) =>
+  assertU128(rawPreciseNumber, "precise number raw") / PRECISE_NUMBER_DENOM
+
+const fastMulRatioRaw = (rawPreciseNumber: bigint, numerator: bigint, denominator: bigint, label: string) => {
+  if (denominator <= 0n) {
+    throw invariantError(`${label} division by zero`)
+  }
+
+  const raw = assertU128(rawPreciseNumber, `${label} raw precise number`)
+  const product = checkedMulU128(raw, numerator, `${label} product`)
+  return product / denominator
+}
+
+const getTickByIndex = (ticks: Ticks, tickIdx: number): Tick => {
+  const tick = ticks.ticksTree[tickIdx - 1]
+  if (!tick || tick.apyBasePoints <= 0) {
+    throw invariantError(`missing tick at index ${tickIdx}`)
+  }
+
+  return tick
+}
+
+const getTickKey = (ticks: Ticks, tickIdx: number) => getTickByIndex(ticks, tickIdx).apyBasePoints
+
+const successorIdx = (ticks: Ticks, tickIdx: number): number | null => {
+  const tickKey = getTickKey(ticks, tickIdx)
+  let best: { tickIdx: number; key: number } | null = null
+
+  for (let index = 0; index < ticks.ticksTree.length; index++) {
+    const key = ticks.ticksTree[index].apyBasePoints
+    if (key <= tickKey) {
+      continue
+    }
+    if (!best || key < best.key) {
+      best = { tickIdx: index + 1, key }
+    }
+  }
+
+  return best?.tickIdx ?? null
+}
+
+const isCrossingSplitActive = (position: LpPositionCLMM) =>
+  position.crossingSplit.crossLeftIdx !== SENTINEL_TICK_INDEX &&
+  position.crossingSplit.crossRightIdx !== SENTINEL_TICK_INDEX
+
+const shareIsWithinCrossingRange = (
+  ticks: Ticks,
+  position: LpPositionCLMM,
+  share: LpPositionCLMM["shareTrackers"][number],
+): boolean => {
+  const shareLeftKey = getTickKey(ticks, share.tickIdx)
+  let shareRightIdx: number | null = share.rightTickIdx
+  if (share.rightTickIdx === SENTINEL_TICK_INDEX) {
+    shareRightIdx = successorIdx(ticks, share.tickIdx)
+  }
+
+  if (shareRightIdx == null) {
+    return false
+  }
+
+  const shareRightKey = getTickKey(ticks, shareRightIdx)
+  const crossLeftKey = getTickKey(ticks, position.crossingSplit.crossLeftIdx)
+  const crossRightKey = getTickKey(ticks, position.crossingSplit.crossRightIdx)
+
+  return shareLeftKey >= crossLeftKey && shareRightKey <= crossRightKey
+}
+
+const computeAddDeltas = (params: {
+  ownedPt: bigint
+  ownedSy: bigint
+  liquidityDelta: bigint
+  lActual: bigint
+}): [bigint, bigint] => {
+  const ptDelta =
+    params.ownedPt > 0n
+      ? assertU64(
+          ceilMulDivU128(params.ownedPt, params.liquidityDelta, params.lActual, "PT equalization in"),
+          "PT equalization in",
+        )
+      : 0n
+  const syDelta =
+    params.ownedSy > 0n
+      ? assertU64(
+          ceilMulDivU128(params.ownedSy, params.liquidityDelta, params.lActual, "SY equalization in"),
+          "SY equalization in",
+        )
+      : 0n
+
+  return [ptDelta, syDelta]
+}
+
+const computeRemoveDeltas = (params: { shareDeltaRaw: bigint; node: Tick; supply: bigint }): [bigint, bigint] => {
+  const burnShares = fastFloorU128(params.shareDeltaRaw)
+  const ptDelta = assertU64(
+    checkedMulU128(burnShares, params.node.principalPt, "PT equalization out product") / params.supply,
+    "PT equalization out",
+  )
+  const syDelta = assertU64(
+    checkedMulU128(burnShares, params.node.principalSy, "SY equalization out product") / params.supply,
+    "SY equalization out",
+  )
+
+  return [ptDelta, syDelta]
+}
+
+const summarizePlan = (plan: CrossingEqualizationPlanStep[]): ExistingPositionEqualization => {
+  let sySpent = 0n
+  let ptSpent = 0n
+  let syReleased = 0n
+  let ptReleased = 0n
+
+  for (const step of plan) {
+    if (step.direction === "add") {
+      sySpent = checkedAddU64(sySpent, step.syDelta, "equalization sy spent")
+      ptSpent = checkedAddU64(ptSpent, step.ptDelta, "equalization pt spent")
+      continue
+    }
+
+    syReleased = checkedAddU64(syReleased, step.syDelta, "equalization sy released")
+    ptReleased = checkedAddU64(ptReleased, step.ptDelta, "equalization pt released")
+  }
+
+  return {
+    sySpent,
+    ptSpent,
+    syReleased,
+    ptReleased,
+    plan,
+  }
+}
+
+/**
+ * Mirrors `precalc_existing_position_add_liquidity` from the CLMM program.
+ *
+ * The returned `ptSpent` and `sySpent` are the exact token budget that must be
+ * reserved before adding more liquidity to a position with an active crossing split.
+ * All PreciseNumber operations are performed on raw fixed-point `bigint` values so
+ * the rounding matches the contract's `fast_floor_u128`, `fast_mul_ratio`, and
+ * `muldiv_ceil_u128` paths.
+ */
+export function computeExistingPositionEqualization(
+  ticks: Ticks,
+  position: LpPositionCLMM,
+): ExistingPositionEqualization {
+  if (!isCrossingSplitActive(position)) {
+    return summarizePlan([])
+  }
+
+  const lActual = assertU64(position.crossingSplit.lpBalanceCrossing, "lpBalanceCrossing")
+  const lpBalance = assertU64(position.lpBalance, "lpBalance")
+
+  if (lpBalance === lActual) {
+    return summarizePlan([])
+  }
+  if (lActual === 0n) {
+    throw invariantError("active crossing split has zero actual liquidity")
+  }
+
+  const direction: CrossingEqualizationDirection = lpBalance > lActual ? "add" : "remove"
+  const liquidityDelta = lpBalance > lActual ? lpBalance - lActual : lActual - lpBalance
+  const plan: CrossingEqualizationPlanStep[] = []
+  let sawCrossingRangeShare = false
+  let skippedCrossingShareDueToDust = false
+
+  for (let shareIndex = 0; shareIndex < position.shareTrackers.length; shareIndex++) {
+    const share = position.shareTrackers[shareIndex]
+    if (!shareIsWithinCrossingRange(ticks, position, share)) {
+      continue
+    }
+
+    sawCrossingRangeShare = true
+    const node = getTickByIndex(ticks, share.tickIdx)
+    const supply = fastFloorU128(node.principalShareSupply)
+    if (supply === 0n) {
+      skippedCrossingShareDueToDust = true
+      continue
+    }
+
+    const shareFloor = fastFloorU128(share.lpShare)
+    if (shareFloor === 0n) {
+      skippedCrossingShareDueToDust = true
+      continue
+    }
+
+    const ownedPt = assertU64(checkedMulU128(shareFloor, node.principalPt, "owned PT product") / supply, "owned PT")
+    const ownedSy = assertU64(checkedMulU128(shareFloor, node.principalSy, "owned SY product") / supply, "owned SY")
+    const shareDeltaRaw = fastMulRatioRaw(share.lpShare, liquidityDelta, lActual, "share delta")
+
+    let deltas: [bigint, bigint]
+    if (direction === "add") {
+      deltas = computeAddDeltas({
+        ownedPt,
+        ownedSy,
+        liquidityDelta,
+        lActual,
+      })
+    } else {
+      deltas = computeRemoveDeltas({
+        shareDeltaRaw,
+        node,
+        supply,
+      })
+    }
+    const [ptDelta, syDelta] = deltas
+
+    if (shareDeltaRaw === 0n && ptDelta === 0n && syDelta === 0n) {
+      skippedCrossingShareDueToDust = true
+      continue
+    }
+
+    plan.push({
+      shareIndex,
+      tickIdx: share.tickIdx,
+      direction,
+      shareDeltaRaw,
+      ptDelta,
+      syDelta,
+    })
+  }
+
+  if (plan.length === 0 && sawCrossingRangeShare && skippedCrossingShareDueToDust) {
+    return summarizePlan([])
+  }
+  if (plan.length === 0) {
+    throw invariantError("active crossing split has no equalizable crossing-range shares")
+  }
+
+  return summarizePlan(plan)
+}
+
+/**
+ * Mirrors the contract's `compute_existing_position_budget_effect`.
+ *
+ * It throws the same invariant class when the supplied user budgets cannot cover
+ * the fixed equalization spend, for example `userMaxPt=0` while `ptSpent>0`.
+ */
+export function computeExistingPositionBudgetEffect(params: {
+  ticks: Ticks
+  position: LpPositionCLMM
+  userMaxSy: bigint
+  userMaxPt: bigint
+}): ExistingPositionBudgetEffect {
+  const equalization = computeExistingPositionEqualization(params.ticks, params.position)
+  const effectiveMaxSy = checkedAddU64(
+    checkedSubU64(params.userMaxSy, equalization.sySpent, "effective max SY"),
+    equalization.syReleased,
+    "effective max SY",
+  )
+  const effectiveMaxPt = checkedAddU64(
+    checkedSubU64(params.userMaxPt, equalization.ptSpent, "effective max PT"),
+    equalization.ptReleased,
+    "effective max PT",
+  )
+
+  return {
+    userMaxSy: params.userMaxSy,
+    userMaxPt: params.userMaxPt,
+    effectiveMaxSy,
+    effectiveMaxPt,
+    fixedSySpent: equalization.sySpent,
+    fixedPtSpent: equalization.ptSpent,
+    fixedSyReleased: equalization.syReleased,
+    fixedPtReleased: equalization.ptReleased,
+  }
+}
+
+/**
+ * Mirrors `required_user_max_sy/pt`: expands a desired post-equalization budget
+ * into the user-facing max token amounts that should be passed to the instruction.
+ */
+export function computeRequiredUserMaxForExistingPositionEqualization(params: {
+  ticks: Ticks
+  position: LpPositionCLMM
+  desiredEffectiveMaxSy: bigint
+  desiredEffectiveMaxPt: bigint
+}): { userMaxSy: bigint; userMaxPt: bigint; equalization: ExistingPositionEqualization } {
+  const equalization = computeExistingPositionEqualization(params.ticks, params.position)
+  const userMaxSy = checkedSubU64(
+    checkedAddU64(params.desiredEffectiveMaxSy, equalization.sySpent, "required user max SY"),
+    equalization.syReleased,
+    "required user max SY",
+  )
+  const userMaxPt = checkedSubU64(
+    checkedAddU64(params.desiredEffectiveMaxPt, equalization.ptSpent, "required user max PT"),
+    equalization.ptReleased,
+    "required user max PT",
+  )
+
+  return {
+    userMaxSy,
+    userMaxPt,
+    equalization,
+  }
+}

package/src/index.ts

@@ -56,6 +56,17 @@ export {
   simulateWrapperProvideLiquidity,
   simulateSwapAndSupply,
 } from "./addLiquidity"
+export {
+  computeExistingPositionBudgetEffect,
+  computeExistingPositionEqualization,
+  computeRequiredUserMaxForExistingPositionEqualization,
+} from "./existingPositionEqualization"
+export type {
+  CrossingEqualizationDirection,
+  CrossingEqualizationPlanStep,
+  ExistingPositionBudgetEffect,
+  ExistingPositionEqualization,
+} from "./existingPositionEqualization"
 
 export { getPtAndSyOnWithdrawLiquidity } from "./withdrawLiquidity"
 

package/src/utils.ts

@@ -219,18 +219,20 @@ export function findTickByIndex(ticks: Ticks, index: number): Tick {
   return ticks.ticksTree.at(index - 1) ?? null
 }
 
+const CLMM_TICK_KEY_SCALE = 10_000
+
 /**
- * Convert APY percentage to basis points
+ * Convert APY percentage to CLMM tick-key units.
  */
 export function convertApyToApyBp(apyPercent: number): number {
-  return Math.round(apyPercent * 100)
+  return Math.round(apyPercent * CLMM_TICK_KEY_SCALE)
 }
 
 /**
- * Convert basis points to APY percentage
+ * Convert CLMM tick-key units to APY percentage.
  */
 export function convertApyBpToApy(apyBp: number): number {
-  return apyBp / 100
+  return apyBp / CLMM_TICK_KEY_SCALE
 }
 
 export function bigIntMax(...args: bigint[]): bigint {