@byreal-io/byreal-clmm-sdk 0.2.0

package/dist/esm/instructions/utils/liquidityMath.d.ts

@@ -0,0 +1,30 @@
+import BN from 'bn.js';
+export declare class LiquidityMath {
+    static addDelta(x: BN, y: BN): BN;
+    static getTokenAmountAFromLiquidity(sqrtPriceX64A: BN, sqrtPriceX64B: BN, liquidity: BN, roundUp: boolean): BN;
+    static getTokenAmountBFromLiquidity(sqrtPriceX64A: BN, sqrtPriceX64B: BN, liquidity: BN, roundUp: boolean): BN;
+    static getLiquidityFromTokenAmountA(sqrtPriceX64A: BN, sqrtPriceX64B: BN, amountA: BN, roundUp: boolean): BN;
+    static getLiquidityFromTokenAmountB(sqrtPriceX64A: BN, sqrtPriceX64B: BN, amountB: BN): BN;
+    static getLiquidityFromTokenAmounts(sqrtPriceCurrentX64: BN, sqrtPriceX64A: BN, sqrtPriceX64B: BN, amountA: BN, amountB: BN): BN;
+    static getAmountsFromLiquidity(sqrtPriceCurrentX64: BN, sqrtPriceX64A: BN, sqrtPriceX64B: BN, liquidity: BN, roundUp: boolean): {
+        amountA: BN;
+        amountB: BN;
+    };
+    static getAmountsFromLiquidityWithSlippage(sqrtPriceCurrentX64: BN, sqrtPriceX64A: BN, sqrtPriceX64B: BN, liquidity: BN, amountMax: boolean, roundUp: boolean, amountSlippage: number): {
+        amountSlippageA: BN;
+        amountSlippageB: BN;
+    };
+    /**
+     * Given a price range, calculate the required tokenB amount after investing a specified tokenA amount
+     *
+     * Similar implementation in raydium: getLiquidityAmountOutFromAmountIn
+     */
+    static getAmountBFromAmountA(startSqrtPriceX64: BN, endSqrtPriceX64: BN, currentSqrtPriceX64: BN, amountA: BN): BN;
+    /**
+     * Given a price range, calculate the required tokenA amount after investing a specified tokenB amount
+     *
+     * Similar implementation in raydium: getLiquidityAmountOutFromAmountIn
+     */
+    static getAmountAFromAmountB(startSqrtPriceX64: BN, endSqrtPriceX64: BN, currentSqrtPriceX64: BN, amountB: BN): BN;
+}
+//# sourceMappingURL=liquidityMath.d.ts.map

package/dist/esm/instructions/utils/liquidityMath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquidityMath.d.ts","sourceRoot":"","sources":["../../../../src/instructions/utils/liquidityMath.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,OAAO,CAAC;AAOvB,qBAAa,aAAa;WACV,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE;WAI1B,4BAA4B,CACxC,aAAa,EAAE,EAAE,EACjB,aAAa,EAAE,EAAE,EACjB,SAAS,EAAE,EAAE,EACb,OAAO,EAAE,OAAO,GACf,EAAE;WAiBS,4BAA4B,CACxC,aAAa,EAAE,EAAE,EACjB,aAAa,EAAE,EAAE,EACjB,SAAS,EAAE,EAAE,EACb,OAAO,EAAE,OAAO,GACf,EAAE;WAaS,4BAA4B,CAAC,aAAa,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE;WAgBrG,4BAA4B,CAAC,aAAa,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE;WAOnF,4BAA4B,CACxC,mBAAmB,EAAE,EAAE,EACvB,aAAa,EAAE,EAAE,EACjB,aAAa,EAAE,EAAE,EACjB,OAAO,EAAE,EAAE,EACX,OAAO,EAAE,EAAE,GACV,EAAE;WAgBS,uBAAuB,CACnC,mBAAmB,EAAE,EAAE,EACvB,aAAa,EAAE,EAAE,EACjB,aAAa,EAAE,EAAE,EACjB,SAAS,EAAE,EAAE,EACb,OAAO,EAAE,OAAO,GACf;QAAE,OAAO,EAAE,EAAE,CAAC;QAAC,OAAO,EAAE,EAAE,CAAA;KAAE;WAgCjB,mCAAmC,CAC/C,mBAAmB,EAAE,EAAE,EACvB,aAAa,EAAE,EAAE,EACjB,aAAa,EAAE,EAAE,EACjB,SAAS,EAAE,EAAE,EACb,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,GACrB;QAAE,eAAe,EAAE,EAAE,CAAC;QAAC,eAAe,EAAE,EAAE,CAAA;KAAE;IAkB/C;;;;OAIG;WACW,qBAAqB,CACjC,iBAAiB,EAAE,EAAE,EACrB,eAAe,EAAE,EAAE,EACnB,mBAAmB,EAAE,EAAE,EACvB,OAAO,EAAE,EAAE,GACV,EAAE;IAgBL;;;;OAIG;WACW,qBAAqB,CACjC,iBAAiB,EAAE,EAAE,EACrB,eAAe,EAAE,EAAE,EACnB,mBAAmB,EAAE,EAAE,EACvB,OAAO,EAAE,EAAE,GACV,EAAE;CAcN"}

