@stabbleorg/mclmm-sdk 0.1.6 → 0.1.7

package/lib/pool-manager.d.ts

@@ -0,0 +1,84 @@
+import { type Address, type TransactionSigner, Account, Rpc, SolanaRpcApiMainnet, SolanaRpcApiDevnet, SolanaRpcApiTestnet } from "@solana/kit";
+import { PoolState } from "./generated";
+import type { ClmmSdkConfig, MakeInstructionResult, PoolInfo } from "./types";
+import BN from "bn.js";
+import Decimal from "decimal.js";
+export declare class PoolManager {
+    private readonly config;
+    constructor(config: ClmmSdkConfig);
+    /**
+     * Make create pool instructions
+     * @param params - Pool creation parameters
+     * @returns Instruction result following Raydium pattern
+     */
+    makeCreatePoolInstructions(params: {
+        owner: TransactionSigner;
+        tokenMintA: Address;
+        tokenMintB: Address;
+        ammConfigId: Address;
+        initialPrice: Decimal;
+        mintADecimals: number;
+        mintBDecimals: number;
+    }): Promise<MakeInstructionResult<{
+        poolId: Address;
+        observationId: Address;
+        tokenVault0: Address;
+        tokenVault1: Address;
+    }>>;
+    /**
+     * Make create AMM config instructions
+     * @param params - Config creation parameters
+     * @returns Instruction result following Raydium pattern
+     */
+    makeCreateAmmConfigInstructions(params: {
+        programId: Address;
+        owner: TransactionSigner;
+        index: number;
+        tickSpacing: number;
+        tradeFeeRate: number;
+        protocolFeeRate: number;
+        fundFeeRate: number;
+    }): Promise<MakeInstructionResult<{
+        ammConfigId: Address;
+    }>>;
+    /**
+     * Fetch pool information by address
+     * @param poolAddress - Pool state address
+     * @returns Pool information
+     */
+    getPool(poolAddress: Address): Promise<PoolInfo | null>;
+    /**
+     * Find pool by token pair and config index
+     * @param tokenA - First token mint
+     * @param tokenB - Second token mint
+     * @param ammConfigIndex - AMM config index (default: 0)
+     * @returns Pool information if found
+     */
+    getPoolByTokenPairAndConfig(tokenA: Address, tokenB: Address, ammConfigIndex?: number): Promise<PoolInfo | null>;
+    getAllPools(rpc: Rpc<SolanaRpcApiMainnet | SolanaRpcApiDevnet | SolanaRpcApiTestnet>): Promise<Account<PoolState>[]>;
+    /**
+     * Calculate pool price from sqrt price
+     * @param sqrtPriceX64 - Square root price in Q64.64 format
+     * @param decimalsA - Token A decimals
+     * @param decimalsB - Token B decimals
+     * @returns Human-readable price
+     */
+    calculatePoolPrice(sqrtPriceX64: BN, decimalsA: number, decimalsB: number): Decimal;
+    /**
+     * Enrich pool state with calculated fields
+     */
+    private enrichPoolInfo;
+    /**
+     * Validate fee tier
+     * @param fee - Fee tier to validate
+     * @returns True if valid
+     */
+    isValidFeeTier(fee: number): boolean;
+    /**
+     * Get tick spacing for fee tier
+     * @param fee - Fee tier
+     * @returns Tick spacing
+     */
+    getTickSpacing(fee: number): number;
+}
+//# sourceMappingURL=pool-manager.d.ts.map

