@stabbleorg/mclmm-sdk 0.1.6 → 0.1.7

package/lib/utils/math.d.ts

@@ -0,0 +1,51 @@
+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;
+}
+export declare class SqrtPriceMath {
+    static sqrtPriceX64ToPrice(sqrtPriceX64: BN, decimalsA: number, decimalsB: number): Decimal;
+    static priceToSqrtPriceX64(price: Decimal, decimalsA: number, decimalsB: number): BN;
+    static getNextSqrtPriceX64FromInput(sqrtPriceX64: BN, liquidity: BN, amountIn: BN, zeroForOne: boolean): BN;
+    static getNextSqrtPriceX64FromOutput(sqrtPriceX64: BN, liquidity: BN, amountOut: BN, zeroForOne: boolean): BN;
+    private static getNextSqrtPriceFromTokenAmountARoundingUp;
+    private static getNextSqrtPriceFromTokenAmountBRoundingDown;
+    static getSqrtPriceX64FromTick(tick: number): BN;
+    static getTickFromPrice(price: Decimal, decimalsA: number, decimalsB: number): number;
+    static getTickFromSqrtPriceX64(sqrtPriceX64: BN): number;
+}
+export declare class TickMath {
+    static getTickWithPriceAndTickspacing(price: Decimal, tickSpacing: number, mintDecimalsA: number, mintDecimalsB: number): number;
+    static roundPriceWithTickspacing(price: Decimal, tickSpacing: number, mintDecimalsA: number, mintDecimalsB: number): Decimal;
+}
+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;
+    };
+}
+export interface StepComputations {
+    sqrtPriceStartX64: BN;
+    tickNext: number;
+    initialized: boolean;
+    sqrtPriceNextX64: BN;
+    amountIn: BN;
+    amountOut: BN;
+    feeAmount: BN;
+}
+//# sourceMappingURL=math.d.ts.map

package/lib/utils/math.d.ts.map

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

package/lib/utils/pda.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Program Derived Address (PDA) utilities
+ * Handles address derivation for all CLMM account types
+ */
+import { type Address, type ProgramDerivedAddress } from "@solana/kit";
+export declare class PdaUtils {
+    /**
+     * Derive pool state PDA
+     * @param ammConfig - AMM config address
+     * @param tokenMintA - Token A mint address
+     * @param tokenMintB - Token B mint address
+     * @returns Pool state PDA
+     */
+    static getPoolStatePda(ammConfig: Address, tokenMintA: Address, tokenMintB: Address): Promise<ProgramDerivedAddress>;
+    /**
+     * Derive AMM config PDA
+     * @param index - Config index
+     * @returns AMM config PDA
+     */
+    static getAmmConfigPda(index: number): Promise<ProgramDerivedAddress>;
+    /**
+     * Derive position state PDA
+     * @param nftMint - Position NFT mint address
+     * @returns Position state PDA
+     */
+    static getPositionStatePda(nftMint: Address): Promise<ProgramDerivedAddress>;
+    /**
+     * Derive tick array state PDA
+     * @param poolState - Pool state address
+     * @param startTickIndex - Starting tick index of the array
+     * @returns Tick array state PDA
+     */
+    static getTickArrayStatePda(poolState: Address, startTickIndex: number): Promise<ProgramDerivedAddress>;
+    /**
+     * Derive observation state PDA
+     * @param poolState - Pool state address
+     * @returns Observation state PDA
+     */
+    static getObservationStatePda(poolState: Address): Promise<ProgramDerivedAddress>;
+    static getPoolVaultIdPda(poolAddress: Address, vaultAddress: Address): Promise<ProgramDerivedAddress>;
+    /**
+     * Derive tick array bitmap extension PDA
+     * @param poolState - Pool state address
+     * @returns Tick array bitmap extension PDA
+     */
+    static getTickArrayBitmapExtensionPda(poolState: Address): Promise<ProgramDerivedAddress>;
+    /**
+     * Calculate start tick index for tick array containing a specific tick
+     * @param tick - Target tick
+     * @param tickSpacing - Tick spacing of the pool
+     * @returns Start tick index for the tick array
+     */
+    static getTickArrayStartIndex(tick: number, tickSpacing: number): number;
+    /**
+     * Get all tick array PDAs needed for a price range
+     * @param poolState - Pool state address
+     * @param tickLower - Lower tick of range
+     * @param tickUpper - Upper tick of range
+     * @param tickSpacing - Tick spacing of the pool
+     * @param tickCurrent - Current pool tick
+     * @returns Array of tick array PDAs
+     */
+    static getTickArrayPdasForRange(poolState: Address, tickLower: number, tickUpper: number, tickSpacing: number, tickCurrent: number): Promise<ProgramDerivedAddress[]>;
+    /**
+     * Derive protocol position state PDA
+     * @param poolState - Pool state address
+     * @param tickLowerIndex - Lower tick index
+     * @param tickUpperIndex - Upper tick index
+     * @returns Protocol position state PDA
+     */
+    static getProtocolPositionStatePda(poolState: Address, tickLowerIndex: number, tickUpperIndex: number): Promise<ProgramDerivedAddress>;
+    /**
+     * Derive operation state PDA
+     * @param poolState - Pool state address
+     * @returns Operation state PDA
+     */
+    static getOperationStatePda(poolState: Address): Promise<ProgramDerivedAddress>;
+}
+export declare function getMetadataPda(mint: Address): Promise<ProgramDerivedAddress>;
+//# sourceMappingURL=pda.d.ts.map