package/dist/esm/instructions/utils/liquidityMath.js

@@ -0,0 +1,138 @@
+import BN from 'bn.js';
+import { Decimal } from 'decimal.js';
+import { MaxU64, ONE, Q64, U64Resolution, ZERO } from '../constants.js';
+import { MathUtils } from './mathUtils.js';
+export class LiquidityMath {
+    static addDelta(x, y) {
+        return x.add(y);
+    }
+    static getTokenAmountAFromLiquidity(sqrtPriceX64A, sqrtPriceX64B, liquidity, roundUp) {
+        if (sqrtPriceX64A.gt(sqrtPriceX64B)) {
+            [sqrtPriceX64A, sqrtPriceX64B] = [sqrtPriceX64B, sqrtPriceX64A];
+        }
+        if (!sqrtPriceX64A.gt(ZERO)) {
+            throw new Error('sqrtPriceX64A must greater than 0');
+        }
+        const numerator1 = liquidity.ushln(U64Resolution);
+        const numerator2 = sqrtPriceX64B.sub(sqrtPriceX64A);
+        return roundUp
+            ? MathUtils.mulDivRoundingUp(MathUtils.mulDivCeil(numerator1, numerator2, sqrtPriceX64B), ONE, sqrtPriceX64A)
+            : MathUtils.mulDivFloor(numerator1, numerator2, sqrtPriceX64B).div(sqrtPriceX64A);
+    }
+    static getTokenAmountBFromLiquidity(sqrtPriceX64A, sqrtPriceX64B, liquidity, roundUp) {
+        if (sqrtPriceX64A.gt(sqrtPriceX64B)) {
+            [sqrtPriceX64A, sqrtPriceX64B] = [sqrtPriceX64B, sqrtPriceX64A];
+        }
+        if (!sqrtPriceX64A.gt(ZERO)) {
+            throw new Error('sqrtPriceX64A must greater than 0');
+        }
+        return roundUp
+            ? MathUtils.mulDivCeil(liquidity, sqrtPriceX64B.sub(sqrtPriceX64A), Q64)
+            : MathUtils.mulDivFloor(liquidity, sqrtPriceX64B.sub(sqrtPriceX64A), Q64);
+    }
+    static getLiquidityFromTokenAmountA(sqrtPriceX64A, sqrtPriceX64B, amountA, roundUp) {
+        if (sqrtPriceX64A.gt(sqrtPriceX64B)) {
+            [sqrtPriceX64A, sqrtPriceX64B] = [sqrtPriceX64B, sqrtPriceX64A];
+        }
+        const numerator = amountA.mul(sqrtPriceX64A).mul(sqrtPriceX64B);
+        const denominator = sqrtPriceX64B.sub(sqrtPriceX64A);
+        const result = numerator.div(denominator);
+        if (roundUp) {
+            return MathUtils.mulDivRoundingUp(result, ONE, MaxU64);
+        }
+        else {
+            return result.shrn(U64Resolution);
+        }
+    }
+    static getLiquidityFromTokenAmountB(sqrtPriceX64A, sqrtPriceX64B, amountB) {
+        if (sqrtPriceX64A.gt(sqrtPriceX64B)) {
+            [sqrtPriceX64A, sqrtPriceX64B] = [sqrtPriceX64B, sqrtPriceX64A];
+        }
+        return MathUtils.mulDivFloor(amountB, MaxU64, sqrtPriceX64B.sub(sqrtPriceX64A));
+    }
+    static getLiquidityFromTokenAmounts(sqrtPriceCurrentX64, sqrtPriceX64A, sqrtPriceX64B, amountA, amountB) {
+        if (sqrtPriceX64A.gt(sqrtPriceX64B)) {
+            [sqrtPriceX64A, sqrtPriceX64B] = [sqrtPriceX64B, sqrtPriceX64A];
+        }
+        if (sqrtPriceCurrentX64.lte(sqrtPriceX64A)) {
+            return LiquidityMath.getLiquidityFromTokenAmountA(sqrtPriceX64A, sqrtPriceX64B, amountA, false);
+        }
+        else if (sqrtPriceCurrentX64.lt(sqrtPriceX64B)) {
+            const liquidity0 = LiquidityMath.getLiquidityFromTokenAmountA(sqrtPriceCurrentX64, sqrtPriceX64B, amountA, false);
+            const liquidity1 = LiquidityMath.getLiquidityFromTokenAmountB(sqrtPriceX64A, sqrtPriceCurrentX64, amountB);
+            return liquidity0.lt(liquidity1) ? liquidity0 : liquidity1;
+        }
+        else {
+            return LiquidityMath.getLiquidityFromTokenAmountB(sqrtPriceX64A, sqrtPriceX64B, amountB);
+        }
+    }
+    static getAmountsFromLiquidity(sqrtPriceCurrentX64, sqrtPriceX64A, sqrtPriceX64B, liquidity, roundUp) {
+        if (sqrtPriceX64A.gt(sqrtPriceX64B)) {
+            [sqrtPriceX64A, sqrtPriceX64B] = [sqrtPriceX64B, sqrtPriceX64A];
+        }
+        if (sqrtPriceCurrentX64.lte(sqrtPriceX64A)) {
+            return {
+                amountA: LiquidityMath.getTokenAmountAFromLiquidity(sqrtPriceX64A, sqrtPriceX64B, liquidity, roundUp),
+                amountB: new BN(0),
+            };
+        }
+        else if (sqrtPriceCurrentX64.lt(sqrtPriceX64B)) {
+            const amountA = LiquidityMath.getTokenAmountAFromLiquidity(sqrtPriceCurrentX64, sqrtPriceX64B, liquidity, roundUp);
+            const amountB = LiquidityMath.getTokenAmountBFromLiquidity(sqrtPriceX64A, sqrtPriceCurrentX64, liquidity, roundUp);
+            return { amountA, amountB };
+        }
+        else {
+            return {
+                amountA: new BN(0),
+                amountB: LiquidityMath.getTokenAmountBFromLiquidity(sqrtPriceX64A, sqrtPriceX64B, liquidity, roundUp),
+            };
+        }
+    }
+    static getAmountsFromLiquidityWithSlippage(sqrtPriceCurrentX64, sqrtPriceX64A, sqrtPriceX64B, liquidity, amountMax, roundUp, amountSlippage) {
+        const { amountA, amountB } = LiquidityMath.getAmountsFromLiquidity(sqrtPriceCurrentX64, sqrtPriceX64A, sqrtPriceX64B, liquidity, roundUp);
+        const coefficient = amountMax ? 1 + amountSlippage : 1 - amountSlippage;
+        const amount0Slippage = new BN(new Decimal(amountA.toString()).mul(coefficient).toFixed(0));
+        const amount1Slippage = new BN(new Decimal(amountB.toString()).mul(coefficient).toFixed(0));
+        return {
+            amountSlippageA: amount0Slippage,
+            amountSlippageB: amount1Slippage,
+        };
+    }
+    /**
+     * Given a price range, calculate the required tokenB amount after investing a specified tokenA amount
+     *
+     * Similar implementation in raydium: getLiquidityAmountOutFromAmountIn
+     */
+    static getAmountBFromAmountA(startSqrtPriceX64, endSqrtPriceX64, currentSqrtPriceX64, amountA) {
+        if (startSqrtPriceX64.gt(endSqrtPriceX64)) {
+            [startSqrtPriceX64, endSqrtPriceX64] = [endSqrtPriceX64, startSqrtPriceX64];
+        }
+        if (currentSqrtPriceX64.lte(startSqrtPriceX64)) {
+            return new BN(0);
+        }
+        if (currentSqrtPriceX64.gt(endSqrtPriceX64)) {
+            return new BN(0);
+        }
+        const liquidity = LiquidityMath.getLiquidityFromTokenAmountA(currentSqrtPriceX64, endSqrtPriceX64, amountA, false);
+        return LiquidityMath.getTokenAmountBFromLiquidity(startSqrtPriceX64, currentSqrtPriceX64, liquidity, true);
+    }
+    /**
+     * Given a price range, calculate the required tokenA amount after investing a specified tokenB amount
+     *
+     * Similar implementation in raydium: getLiquidityAmountOutFromAmountIn
+     */
+    static getAmountAFromAmountB(startSqrtPriceX64, endSqrtPriceX64, currentSqrtPriceX64, amountB) {
+        if (startSqrtPriceX64.gt(endSqrtPriceX64)) {
+            [startSqrtPriceX64, endSqrtPriceX64] = [endSqrtPriceX64, startSqrtPriceX64];
+        }
+        if (currentSqrtPriceX64.lte(startSqrtPriceX64)) {
+            return new BN(0);
+        }
+        if (currentSqrtPriceX64.gt(endSqrtPriceX64)) {
+            return new BN(0);
+        }
+        const liquidity = LiquidityMath.getLiquidityFromTokenAmountB(startSqrtPriceX64, currentSqrtPriceX64, amountB);
+        return LiquidityMath.getTokenAmountAFromLiquidity(currentSqrtPriceX64, endSqrtPriceX64, liquidity, true);
+    }
+}
+//# sourceMappingURL=liquidityMath.js.map