package/lib/pool-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-manager.d.ts","sourceRoot":"","sources":["../src/pool-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,iBAAiB,EAEtB,OAAO,EACP,GAAG,EAEH,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAML,SAAS,EACV,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,QAAQ,EAET,MAAM,SAAS,CAAC;AAajB,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,OAAO,MAAM,YAAY,CAAC;AAEjC,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD;;;;OAIG;IACG,0BAA0B,CAAC,MAAM,EAAE;QACvC,KAAK,EAAE,iBAAiB,CAAC;QACzB,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;QACrB,YAAY,EAAE,OAAO,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CACT,qBAAqB,CAAC;QACpB,MAAM,EAAE,OAAO,CAAC;QAChB,aAAa,EAAE,OAAO,CAAC;QACvB,WAAW,EAAE,OAAO,CAAC;QACrB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC,CACH;IA6ED;;;;OAIG;IACG,+BAA+B,CAAC,MAAM,EAAE;QAC5C,SAAS,EAAE,OAAO,CAAC;QACnB,KAAK,EAAE,iBAAiB,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CACT,qBAAqB,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC,CACH;IAmCD;;;;OAIG;IACG,OAAO,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAqB7D;;;;;;OAMG;IACG,2BAA2B,CAC/B,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,OAAO,EACf,cAAc,GAAE,MAAU,GACzB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAWrB,WAAW,CACf,GAAG,EAAE,GAAG,CAAC,mBAAmB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC,GACvE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IAyBhC;;;;;;OAMG;IACH,kBAAkB,CAChB,YAAY,EAAE,EAAE,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO;IAQV;;OAEG;IACH,OAAO,CAAC,cAAc;IA+BtB;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAUpC"}

package/lib/position-manager.d.ts

@@ -0,0 +1,127 @@
+import { Account, type Address, type TransactionSigner } from "@solana/kit";
+import { PersonalPositionState, PoolState } from "./generated";
+import type { ClmmSdkConfig, MakeInstructionResult, PositionInfo } from "./types";
+export declare class PositionManager {
+    private readonly config;
+    constructor(config: ClmmSdkConfig);
+    /**
+     * Make open position from liquidity instructions
+     * Use this when you know the exact liquidity amount you want to provide
+     * @param params - Position opening parameters
+     * @returns Instruction result following Raydium pattern
+     */
+    makeOpenPositionFromLiquidityInstructions(params: {
+        poolAccount: Account<PoolState, Address>;
+        ownerInfo: {
+            feePayer: TransactionSigner;
+            wallet: Address;
+            tokenAccountA: Address;
+            tokenAccountB: Address;
+            useSOLBalance?: boolean;
+        };
+        tickLower: number;
+        tickUpper: number;
+        liquidity: bigint;
+        amountMaxA: bigint;
+        amountMaxB: bigint;
+        withMetadata?: boolean;
+        getEphemeralSigners?: () => TransactionSigner[];
+    }): Promise<MakeInstructionResult<{
+        positionNftMint: Address;
+        positionNftAccount: Address;
+        metadataAccount: Address;
+        personalPosition: Address;
+    }>>;
+    /**
+     * Make open position from base token amount instructions
+     * Use this when you know how much of one specific token you want to deposit
+     * @param params - Position opening parameters
+     * @returns Instruction result following Raydium pattern
+     */
+    makeOpenPositionFromBaseInstructions(params: {
+        poolAccount: Account<PoolState, Address>;
+        ownerInfo: {
+            wallet: TransactionSigner;
+            tokenAccountA: Address;
+            tokenAccountB: Address;
+            useSOLBalance?: boolean;
+        };
+        tickLower: number;
+        tickUpper: number;
+        base: "MintA" | "MintB";
+        baseAmount: bigint;
+        otherAmountMax: bigint;
+        withMetadata?: boolean;
+        getEphemeralSigners?: () => TransactionSigner[];
+    }): Promise<MakeInstructionResult<{
+        positionNftMint: Address;
+        positionNftAccount: Address;
+        metadataAccount: Address;
+        personalPosition: Address;
+    }>>;
+    /**
+     * Make increase liquidity V2 instructions
+     * @param params - Increase liquidity parameters
+     * @returns Instruction result following Raydium pattern
+     */
+    makeIncreaseLiquidityV2Instructions(params: {
+        ownerPosition: PersonalPositionState;
+        poolState: Account<PoolState, Address>;
+        ownerInfo: {
+            wallet: TransactionSigner;
+            tokenAccountA: Address;
+            tokenAccountB: Address;
+        };
+        liquidity: bigint;
+        amountMaxA: bigint;
+        amountMaxB: bigint;
+    }): Promise<MakeInstructionResult<{}>>;
+    /**
+     * Make decrease liquidity V2 instructions
+     * @param params - Decrease liquidity parameters
+     * @returns Instruction result following Raydium pattern
+     */
+    makeDecreaseLiquidityV2Instructions(params: {
+        ownerPosition: PersonalPositionState;
+        poolState: Account<PoolState, Address>;
+        ownerInfo: {
+            wallet: TransactionSigner;
+            tokenAccountA: Address;
+            tokenAccountB: Address;
+        };
+        liquidity: bigint;
+        amountMinA: bigint;
+        amountMinB: bigint;
+    }): Promise<MakeInstructionResult<{}>>;
+    /**
+     * Make close position instructions
+     * @param params - Close position parameters
+     * @returns Instruction result following established pattern
+     */
+    makeClosePositionInstructions(params: {
+        ownerPosition: PersonalPositionState;
+        ownerInfo: {
+            wallet: TransactionSigner;
+        };
+    }): Promise<MakeInstructionResult<{}>>;
+    /**
+     * Get position information by NFT mint
+     * @param positionMint - Position NFT mint
+     * @returns Position information
+     */
+    getPosition(positionMint: Address): Promise<PersonalPositionState | null>;
+    /**
+     * Enrich position state with computed fields from pool data
+     * @param position - Raw position state from blockchain
+     * @param pool - Pool state from blockchain
+     * @returns Enriched position info with calculated amounts and prices
+     */
+    enrichPositionInfo(position: PersonalPositionState, pool: PoolState): PositionInfo;
+    /**
+     * Get all positions for a wallet with enriched information
+     * @param wallet - Wallet address
+     * @returns Array of enriched positions owned by the wallet
+     */
+    getPositionsForWallet(wallet: Address): Promise<PositionInfo[]>;
+}
+//# sourceMappingURL=position-manager.d.ts.map