package/lib/utils/pda.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pda.d.ts","sourceRoot":"","sources":["../../src/utils/pda.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAIL,KAAK,OAAO,EACZ,KAAK,qBAAqB,EAI3B,MAAM,aAAa,CAAC;AAUrB,qBAAa,QAAQ;IACnB;;;;;;OAMG;WACU,eAAe,CAC1B,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,OAAO,EACnB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,qBAAqB,CAAC;IAYjC;;;;OAIG;WACU,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAO3E;;;;OAIG;WACU,mBAAmB,CAC9B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,qBAAqB,CAAC;IAOjC;;;;;OAKG;WACU,oBAAoB,CAC/B,SAAS,EAAE,OAAO,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,qBAAqB,CAAC;IAWjC;;;;OAIG;WACU,sBAAsB,CACjC,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,qBAAqB,CAAC;WAOpB,iBAAiB,CAC5B,WAAW,EAAE,OAAO,EACpB,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,qBAAqB,CAAC;IAWjC;;;;OAIG;WACU,8BAA8B,CACzC,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,qBAAqB,CAAC;IAOjC;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAUxE;;;;;;;;OAQG;WACU,wBAAwB,CACnC,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAqBnC;;;;;;OAMG;WACU,2BAA2B,CACtC,SAAS,EAAE,OAAO,EAClB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,qBAAqB,CAAC;IAYjC;;;;OAIG;WACU,oBAAoB,CAC/B,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,qBAAqB,CAAC;CAMlC;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,qBAAqB,CAAC,CAShC"}

package/lib/utils/pool.d.ts