package/dist/esm/instructions/utils/liquidityMath.js.map

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

package/dist/esm/instructions/utils/mathUtils.d.ts

@@ -0,0 +1,11 @@
+import BN from 'bn.js';
+import { Decimal } from 'decimal.js';
+export declare class MathUtils {
+    static mulDivRoundingUp(a: BN, b: BN, denominator: BN): BN;
+    static mulDivFloor(a: BN, b: BN, denominator: BN): BN;
+    static mulDivCeil(a: BN, b: BN, denominator: BN): BN;
+    static x64ToDecimal(num: BN, decimalPlaces?: number): Decimal;
+    static decimalToX64(num: Decimal): BN;
+    static wrappingSubU128(n0: BN, n1: BN): BN;
+}
+//# sourceMappingURL=mathUtils.d.ts.map

package/dist/esm/instructions/utils/mathUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mathUtils.d.ts","sourceRoot":"","sources":["../../../../src/instructions/utils/mathUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAIrC,qBAAa,SAAS;WACN,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE;WASnD,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE;WAO9C,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE;WAQ7C,YAAY,CAAC,GAAG,EAAE,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO;WAItD,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,EAAE;WAI9B,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE;CAGlD"}

package/dist/esm/instructions/utils/mathUtils.js

@@ -0,0 +1,36 @@
+import BN from 'bn.js';
+import { Decimal } from 'decimal.js';
+import { ONE, Q128, ZERO } from '../constants.js';
+export class MathUtils {
+    static mulDivRoundingUp(a, b, denominator) {
+        const numerator = a.mul(b);
+        let result = numerator.div(denominator);
+        if (!numerator.mod(denominator).eq(ZERO)) {
+            result = result.add(ONE);
+        }
+        return result;
+    }
+    static mulDivFloor(a, b, denominator) {
+        if (denominator.eq(ZERO)) {
+            throw new Error('division by 0');
+        }
+        return a.mul(b).div(denominator);
+    }
+    static mulDivCeil(a, b, denominator) {
+        if (denominator.eq(ZERO)) {
+            throw new Error('division by 0');
+        }
+        const numerator = a.mul(b).add(denominator.sub(ONE));
+        return numerator.div(denominator);
+    }
+    static x64ToDecimal(num, decimalPlaces) {
+        return new Decimal(num.toString()).div(Decimal.pow(2, 64)).toDecimalPlaces(decimalPlaces);
+    }
+    static decimalToX64(num) {
+        return new BN(num.mul(Decimal.pow(2, 64)).floor().toFixed());
+    }
+    static wrappingSubU128(n0, n1) {
+        return n0.add(Q128).sub(n1).mod(Q128);
+    }
+}
+//# sourceMappingURL=mathUtils.js.map