package/lib/position-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-manager.d.ts","sourceRoot":"","sources":["../src/position-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,KAAK,OAAO,EAAyB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAElG,OAAO,EAOL,qBAAqB,EACrB,SAAS,EACV,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAC,aAAa,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAOjF,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD;;;;;OAKG;IACG,yCAAyC,CAAC,MAAM,EAAE;QACtD,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzC,SAAS,EAAE;YACT,QAAQ,EAAE,iBAAiB,CAAC;YAC5B,MAAM,EAAE,OAAO,CAAC;YAChB,aAAa,EAAE,OAAO,CAAC;YACvB,aAAa,EAAE,OAAO,CAAC;YACvB,aAAa,CAAC,EAAE,OAAO,CAAC;SACzB,CAAC;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,mBAAmB,CAAC,EAAE,MAAM,iBAAiB,EAAE,CAAC;KACjD,GAAG,OAAO,CACT,qBAAqB,CAAC;QACpB,eAAe,EAAE,OAAO,CAAC;QACzB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,eAAe,EAAE,OAAO,CAAC;QACzB,gBAAgB,EAAE,OAAO,CAAC;KAC3B,CAAC,CACH;IA+FD;;;;;OAKG;IACG,oCAAoC,CAAC,MAAM,EAAE;QACjD,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzC,SAAS,EAAE;YACT,MAAM,EAAE,iBAAiB,CAAC;YAC1B,aAAa,EAAE,OAAO,CAAC;YACvB,aAAa,EAAE,OAAO,CAAC;YACvB,aAAa,CAAC,EAAE,OAAO,CAAC;SACzB,CAAC;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,mBAAmB,CAAC,EAAE,MAAM,iBAAiB,EAAE,CAAC;KACjD,GAAG,OAAO,CACT,qBAAqB,CAAC;QACpB,eAAe,EAAE,OAAO,CAAC;QACzB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,eAAe,EAAE,OAAO,CAAC;QACzB,gBAAgB,EAAE,OAAO,CAAC;KAC3B,CAAC,CACH;IAgHD;;;;OAIG;IACG,mCAAmC,CAAC,MAAM,EAAE;QAChD,aAAa,EAAE,qBAAqB,CAAC;QACrC,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACvC,SAAS,EAAE;YACT,MAAM,EAAE,iBAAiB,CAAC;YAC1B,aAAa,EAAE,OAAO,CAAC;YACvB,aAAa,EAAE,OAAO,CAAC;SACxB,CAAC;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;IA+EtC;;;;OAIG;IACG,mCAAmC,CAAC,MAAM,EAAE;QAChD,aAAa,EAAE,qBAAqB,CAAC;QACrC,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACvC,SAAS,EAAE;YACT,MAAM,EAAE,iBAAiB,CAAC;YAC1B,aAAa,EAAE,OAAO,CAAC;YACvB,aAAa,EAAE,OAAO,CAAC;SACxB,CAAC;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;IA8EtC;;;;OAIG;IACG,6BAA6B,CAAC,MAAM,EAAE;QAC1C,aAAa,EAAE,qBAAqB,CAAC;QACrC,SAAS,EAAE;YACT,MAAM,EAAE,iBAAiB,CAAC;SAC3B,CAAC;KACH,GAAG,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;IA6BtC;;;;OAIG;IACG,WAAW,CACf,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAuBxC;;;;;OAKG;IACH,kBAAkB,CAChB,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,EAAE,SAAS,GACd,YAAY;IA6Ff;;;;OAIG;IACG,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CA0EtE"}