@@ -0,0 +1,180 @@
+import type { Address } from "@solana/kit";
+import type { PoolState, AmmConfig } from "../generated";
+import { type TickArray } from "./tick";
+import BN from "bn.js";
+/**
+ * Pool information with computed values
+ */
+export interface ComputedPoolInfo {
+    /** Pool state */
+    poolState: PoolState;
+    /** Current price in human readable format */
+    currentPrice: number;
+    /** Current sqrt price X64 */
+    sqrtPriceX64: BN;
+    /** Current tick */
+    tickCurrent: number;
+    /** Current liquidity */
+    liquidity: BN;
+    /** Token A vault balance */
+    vaultABalance: BN;
+    /** Token B vault balance */
+    vaultBBalance: BN;
+    /** Fee growth global for token A */
+    feeGrowthGlobalA: BN;
+    /** Fee growth global for token B */
+    feeGrowthGlobalB: BN;
+}
+/**
+ * Swap computation result
+ */
+export interface SwapResult {
+    /** Whether entire input was consumed */
+    allTrade: boolean;
+    /** Amount calculated (output for exact input, input for exact output) */
+    amountCalculated: BN;
+    /** Final sqrt price after swap */
+    sqrtPriceX64: BN;
+    /** Liquidity after swap */
+    liquidity: BN;
+    /** Fee amount charged */
+    feeAmount: BN;
+    /** Required tick arrays */
+    tickArrays: Address[];
+}
+/**
+ * Liquidity calculation result
+ */
+export interface LiquidityResult {
+    /** Liquidity amount */
+    liquidity: BN;
+    /** Token A amount */
+    amount0: BN;
+    /** Token B amount */
+    amount1: BN;
+}
+/**
+ * Pool utility functions
+ */
+export declare class PoolUtils {
+    /**
+     * Calculate pool state from raw pool data
+     * @param poolState - Raw pool state
+     * @param ammConfig - AMM configuration
+     * @returns Computed pool information
+     */
+    static computePoolInfo(poolState: PoolState, _ammConfig: AmmConfig): ComputedPoolInfo;
+    /**
+     * Calculate swap output for exact input
+     * @param poolInfo - Pool information
+     * @param inputMint - Input token mint
+     * @param amountIn - Input amount
+     * @param slippageTolerance - Slippage tolerance (0-1)
+     * @param tickArrays - Available tick arrays
+     * @returns Swap computation result
+     */
+    static computeSwapExactInput(poolInfo: ComputedPoolInfo, inputMint: Address, amountIn: BN, _slippageTolerance?: number, tickArrays?: TickArray[]): SwapResult;
+    /**
+     * Calculate swap input for exact output
+     * @param poolInfo - Pool information
+     * @param outputMint - Output token mint
+     * @param amountOut - Desired output amount
+     * @param slippageTolerance - Slippage tolerance (0-1)
+     * @param tickArrays - Available tick arrays
+     * @returns Swap computation result
+     */
+    static computeSwapExactOutput(poolInfo: ComputedPoolInfo, outputMint: Address, amountOut: BN, _slippageTolerance?: number, tickArrays?: TickArray[]): SwapResult;
+    /**
+     * Core swap computation
+     * @param poolInfo - Pool information
+     * @param amount - Swap amount
+     * @param sqrtPriceLimitX64 - Price limit
+     * @param zeroForOne - Swap direction
+     * @param exactInput - Whether exact input or output
+     * @param tickArrays - Available tick arrays
+     * @returns Swap result
+     */
+    private static computeSwap;
+    /**
+     * Compute a single swap step
+     * @param sqrtPriceCurrentX64 - Current sqrt price
+     * @param sqrtPriceTargetX64 - Target sqrt price
+     * @param liquidity - Current liquidity
+     * @param amountRemaining - Remaining amount to swap
+     * @param feeBps - Fee in basis points
+     * @param exactInput - Whether exact input
+     * @param zeroForOne - Swap direction
+     * @returns Step result
+     */
+    private static computeSwapStep;
+    /**
+     * Calculate amount0 delta between two sqrt prices
+     * @param sqrtRatioAX64 - First sqrt ratio
+     * @param sqrtRatioBX64 - Second sqrt ratio
+     * @param liquidity - Liquidity amount
+     * @param roundUp - Whether to round up
+     * @returns Amount0 delta
+     */
+    private static getAmount0Delta;
+    /**
+     * Calculate amount1 delta between two sqrt prices
+     * @param sqrtRatioAX64 - First sqrt ratio
+     * @param sqrtRatioBX64 - Second sqrt ratio
+     * @param liquidity - Liquidity amount
+     * @param roundUp - Whether to round up
+     * @returns Amount1 delta
+     */
+    private static getAmount1Delta;
+    /**
+     * Calculate optimal liquidity amounts for a position
+     * @param poolInfo - Pool information
+     * @param tickLower - Lower tick
+     * @param tickUpper - Upper tick
+     * @param amount0Desired - Desired amount of token 0
+     * @param amount1Desired - Desired amount of token 1
+     * @returns Liquidity calculation result
+     */
+    static calculateLiquidity(poolInfo: ComputedPoolInfo, tickLower: number, tickUpper: number, amount0Desired: BN, amount1Desired: BN): LiquidityResult;
+    /**
+     * Calculate liquidity from token0 amount
+     * @param sqrtRatioAX64 - Lower sqrt ratio
+     * @param sqrtRatioBX64 - Upper sqrt ratio
+     * @param amount0 - Token0 amount
+     * @returns Liquidity
+     */
+    private static getLiquidityFromAmount0;
+    /**
+     * Calculate liquidity from token1 amount
+     * @param sqrtRatioAX64 - Lower sqrt ratio
+     * @param sqrtRatioBX64 - Upper sqrt ratio
+     * @param amount1 - Token1 amount
+     * @returns Liquidity
+     */
+    private static getLiquidityFromAmount1;
+    /**
+     * Calculate token0 amount from liquidity
+     * @param sqrtRatioAX64 - Lower sqrt ratio
+     * @param sqrtRatioBX64 - Upper sqrt ratio
+     * @param liquidity - Liquidity amount
+     * @returns Token0 amount
+     */
+    static getAmount0FromLiquidity(sqrtRatioAX64: BN, sqrtRatioBX64: BN, liquidity: BN): BN;
+    /**
+     * Calculate token1 amount from liquidity
+     * @param sqrtRatioAX64 - Lower sqrt ratio
+     * @param sqrtRatioBX64 - Upper sqrt ratio
+     * @param liquidity - Liquidity amount
+     * @returns Token1 amount
+     */
+    static getAmount1FromLiquidity(sqrtRatioAX64: BN, sqrtRatioBX64: BN, liquidity: BN): BN;
+    private static maxTickInTickArrayBitmap;
+    private static tickRange;
+    /**
+     * Calculate if tick indexes overflow default tick array bitmap.
+     * @param tickSpacing - tick spacing
+     * @param tickIndexs - upper and lower bound start tick indexes
+     * @returns true if it overflows, false otherwise
+     */
+    static isOverflowDefaultTickArrayBitmap(tickSpacing: number, tickIndexs: Array<number>): boolean;
+}
+//# sourceMappingURL=pool.d.ts.map