package/dist/esm/instructions/utils/mathUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mathUtils.js","sourceRoot":"","sources":["../../../../src/instructions/utils/mathUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,OAAO,SAAS;IACb,MAAM,CAAC,gBAAgB,CAAC,CAAK,EAAE,CAAK,EAAE,WAAe;QAC1D,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEM,MAAM,CAAC,WAAW,CAAC,CAAK,EAAE,CAAK,EAAE,WAAe;QACrD,IAAI,WAAW,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;IAEM,MAAM,CAAC,UAAU,CAAC,CAAK,EAAE,CAAK,EAAE,WAAe;QACpD,IAAI,WAAW,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,OAAO,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IAEM,MAAM,CAAC,YAAY,CAAC,GAAO,EAAE,aAAsB;QACxD,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IAC5F,CAAC;IAEM,MAAM,CAAC,YAAY,CAAC,GAAY;QACrC,OAAO,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAEM,MAAM,CAAC,eAAe,CAAC,EAAM,EAAE,EAAM;QAC1C,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/esm/instructions/utils/models.d.ts

@@ -0,0 +1,93 @@
+import { PublicKey } from '@solana/web3.js';
+import BN from 'bn.js';
+import { Decimal } from 'decimal.js';
+export interface ReturnTypeGetPriceAndTick {
+    tick: number;
+    price: Decimal;
+}
+export type Tick = {
+    tick: number;
+    liquidityNet: BN;
+    liquidityGross: BN;
+    feeGrowthOutsideX64A: BN;
+    feeGrowthOutsideX64B: BN;
+    rewardGrowthsOutsideX64: BN[];
+};
+export type TickArray = {
+    address: PublicKey;
+    poolId: PublicKey;
+    startTickIndex: number;
+    ticks: Tick[];
+    initializedTickCount: number;
+};
+/**
+ * Dynamic Tick Array type
+ * Uses sparse storage with a mapping table to track allocated tick positions
+ */
+export type DynTickArray = {
+    address: PublicKey;
+    poolId: PublicKey;
+    startTickIndex: number;
+    tickOffsetIndex: number[];
+    allocTickCount: number;
+    initializedTickCount: number;
+    ticks: Tick[];
+};
+/**
+ * Unified Tick Array Container
+ * Discriminated union to handle both fixed and dynamic tick arrays
+ */
+export type TickArrayContainer = {
+    type: 'Fixed';
+    data: TickArray;
+} | {
+    type: 'Dynamic';
+    data: DynTickArray;
+};
+/**
+ * Type guard to check if a container is a fixed tick array
+ */
+export declare function isFixedTickArray(container: TickArrayContainer): container is {
+    type: 'Fixed';
+    data: TickArray;
+};
+/**
+ * Type guard to check if a container is a dynamic tick array
+ */
+export declare function isDynamicTickArray(container: TickArrayContainer): container is {
+    type: 'Dynamic';
+    data: DynTickArray;
+};
+export type TickState = {
+    tick: number;
+    liquidityNet: BN;
+    liquidityGross: BN;
+    feeGrowthOutsideX64A: BN;
+    feeGrowthOutsideX64B: BN;
+    tickCumulativeOutside: BN;
+    secondsPerLiquidityOutsideX64: BN;
+    secondsOutside: number;
+    rewardGrowthsOutside: BN[];
+};
+export type TickArrayState = {
+    ammPool: PublicKey;
+    startTickIndex: number;
+    ticks: TickState[];
+    initializedTickCount: number;
+};
+export interface TickArrayBitmapExtensionType {
+    poolId: PublicKey;
+    exBitmapAddress: PublicKey;
+    positiveTickArrayBitmap: BN[][];
+    negativeTickArrayBitmap: BN[][];
+}
+export interface StepComputations {
+    sqrtPriceStartX64: BN;
+    tickNext: number;
+    initialized: boolean;
+    sqrtPriceNextX64: BN;
+    amountIn: BN;
+    amountOut: BN;
+    feeAmount: BN;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/esm/instructions/utils/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../../src/instructions/utils/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,EAAE,CAAC;IACjB,cAAc,EAAE,EAAE,CAAC;IACnB,oBAAoB,EAAE,EAAE,CAAC;IACzB,oBAAoB,EAAE,EAAE,CAAC;IACzB,uBAAuB,EAAE,EAAE,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,IAAI,EAAE,CAAC;CACf,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAE9G;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,kBAAkB,GAAG,SAAS,IAAI;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAE/G;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,kBAAkB,GAC5B,SAAS,IAAI;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAEtD;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,EAAE,CAAC;IACjB,cAAc,EAAE,EAAE,CAAC;IACnB,oBAAoB,EAAE,EAAE,CAAC;IACzB,oBAAoB,EAAE,EAAE,CAAC;IACzB,qBAAqB,EAAE,EAAE,CAAC;IAC1B,6BAA6B,EAAE,EAAE,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,EAAE,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,SAAS,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,SAAS,CAAC;IAClB,eAAe,EAAE,SAAS,CAAC;IAC3B,uBAAuB,EAAE,EAAE,EAAE,EAAE,CAAC;IAChC,uBAAuB,EAAE,EAAE,EAAE,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,EAAE,CAAC;IACrB,QAAQ,EAAE,EAAE,CAAC;IACb,SAAS,EAAE,EAAE,CAAC;IACd,SAAS,EAAE,EAAE,CAAC;CACf"}

package/dist/esm/instructions/utils/models.js

@@ -0,0 +1,13 @@
+/**
+ * Type guard to check if a container is a fixed tick array
+ */
+export function isFixedTickArray(container) {
+    return container.type === 'Fixed';
+}
+/**
+ * Type guard to check if a container is a dynamic tick array
+ */
+export function isDynamicTickArray(container) {
+    return container.type === 'Dynamic';
+}
+//# sourceMappingURL=models.js.map

package/dist/esm/instructions/utils/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../../src/instructions/utils/models.ts"],"names":[],"mappings":"AA8CA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAA6B;IAC5D,OAAO,SAAS,CAAC,IAAI,KAAK,OAAO,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAA6B;IAE7B,OAAO,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC;AACtC,CAAC"}

package/dist/esm/instructions/utils/poolStateUtils.d.ts

@@ -0,0 +1,134 @@
+import { Connection, PublicKey } from '@solana/web3.js';
+import { IPoolLayout } from '../layout.js';
+/**
+ * Pool State Utilities for querying pool information with decay fee support
+ */
+export declare class PoolStateUtils {
+    /**
+     * Check if the pool has decay fee enabled
+     * @param poolInfo Pool layout information
+     * @returns boolean indicating if decay fee is enabled
+     */
+    static isDecayFeeEnabled(poolInfo: IPoolLayout): boolean;
+    /**
+     * Check if decay fee is enabled for selling mint0
+     * @param poolInfo Pool layout information
+     * @returns boolean indicating if decay fee is enabled for mint0 sell
+     */
+    static isDecayFeeOnSellMint0(poolInfo: IPoolLayout): boolean;
+    /**
+     * Check if decay fee is enabled for selling mint1
+     * @param poolInfo Pool layout information
+     * @returns boolean indicating if decay fee is enabled for mint1 sell
+     */
+    static isDecayFeeOnSellMint1(poolInfo: IPoolLayout): boolean;
+    /**
+     * Calculate the current decay fee rate based on the current time
+     * @param poolInfo Pool layout information
+     * @param currentTimestamp Current timestamp in seconds
+     * @returns Decay fee rate in hundredths of a bip (10^-6)
+     */
+    static getDecayFeeRate(poolInfo: IPoolLayout, currentTimestamp: number): number;
+    /**
+     * Get comprehensive decay fee information for a pool
+     * @param poolInfo Pool layout information
+     * @param currentTimestamp Current timestamp in seconds
+     * @returns Object containing all decay fee related information
+     */
+    static getDecayFeeInfo(poolInfo: IPoolLayout, currentTimestamp?: number): {
+        isEnabled: boolean;
+        onSellMint0: boolean;
+        onSellMint1: boolean;
+        initFeeRate: number;
+        decreaseRate: number;
+        decreaseInterval: number;
+        currentFeeRate: number;
+        openTime: any;
+    };
+    /**
+     * Get pool state with decay fee information from chain
+     * @param connection Solana connection
+     * @param poolId Pool address
+     * @param currentTimestamp Optional current timestamp
+     * @returns Pool information with decay fee details
+     */
+    static getPoolStateWithDecayFee(connection: Connection, poolId: string | PublicKey, currentTimestamp?: number): Promise<{
+        decayFeeInfo: {
+            isEnabled: boolean;
+            onSellMint0: boolean;
+            onSellMint1: boolean;
+            initFeeRate: number;
+            decreaseRate: number;
+            decreaseInterval: number;
+            currentFeeRate: number;
+            openTime: any;
+        };
+        bump: number;
+        tickSpacing: number;
+        recentEpoch: BN;
+        ammConfig: PublicKey;
+        creator: PublicKey;
+        mintA: PublicKey;
+        mintB: PublicKey;
+        vaultA: PublicKey;
+        vaultB: PublicKey;
+        observationId: PublicKey;
+        mintDecimalsA: number;
+        mintDecimalsB: number;
+        liquidity: BN;
+        sqrtPriceX64: BN;
+        tickCurrent: number;
+        feeGrowthGlobalX64A: BN;
+        feeGrowthGlobalX64B: BN;
+        protocolFeesTokenA: BN;
+        protocolFeesTokenB: BN;
+        swapInAmountTokenA: BN;
+        swapOutAmountTokenB: BN;
+        swapInAmountTokenB: BN;
+        swapOutAmountTokenA: BN;
+        status: number;
+        openTime: BN;
+        rewardInfos: {
+            creator: PublicKey;
+            rewardState: number;
+            openTime: BN;
+            endTime: BN;
+            lastUpdateTime: BN;
+            emissionsPerSecondX64: BN;
+            rewardTotalEmissioned: BN;
+            rewardClaimed: BN;
+            tokenMint: PublicKey;
+            tokenVault: PublicKey;
+            rewardGrowthGlobalX64: BN;
+        }[];
+        tickArrayBitmap: BN[];
+        totalFeesTokenA: BN;
+        totalFeesClaimedTokenA: BN;
+        totalFeesTokenB: BN;
+        totalFeesClaimedTokenB: BN;
+        fundFeesTokenA: BN;
+        fundFeesTokenB: BN;
+        decayFeeFlag: number;
+        decayFeeInitFeeRate: number;
+        decayFeeDecreaseRate: number;
+        decayFeeDecreaseInterval: number;
+        padding1_1: number[];
+        padding1: BN[];
+        padding2: BN[];
+        currentPrice: number;
+        programId: PublicKey;
+        poolId: PublicKey;
+    }>;
+    /**
+     * Check if decay fee is currently active for a specific direction
+     * @param poolInfo Pool layout information
+     * @param zeroForOne True if swapping token0 for token1 (selling token0)
+     * @param currentTimestamp Current timestamp in seconds
+     * @returns Object with active status and current fee rate
+     */
+    static getDecayFeeForDirection(poolInfo: IPoolLayout, zeroForOne: boolean, currentTimestamp?: number): {
+        isActive: boolean;
+        feeRate: number;
+    };
+}
+//# sourceMappingURL=poolStateUtils.d.ts.map

package/dist/esm/instructions/utils/poolStateUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poolStateUtils.d.ts","sourceRoot":"","sources":["../../../../src/instructions/utils/poolStateUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;GAEG;AACH,qBAAa,cAAc;IACzB;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO;IAIxD;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO;IAI5D;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO;IAI5D;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM;IAwC/E;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,gBAAgB,CAAC,EAAE,MAAM;;;;;;;;;;IAevE;;;;;;OAMG;WACU,wBAAwB,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,gBAAgB,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkBnH;;;;;;OAMG;IACH,MAAM,CAAC,uBAAuB,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAAE,MAAM;;;;CA4BrG"}

package/dist/esm/instructions/utils/poolStateUtils.js

@@ -0,0 +1,137 @@
+import { RawDataUtils } from '../getRawData.js';
+/**
+ * Pool State Utilities for querying pool information with decay fee support
+ */
+export class PoolStateUtils {
+    /**
+     * Check if the pool has decay fee enabled
+     * @param poolInfo Pool layout information
+     * @returns boolean indicating if decay fee is enabled
+     */
+    static isDecayFeeEnabled(poolInfo) {
+        return (poolInfo.decayFeeFlag & (1 << 0)) !== 0;
+    }
+    /**
+     * Check if decay fee is enabled for selling mint0
+     * @param poolInfo Pool layout information
+     * @returns boolean indicating if decay fee is enabled for mint0 sell
+     */
+    static isDecayFeeOnSellMint0(poolInfo) {
+        return (poolInfo.decayFeeFlag & (1 << 1)) !== 0;
+    }
+    /**
+     * Check if decay fee is enabled for selling mint1
+     * @param poolInfo Pool layout information
+     * @returns boolean indicating if decay fee is enabled for mint1 sell
+     */
+    static isDecayFeeOnSellMint1(poolInfo) {
+        return (poolInfo.decayFeeFlag & (1 << 2)) !== 0;
+    }
+    /**
+     * Calculate the current decay fee rate based on the current time
+     * @param poolInfo Pool layout information
+     * @param currentTimestamp Current timestamp in seconds
+     * @returns Decay fee rate in hundredths of a bip (10^-6)
+     */
+    static getDecayFeeRate(poolInfo, currentTimestamp) {
+        if (!this.isDecayFeeEnabled(poolInfo)) {
+            return 0;
+        }
+        // Pool is not open yet
+        if (currentTimestamp < poolInfo.openTime.toNumber()) {
+            return 0;
+        }
+        const intervalCount = Math.floor((currentTimestamp - poolInfo.openTime.toNumber()) / poolInfo.decayFeeDecreaseInterval);
+        const decayFeeDecreaseRate = poolInfo.decayFeeDecreaseRate * 10000; // Convert to basis points
+        const FEE_RATE_DENOMINATOR_VALUE = 1000000; // 10^6
+        const hundredthsOfABip = FEE_RATE_DENOMINATOR_VALUE;
+        let rate = hundredthsOfABip;
+        // Fast power calculation: (1 - x)^c
+        // where x = decayFeeDecreaseRate / 10^6, c = intervalCount
+        if (intervalCount > 0) {
+            let exp = intervalCount;
+            let base = hundredthsOfABip - decayFeeDecreaseRate;
+            while (exp > 0) {
+                if (exp % 2 === 1) {
+                    rate = Math.ceil((rate * base) / hundredthsOfABip);
+                }
+                base = Math.ceil((base * base) / hundredthsOfABip);
+                exp = Math.floor(exp / 2);
+            }
+        }
+        // Apply initial fee rate (convert from percentage)
+        rate = Math.ceil((rate * poolInfo.decayFeeInitFeeRate) / 100);
+        return rate;
+    }
+    /**
+     * Get comprehensive decay fee information for a pool
+     * @param poolInfo Pool layout information
+     * @param currentTimestamp Current timestamp in seconds
+     * @returns Object containing all decay fee related information
+     */
+    static getDecayFeeInfo(poolInfo, currentTimestamp) {
+        const timestamp = currentTimestamp || Math.floor(Date.now() / 1000);
+        return {
+            isEnabled: this.isDecayFeeEnabled(poolInfo),
+            onSellMint0: this.isDecayFeeOnSellMint0(poolInfo),
+            onSellMint1: this.isDecayFeeOnSellMint1(poolInfo),
+            initFeeRate: poolInfo.decayFeeInitFeeRate, // Percentage (1 = 1%)
+            decreaseRate: poolInfo.decayFeeDecreaseRate, // Percentage (1 = 1%)
+            decreaseInterval: poolInfo.decayFeeDecreaseInterval, // Seconds
+            currentFeeRate: this.getDecayFeeRate(poolInfo, timestamp), // In hundredths of a bip (10^-6)
+            openTime: poolInfo.openTime.toNumber(),
+        };
+    }
+    /**
+     * Get pool state with decay fee information from chain
+     * @param connection Solana connection
+     * @param poolId Pool address
+     * @param currentTimestamp Optional current timestamp
+     * @returns Pool information with decay fee details
+     */
+    static async getPoolStateWithDecayFee(connection, poolId, currentTimestamp) {
+        const poolInfo = await RawDataUtils.getRawPoolInfoByPoolId({
+            connection,
+            poolId,
+        });
+        if (!poolInfo) {
+            throw new Error(`Pool not found: ${poolId}`);
+        }
+        const decayFeeInfo = this.getDecayFeeInfo(poolInfo, currentTimestamp);
+        return {
+            ...poolInfo,
+            decayFeeInfo,
+        };
+    }
+    /**
+     * Check if decay fee is currently active for a specific direction
+     * @param poolInfo Pool layout information
+     * @param zeroForOne True if swapping token0 for token1 (selling token0)
+     * @param currentTimestamp Current timestamp in seconds
+     * @returns Object with active status and current fee rate
+     */
+    static getDecayFeeForDirection(poolInfo, zeroForOne, currentTimestamp) {
+        const timestamp = currentTimestamp || Math.floor(Date.now() / 1000);
+        if (!this.isDecayFeeEnabled(poolInfo)) {
+            return {
+                isActive: false,
+                feeRate: 0,
+            };
+        }
+        const isActiveForDirection = zeroForOne
+            ? this.isDecayFeeOnSellMint0(poolInfo)
+            : this.isDecayFeeOnSellMint1(poolInfo);
+        if (!isActiveForDirection) {
+            return {
+                isActive: false,
+                feeRate: 0,
+            };
+        }
+        const currentFeeRate = this.getDecayFeeRate(poolInfo, timestamp);
+        return {
+            isActive: true,
+            feeRate: currentFeeRate,
+        };
+    }
+}
+//# sourceMappingURL=poolStateUtils.js.map

package/dist/esm/instructions/utils/poolStateUtils.js.map

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