package/lib/rewards.d.ts

@@ -0,0 +1,7 @@
+/**
+ * NOTE: Work in progress
+ *
+ * Rewards and Fee Collection Module
+ * Handles reward distribution, fee collection, and reward management
+ */
+//# sourceMappingURL=rewards.d.ts.map

package/lib/rewards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewards.d.ts","sourceRoot":"","sources":["../src/rewards.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/lib/swap.d.ts

@@ -0,0 +1,6 @@
+/**
+ *
+ * NOTE: Work in progress
+ *
+*/
+//# sourceMappingURL=swap.d.ts.map

package/lib/swap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap.d.ts","sourceRoot":"","sources":["../src/swap.ts"],"names":[],"mappings":"AAAA;;;;EAIE"}

package/lib/types.d.ts

@@ -0,0 +1,307 @@
+import type { Address, Rpc, Instruction, TransactionSigner, SolanaRpcApiDevnet, SolanaRpcApiMainnet, SolanaRpcApiTestnet } from "@solana/kit";
+import type { PoolState, PersonalPositionState } from "./generated";
+import BN from "bn.js";
+import { ClmmApiConfig } from "./api";
+export interface ClmmSdkConfig {
+    /** RPC client for Solana network operations */
+    rpc: Rpc<SolanaRpcApiMainnet | SolanaRpcApiDevnet | SolanaRpcApiTestnet>;
+    /** API client config */
+    apiConfig?: ClmmApiConfig;
+    /** Optional program address override */
+    programAddress?: Address;
+    /** Default commitment level for transactions */
+    commitment?: "processed" | "confirmed" | "finalized";
+}
+/**
+ * Return type for make instructions following Raydium's pattern
+ */
+export interface MakeInstructionResult<T = {}> {
+    /** Array of instructions */
+    instructions: Instruction[];
+    /** Required signers */
+    signers: TransactionSigner[];
+    /** Instruction types for categorization */
+    instructionTypes: string[];
+    /** Additional addresses and information */
+    address: T;
+    /** Lookup table addresses (empty for now) */
+    lookupTableAddress: string[];
+}
+export interface PoolInfo extends PoolState {
+    /** Calculated current price in token units */
+    currentPrice: number;
+    /** Token A symbol/metadata */
+    tokenA: TokenInfo;
+    /** Token B symbol/metadata */
+    tokenB: TokenInfo;
+    /** Total value locked in USD */
+    tvl?: number;
+    /** 24h volume in USD */
+    volume24h?: number;
+    /** Current APY for liquidity providers */
+    apy?: number;
+}
+/**
+ * Position Data API response
+ */
+export type PoolApiData = {
+    tokenVault1: string;
+    tokenVault0: string;
+    ammConfig: string;
+    sqrtPriceX64: string;
+    tickSpacing: number;
+    tokenMint0: string;
+    tokenMint1: string;
+    owner: string;
+    tick: number;
+    address: string;
+    tvl: string;
+};
+export interface TokenInfo {
+    /** Token mint address */
+    mint: Address;
+    /** Token symbol */
+    symbol: string;
+    /** Token name */
+    name?: string;
+    /** Decimal places */
+    decimals: number;
+    /** Logo URI */
+    logoUri?: string;
+}
+export interface ClmmConfig {
+    tradeFeeRate: number;
+    index: number;
+    fundFeeRate: number;
+    tickSpacing: number;
+    fundOwner: string;
+    owner: string;
+    address: string;
+    protocolFeeRate: number;
+}
+export interface PositionInfo extends PersonalPositionState {
+    /** Token mint addresses from pool */
+    tokenMint0: Address;
+    tokenMint1: Address;
+    /** Computed token amounts based on liquidity and price range */
+    amount0: bigint;
+    amount1: bigint;
+    /** Price range bounds in human-readable format */
+    priceRange: {
+        lower: number;
+        upper: number;
+    };
+    /** Whether position is currently in range */
+    inRange: boolean;
+    /** Position age in seconds (from creation to now) */
+    ageSeconds: number;
+    /** Position value in USD (optional, requires price feeds) */
+    valueUsd?: number;
+    /** Uncollected fees mapped from PersonalPositionState for convenience */
+    unclaimedFees: {
+        token0: BN;
+        token1: BN;
+    };
+    /** Uncollected rewards (optional, if rewards are active) */
+    unclaimedRewards?: Array<{
+        mint: Address;
+        amount: BN;
+        symbol?: string;
+    }>;
+}
+export interface SwapQuote {
+    /** Input token amount */
+    amountIn: BN;
+    /** Expected output amount (before slippage) */
+    amountOut: BN;
+    /** Minimum output after slippage tolerance */
+    minAmountOut: BN;
+    /** Price impact percentage */
+    priceImpact: number;
+    /** Route through multiple pools if applicable */
+    route: SwapRoute[];
+    /** Estimated transaction fee */
+    fee: BN;
+}
+export interface SwapRoute {
+    /** Pool address */
+    poolAddress: Address;
+    /** Input token */
+    tokenIn: Address;
+    /** Output token */
+    tokenOut: Address;
+    /** Fee tier */
+    fee: number;
+}
+export interface SwapParams {
+    /** Input token mint */
+    tokenIn: Address;
+    /** Output token mint */
+    tokenOut: Address;
+    /** Input amount */
+    amountIn: BN;
+    /** Slippage tolerance (0-1, e.g., 0.01 for 1%) */
+    slippageTolerance: number;
+    /** User's wallet address */
+    wallet: Address;
+    /** Optional deadline for transaction */
+    deadline?: BN;
+}
+export interface AddLiquidityParams {
+    /** Pool address */
+    poolAddress: Address;
+    /** Lower tick of price range */
+    tickLower: number;
+    /** Upper tick of price range */
+    tickUpper: number;
+    /** Desired amount of token A */
+    amountA: BN;
+    /** Desired amount of token B */
+    amountB: BN;
+    /** Minimum amount of token A (slippage protection) */
+    minAmountA: BN;
+    /** Minimum amount of token B (slippage protection) */
+    minAmountB: BN;
+    /** Deadline for transaction */
+    nft2022?: boolean;
+}
+export interface RemoveLiquidityParams {
+    /** Position NFT mint address */
+    positionMint: Address;
+    /** Percentage of liquidity to remove (0-1) */
+    liquidity: BN;
+    /** Minimum amount of token A to receive */
+    minAmountA: BN;
+    /** Minimum amount of token B to receive */
+    minAmountB: BN;
+    /** User's wallet address */
+    wallet: Address;
+    /** Deadline for transaction */
+    deadline?: BN;
+}
+export interface CreatePoolParams {
+    /** Token A mint address */
+    tokenA: Address;
+    /** Token B mint address */
+    tokenB: Address;
+    /** Fee tier (e.g., 3000 for 0.3%) */
+    fee: number;
+    /** Initial price (sqrt price X64) */
+    initialPrice: BN;
+    /** AMM config to use */
+    ammConfig?: Address;
+    /** Pool creator wallet */
+    creator: Address;
+}
+export interface PriceRange {
+    /** Lower price bound */
+    lower: number;
+    /** Upper price bound */
+    upper: number;
+}
+export interface TickRange {
+    /** Lower tick */
+    lower: number;
+    /** Upper tick */
+    upper: number;
+}
+export declare enum ClmmErrorCode {
+    INSUFFICIENT_LIQUIDITY = "INSUFFICIENT_LIQUIDITY",
+    LIQUIDITY_INSUFFICIENT = "LIQUIDITY_INSUFFICIENT",
+    LIQUIDITY_SUB_DELTA_L_MUST_BE_SMALLER = "LIQUIDITY_SUB_DELTA_L_MUST_BE_SMALLER",
+    LIQUIDITY_ADD_DELTA_L_MUST_BE_GREATER = "LIQUIDITY_ADD_DELTA_L_MUST_BE_GREATER",
+    INVALID_LIQUIDITY_WHEN_UPDATING_POSITION = "INVALID_LIQUIDITY_WHEN_UPDATING_POSITION",
+    BOTH_TOKEN_AMOUNTS_MUST_NOT_BE_ZERO = "BOTH_TOKEN_AMOUNTS_MUST_NOT_BE_ZERO",
+    PRICE_SLIPPAGE = "PRICE_SLIPPAGE",
+    PRICE_SLIPPAGE_CHECK_FAILED = "PRICE_SLIPPAGE_CHECK_FAILED",
+    TOO_LITTLE_OUTPUT_RECEIVED = "TOO_LITTLE_OUTPUT_RECEIVED",
+    TOO_MUCH_INPUT_PAID = "TOO_MUCH_INPUT_PAID",
+    SQRT_PRICE_LIMIT_OVERFLOW = "SQRT_PRICE_LIMIT_OVERFLOW",
+    SQRT_PRICE_X64_OUT_OF_RANGE = "SQRT_PRICE_X64_OUT_OF_RANGE",
+    INVALID_TICK_RANGE = "INVALID_TICK_RANGE",
+    TICK_OUT_OF_RANGE = "TICK_OUT_OF_RANGE",
+    LOWER_TICK_MUST_BE_BELOW_UPPER_TICK = "LOWER_TICK_MUST_BE_BELOW_UPPER_TICK",
+    TICK_MUST_BE_GTE_MINIMUM_TICK = "TICK_MUST_BE_GTE_MINIMUM_TICK",
+    TICK_MUST_BE_LTE_MAXIMUM_TICK = "TICK_MUST_BE_LTE_MAXIMUM_TICK",
+    TICK_MUST_BE_DIVISIBLE_BY_TICK_SPACING = "TICK_MUST_BE_DIVISIBLE_BY_TICK_SPACING",
+    INVALID_TICK_ARRAY_ACCOUNT = "INVALID_TICK_ARRAY_ACCOUNT",
+    INVALID_TICK_ARRAY_BOUNDARY = "INVALID_TICK_ARRAY_BOUNDARY",
+    NOT_ENOUGH_TICK_ARRAY_ACCOUNTS = "NOT_ENOUGH_TICK_ARRAY_ACCOUNTS",
+    INVALID_FIRST_TICK_ARRAY_ACCOUNT = "INVALID_FIRST_TICK_ARRAY_ACCOUNT",
+    POOL_NOT_FOUND = "POOL_NOT_FOUND",
+    POSITION_NOT_FOUND = "POSITION_NOT_FOUND",
+    INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+    SWAP_AMOUNT_CANNOT_BE_ZERO = "SWAP_AMOUNT_CANNOT_BE_ZERO",
+    SWAP_INPUT_OR_OUTPUT_AMOUNT_TOO_SMALL = "SWAP_INPUT_OR_OUTPUT_AMOUNT_TOO_SMALL",
+    INPUT_POOL_VAULT_IS_INVALID = "INPUT_POOL_VAULT_IS_INVALID",
+    TRANSACTION_FAILED = "TRANSACTION_FAILED",
+    TRANSACTION_TOO_OLD = "TRANSACTION_TOO_OLD",
+    ZERO_MINT_AMOUNT = "ZERO_MINT_AMOUNT",
+    MINTING_AMOUNT_SHOULD_BE_GREATER_THAN_ZERO = "MINTING_AMOUNT_SHOULD_BE_GREATER_THAN_ZERO",
+    INVALID_REWARD_INDEX = "INVALID_REWARD_INDEX",
+    REWARD_TOKEN_LIMIT_REACHED = "REWARD_TOKEN_LIMIT_REACHED",
+    REWARD_TOKEN_ALREADY_IN_USE = "REWARD_TOKEN_ALREADY_IN_USE",
+    REWARD_TOKENS_MUST_CONTAIN_ONE_OF_POOL_VAULT_MINTS = "REWARD_TOKENS_MUST_CONTAIN_ONE_OF_POOL_VAULT_MINTS",
+    INVALID_REWARD_INIT_PARAM = "INVALID_REWARD_INIT_PARAM",
+    INVALID_COLLECT_REWARD_DESIRED_AMOUNT = "INVALID_COLLECT_REWARD_DESIRED_AMOUNT",
+    INVALID_COLLECT_REWARD_INPUT_ACCOUNT_NUMBER = "INVALID_COLLECT_REWARD_INPUT_ACCOUNT_NUMBER",
+    INVALID_REWARD_PERIOD = "INVALID_REWARD_PERIOD",
+    UNINITIALIZED_REWARD_INFO = "UNINITIALIZED_REWARD_INFO",
+    CLOSE_POSITION_ERR = "CLOSE_POSITION_ERR",
+    MUST_COLLECT_FEES_AND_REWARDS_BEFORE_CLOSING = "MUST_COLLECT_FEES_AND_REWARDS_BEFORE_CLOSING",
+    NOT_APPROVED = "NOT_APPROVED",
+    INVALID_UPDATE_CONFIG_FLAG = "INVALID_UPDATE_CONFIG_FLAG",
+    ACCOUNT_LACK = "ACCOUNT_LACK",
+    MAX_TOKEN_OVERFLOW = "MAX_TOKEN_OVERFLOW",
+    CALCULATE_OVERFLOW = "CALCULATE_OVERFLOW",
+    TOKEN2022_MINT_EXTENSION_NOT_SUPPORTED = "TOKEN2022_MINT_EXTENSION_NOT_SUPPORTED",
+    MISSING_TICK_ARRAY_BITMAP_EXTENSION_ACCOUNT = "MISSING_TICK_ARRAY_BITMAP_EXTENSION_ACCOUNT",
+    TRANSFER_FEE_CALCULATION_MISMATCH = "TRANSFER_FEE_CALCULATION_MISMATCH"
+}
+export declare class ClmmError extends Error {
+    code: ClmmErrorCode;
+    details?: unknown | undefined;
+    constructor(code: ClmmErrorCode, message: string, details?: unknown | undefined);
+}
+export interface SwapEvent {
+    /** Pool address */
+    pool: Address;
+    /** User who performed swap */
+    user: Address;
+    /** Input token and amount */
+    tokenIn: {
+        mint: Address;
+        amount: BN;
+    };
+    /** Output token and amount */
+    tokenOut: {
+        mint: Address;
+        amount: BN;
+    };
+    /** Transaction signature */
+    signature: string;
+    /** Block timestamp */
+    timestamp: number;
+}
+export interface LiquidityEvent {
+    /** Pool address */
+    pool: Address;
+    /** User who added/removed liquidity */
+    user: Address;
+    /** Position mint (if applicable) */
+    position?: Address;
+    /** Event type */
+    type: "add" | "remove";
+    /** Token amounts */
+    amounts: {
+        token0: BN;
+        token1: BN;
+    };
+    /** Transaction signature */
+    signature: string;
+    /** Block timestamp */
+    timestamp: number;
+}
+export declare function isValidTick(tick: number): boolean;
+export declare function isValidSlippage(slippage: number): boolean;
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

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