package/lib/utils/pool.d.ts.map

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

package/lib/utils/tick.d.ts

@@ -0,0 +1,172 @@
+import { ClusterUrl, type Address } from "@solana/kit";
+import Decimal from "decimal.js";
+import BN from "bn.js";
+import { TickArrayBitmapExtension } from "../generated";
+export declare const TICK_ARRAY_SIZE = 60;
+export declare const TICK_ARRAY_BITMAP_SIZE = 512;
+/**
+ * Individual tick state
+ */
+export interface Tick {
+    /** The tick index */
+    tick: number;
+    /** Amount of net liquidity added or removed when crossing this tick */
+    liquidityNet: bigint;
+    /** Total liquidity referencing this tick */
+    liquidityGross: bigint;
+    /** Fee growth on the other side of this tick from the current tick */
+    feeGrowthOutside0X64: bigint;
+    feeGrowthOutside1X64: bigint;
+    /** Reward growth on the other side of this tick from the current tick */
+    rewardGrowthsOutside: [bigint, bigint, bigint];
+}
+/**
+ * Tick array containing multiple ticks
+ */
+export interface TickArray {
+    /** Pool ID this tick array belongs to */
+    poolId: Address;
+    /** Starting tick index of this array */
+    startTickIndex: number;
+    /** Array of tick states */
+    ticks: Tick[];
+    /** Number of initialized ticks in this array */
+    initializedTickCount: number;
+}
+export interface ReturnTypeGetPriceAndTick {
+    tick: number;
+    price: Decimal;
+}
+export interface ReturnTypeGetTickPrice {
+    tick: number;
+    price: Decimal;
+    tickSqrtPriceX64: BN;
+}
+/**
+ * Tick utility functions
+ */
+export declare class TickUtils {
+    /**
+     * Validate that a tick is within valid range
+     * @param tick - Tick to validate
+     * @throws ClmmError if tick is out of range
+     */
+    static validateTick(tick: number): void;
+    /**
+     * Validate that tick range is valid
+     * @param tickLower - Lower tick
+     * @param tickUpper - Upper tick
+     * @param tickSpacing - Tick spacing for the pool
+     * @throws ClmmError if range is invalid
+     */
+    static validateTickRange(tickLower: number, tickUpper: number, tickSpacing: number): void;
+    /**
+     * Get the start index of the tick array containing a specific tick
+     * @param tick - Target tick
+     * @param tickSpacing - Tick spacing of the pool
+     * @returns Start tick index for the tick array
+     */
+    static getTickArrayStartIndex(tick: number, tickSpacing: number): number;
+    /**
+     * Check if a tick is initialized (has liquidity)
+     * @param tick - Tick to check
+     * @returns Whether tick is initialized
+     */
+    static isTickInitialized(tick: Tick): boolean;
+    /**
+     * Get all tick array start indices needed for a price range
+     * @param tickLower - Lower tick of range
+     * @param tickUpper - Upper tick of range
+     * @param tickSpacing - Tick spacing of the pool
+     * @param tickCurrent - Current pool tick
+     * @returns Array of start indices
+     */
+    static getTickArrayStartIndices(tickLower: number, tickUpper: number, tickSpacing: number, tickCurrent: number): number[];
+    /**
+     * Find next initialized tick in a direction
+     * @param ticks - Array of tick states
+     * @param startTick - Starting tick index
+     * @param tickSpacing - Tick spacing
+     * @param zeroForOne - Direction (true = decreasing ticks)
+     * @returns Next initialized tick and whether found
+     */
+    static findNextInitializedTick(ticks: Tick[], startTick: number, tickSpacing: number, zeroForOne: boolean): {
+        tick: number;
+        found: boolean;
+    };
+    /**
+     * Calculate tick index from price
+     * @param price - Price (token1/token0)
+     * @param decimalsA - Token A decimals
+     * @param decimalsB - Token B decimals
+     * @returns Tick index
+     */
+    static priceToTick(price: number, decimalsA: number, decimalsB: number): number;
+    /**
+     * Calculate price from tick index
+     * @param tick - Tick index
+     * @param decimalsA - Token A decimals
+     * @param decimalsB - Token B decimals
+     * @returns Price (token1/token0)
+     */
+    static tickToPrice(tick: number, decimalsA: number, decimalsB: number): number;
+    /**
+     * Get the tick index at a given price with proper spacing alignment
+     * @param price - Target price
+     * @param decimalsA - Token A decimals
+     * @param decimalsB - Token B decimals
+     * @param tickSpacing - Tick spacing
+     * @param roundUp - Whether to round up or down
+     * @returns Aligned tick index
+     */
+    static priceToAlignedTick(price: number, decimalsA: number, decimalsB: number, tickSpacing: number, roundUp?: boolean): number;
+    /**
+     * Align tick to spacing requirements
+     * @param tick - Raw tick
+     * @param tickSpacing - Required spacing
+     * @param roundUp - Whether to round up or down
+     * @returns Aligned tick
+     */
+    static alignTickToSpacing(tick: number, tickSpacing: number, roundUp?: boolean): number;
+    static checkIsOutOfBoundary(tick: number): boolean;
+    /**
+     * Check if tick array boundary is valid
+     * @param startIndex - Start index of tick array
+     * @param tickSpacing - Tick spacing
+     * @returns Whether boundary is valid
+     */
+    static isValidTickArrayBoundary(startIndex: number, tickSpacing: number): boolean;
+    static getTickArrayStartIndexByTick(tickIndex: number, tickSpacing: number): number;
+    static mergeTickArrayBitmap(bns: BN[]): BN;
+    static searchLowBitFromStart(tickArrayBitmap: BN[], exTickArrayBitmap: TickArrayBitmapExtension, currentTickArrayBitStartIndex: number, expectedCount: number, tickSpacing: number): number[];
+    static searchHightBitFromStart(tickArrayBitmap: BN[], exTickArrayBitmap: TickArrayBitmapExtension, currentTickArrayBitStartIndex: number, expectedCount: number, tickSpacing: number): number[];
+    static getInitializedTickArrayInRange(tickArrayBitmap: BN[], exTickArrayBitmap: TickArrayBitmapExtension, tickSpacing: number, tickArrayStartIndex: number, expectedCount: number): number[];
+    static getTickArrayBitIndex(tickIndex: number, tickSpacing: number): number;
+    static getTickPrice({ mintADecimals, mintBDecimals, tick, baseIn, }: {
+        mintADecimals: number;
+        mintBDecimals: number;
+        tick: number;
+        baseIn: boolean;
+    }): ReturnTypeGetTickPrice;
+    static getPriceAndTick({ tickSpacing, mintADecimals, mintBDecimals, price, baseIn, }: {
+        tickSpacing: number;
+        mintADecimals: number;
+        mintBDecimals: number;
+        price: Decimal;
+        baseIn: boolean;
+    }): ReturnTypeGetPriceAndTick;
+}
+/**
+ * NOTE: Not Implemented
+ *
+ * Fetch tick arrays for a pool within a price range
+ * @param cluster - RPC cluster | endpoint
+ * @param poolAddress - Pool address
+ * @param tickLower - Lower tick of range
+ * @param tickUpper - Upper tick of range
+ * @param tickSpacing - Tick spacing
+ * @param tickCurrent - Current tick
+ * @returns Promise of tick arrays
+ */
+export declare function fetchTickArraysForRange(cluster: ClusterUrl, poolAddress: Address, tickLower: number, tickUpper: number, tickSpacing: number, tickCurrent: number): Promise<TickArray[]>;
+//# sourceMappingURL=tick.d.ts.map