package/lib/utils/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Utility functions and helpers
+ * Centralized export for all utility modules
+ */
+export * from "./math";
+export * from "./pda";
+export * from "./tick";
+export * from "./pool";
+import { Rpc, SignatureBytes, SolanaRpcApiDevnet, SolanaRpcApiMainnet, SolanaRpcApiTestnet, type Address } from "@solana/kit";
+/**
+ * Validate that an address is not empty
+ * @param address - Address to validate
+ * @param name - Name for error messages
+ * @throws ClmmError if address is invalid
+ */
+export declare function validateAddress(address: Address, name?: string): void;
+/**
+ * Validate that an amount is positive
+ * @param amount - Amount to validate
+ * @param name - Name for error messages
+ * @throws ClmmError if amount is invalid
+ */
+export declare function validateAmount(amount: bigint, name?: string): void;
+/**
+ * Sleep for a specified number of milliseconds
+ * @param ms - Milliseconds to sleep
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Format a bigint amount to a human-readable string with decimals
+ * @param amount - Raw amount as bigint
+ * @param decimals - Number of decimal places
+ * @param precision - Display precision (default: 6)
+ * @returns Formatted string
+ */
+export declare function formatAmount(amount: bigint, decimals: number, precision?: number): string;
+/**
+ * Check if two bigints are approximately equal (within tolerance)
+ * @param a - First value
+ * @param b - Second value
+ * @param tolerance - Tolerance (default: 1)
+ * @returns Whether values are approximately equal
+ */
+export declare function approximatelyEqual(a: bigint, b: bigint, tolerance?: bigint): boolean;
+/**
+ * Retry a function with exponential backoff
+ * @param fn - Function to retry
+ * @param maxRetries - Maximum number of retries
+ * @param initialDelay - Initial delay in milliseconds
+ * @returns Promise resolving to function result
+ */
+export declare function retry<T>(fn: () => Promise<T>, maxRetries?: number, initialDelay?: number): Promise<T>;
+/**
+ * Convert basis points to percentage
+ * @param basisPoints - Value in basis points (1 bp = 0.01%)
+ * @returns Percentage value (0.01 = 1%)
+ */
+export declare function basisPointsToPercentage(basisPoints: number): number;
+/**
+ * Convert percentage to basis points
+ * @param percentage - Percentage value (0.01 = 1%)
+ * @returns Value in basis points
+ */
+export declare function percentageToBasisPoints(percentage: number): number;
+/**
+ * Check if a string is a valid Solana address format
+ * @param address - Address string to validate
+ * @returns Whether the address format is valid
+ */
+export declare function isValidSolanaAddress(address: string): boolean;
+export declare function addresstoBytes(address: Address): import("@solana/kit").ReadonlyUint8Array;
+export declare function getFakeSigner(address: Address): {
+    address: Address;
+    signAndSendTransactions: (transactions: readonly Readonly<{
+        messageBytes: import("@solana/kit").TransactionMessageBytes;
+        signatures: import("@solana/kit").SignaturesMap;
+    }>[], _config: import("@solana/kit").BaseTransactionSignerConfig | undefined) => Promise<SignatureBytes[]>;
+};
+/**
+ * A very brutal way to differentate between mainnet and devnet RPC
+ */
+export declare function getApisFromEndpoint(rpc: Rpc<SolanaRpcApiMainnet | SolanaRpcApiDevnet | SolanaRpcApiTestnet>): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AAIvB,OAAO,EAGL,GAAG,EACH,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EAEnB,KAAK,OAAO,EACb,MAAM,aAAa,CAAC;AAIrB;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,MAAkB,GACvB,IAAI,CAON;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,MAAiB,GAAG,IAAI,CAO5E;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAU,GACpB,MAAM,CAmBR;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,SAAS,GAAE,MAAW,GACrB,OAAO,CAGT;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,GAAE,MAAU,EACtB,YAAY,GAAE,MAAa,GAC1B,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQ7D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,4CAG9C;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO;;;;;;EAS7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,GAAG,CAAC,mBAAmB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC,UAOzE"}