package/lib/utils/tick.d.ts.map

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

package/lib/utils/tickQuery.d.ts

@@ -0,0 +1,13 @@
+import BN from "bn.js";
+import { TickArrayBitmapExtension, TickArrayState } from "../generated";
+import { Account, Address, Rpc, SolanaRpcApiDevnet, SolanaRpcApiMainnet, SolanaRpcApiTestnet } from "@solana/kit";
+export declare const FETCH_TICKARRAY_COUNT = 15;
+export declare class TickQuery {
+    static getTickArrays(rpc: Rpc<SolanaRpcApiMainnet | SolanaRpcApiDevnet | SolanaRpcApiTestnet>, poolId: Address, tickCurrent: number, tickSpacing: number, tickArrayBitmapArray: BN[], exTickArrayBitmap: TickArrayBitmapExtension): Promise<{
+        [key: string]: Account<TickArrayState>;
+    }>;
+    static getArrayStartIndex(tickIndex: number, tickSpacing: number): number;
+    static checkIsValidStartIndex(tickIndex: number, tickSpacing: number): boolean;
+    static tickCount(tickSpacing: number): number;
+}
+//# sourceMappingURL=tickQuery.d.ts.map

package/lib/utils/tickQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickQuery.d.ts","sourceRoot":"","sources":["../../src/utils/tickQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,OAAO,CAAC;AAGvB,OAAO,EAEL,wBAAwB,EACxB,cAAc,EACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,OAAO,EACP,OAAO,EACP,GAAG,EACH,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,qBAAa,SAAS;WACA,aAAa,CAC/B,GAAG,EAAE,GAAG,CAAC,mBAAmB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC,EACxE,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,oBAAoB,EAAE,EAAE,EAAE,EAC1B,iBAAiB,EAAE,wBAAwB,GAC1C,OAAO,CAAC;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;KAAE,CAAC;WAuPxC,kBAAkB,CAC9B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,MAAM;WAOK,sBAAsB,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO;WAeI,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;CAGrD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stabbleorg/mclmm-sdk",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "SDK for Stabble's margin-enabled concentrated liquidity market maker",
   "main": "lib/index.js",
   "module": "lib/index.mjs",
@@ -30,7 +30,8 @@
     "build": "yarn build:js && yarn build:types",
     "generate-clients": "ts-node ./scripts/generate-clients.ts",
     "ts": "tsc --noEmit",
-    "prepare:canary": "yarn build && npm version --prerelease --preid=canary"
+    "prepare:canary": "yarn build && npm version --prerelease --preid=canary",
+    "prepublishOnly": "echo \"Building before publish!\" && yarn build"
   },
   "dependencies": {
     "@codama/nodes-from-anchor": "^1.2.9",