@gala-chain/launchpad-sdk 6.0.0 → 7.0.0-beta.2

package/dist/src/types/gswap.dto.d.ts

@@ -1,448 +0,0 @@
-/**
- * GSwap SDK Type Definitions and DTOs
- *
- * Interfaces for GalaSwap integration including:
- * - Service configuration
- * - Swap requests and responses
- * - Asset and pool information
- */
-import type { HttpClient } from '../utils/http';
-import type { TokenClassKey } from './common';
-/**
- * Token class representation
- * Used for identifying tokens in GSwap API
- */
-export interface TokenClass {
-    collection: string;
-    category: string;
-    type: string;
-    additionalKey: string;
-}
-/**
- * GSwapService configuration
- * @agent Configuration for initializing GSwap trading service with optional wallet support and environment URLs
- */
-export interface GSwapServiceConfig {
-    privateKey?: string | undefined;
-    getWalletAddress: () => string | undefined;
-    gatewayBaseUrl?: string | undefined;
-    bundlerBaseUrl?: string | undefined;
-    galaChainBaseUrl?: string | undefined;
-    dexBackendBaseUrl?: string | undefined;
-    dexBackendHttp?: HttpClient | undefined;
-}
-/**
- * Parameters for getting swap quotes
- * @agent Use to request price quotes before executing swaps. Supports both exact-input (known spend) and exact-output (known receive) patterns
- */
-export interface SwapQuoteParams {
-    fromToken: string;
-    toToken: string;
-    amount: string;
-}
-/**
- * Result from swap quote
- * @agent Contains price, impact, and fee information needed for executeSwap. Always get quote before executing swap
- */
-export interface SwapQuoteResult {
-    fromToken: string;
-    toToken: string;
-    inputAmount: string;
-    estimatedOutput: string;
-    feeTier: number;
-    priceImpact: string;
-    executionPrice: string;
-    currentSqrtPrice: string;
-    newSqrtPrice: string;
-}
-/**
- * Parameters for executing a swap
- * @agent Use to execute DEX trade with slippage protection. Must pass estimatedOutput and feeTier from quote result
- */
-export interface ExecuteSwapParams {
-    fromToken: string;
-    toToken: string;
-    inputAmount: string;
-    estimatedOutput: string;
-    feeTier: number;
-    slippageTolerance?: number;
-}
-/**
- * Result from executing a swap
- * @agent Contains transaction details after swap execution. Monitor via transactionId for real-time status updates. Optionally call .wait() to monitor completion
- */
-export interface ExecuteSwapResult {
-    transactionId: string;
-    status: string;
-    fromToken: string;
-    toToken: string;
-    inputAmount: string;
-    outputAmount: string;
-    feeTier: number;
-    slippageTolerance: number;
-    timestamp: Date;
-    /**
-     * Wait for transaction completion (convenience method)
-     *
-     * Monitors the transaction via WebSocket until it completes or times out.
-     * This is a convenience method matching the GSwap SDK pattern: const result = await pendingTx.wait();
-     *
-     * @param timeoutMs Optional timeout in milliseconds (defaults to 120000 / 2 minutes)
-     * @returns Promise that resolves when transaction completes
-     *
-     * @example
-     * ```typescript
-     * const result = await sdk.executeSwap(params);
-     * await result.wait(); // Waits for completion
-     * console.log('Swap confirmed!');
-     * ```
-     */
-    wait?(timeoutMs?: number): Promise<void>;
-}
-/**
- * Base DEX token information (without balance)
- * @agent Represents token metadata available on the DEX. Used for token discovery via fetchAvailableDexTokens()
- * @since 4.1.0
- */
-export interface DexToken {
-    image: string;
-    name: string;
-    symbol: string;
-    decimals: number;
-    description: string;
-    verified: boolean;
-    compositeKey: string;
-    additionalKey: string;
-    category: string;
-    type: string;
-    collection: string;
-    subscribePrice: boolean;
-}
-/**
- * User asset (token balance) - extends DexToken with balance info
- * @agent Represents a single token holding in user's DEX portfolio. Retrieved via getSwapUserAssets()
- */
-export interface UserAsset extends DexToken {
-    tokenId: unknown;
-    balance: string;
-}
-/**
- * Options for fetching available DEX tokens (token discovery)
- *
- * Uses page/limit pagination (1-indexed page numbers) for DEX backend.
- * Note: This is different from Launchpad backend which uses cursor/pageSize.
- *
- * @agent Configuration for paginated token discovery via fetchAvailableDexTokens()
- * @since 4.1.0
- */
-export interface FetchAvailableDexTokensOptions {
-    search?: string;
-    limit?: number;
-    page?: number;
-}
-/**
- * Paginated result for available DEX tokens
- * @agent Return type for fetchAvailableDexTokens() with pagination metadata
- * @since 4.1.0
- */
-export interface AvailableDexTokensResult {
-    tokens: DexToken[];
-    count: number;
-    page: number;
-    limit: number;
-    hasMore: boolean;
-}
-/**
- * Pool information for token pair
- * @agent Provides liquidity and fee tier data for token pairs. Use to assess pool depth and fee structure before trading
- */
-export interface PoolInfo {
-    tokenA: string;
-    tokenB: string;
-    liquidity: string;
-    feeTiers: number[];
-    swapCount: number;
-}
-/**
- * GSwap API error response
- */
-export interface GSwapError {
-    code: string;
-    message: string;
-    details?: unknown;
-}
-/**
- * Options for swap execution
- */
-export interface SwapExecutionOptions {
-    maxSlippage?: number;
-    timeout?: number;
-    waitForCompletion?: boolean;
-    feeMultiplier?: number;
-}
-/**
- * Detailed quote with breakdown
- */
-export interface DetailedQuote extends SwapQuoteResult {
-    fees: {
-        protocolFee: string;
-        liquidityProviderFee: string;
-        totalFee: string;
-        effectiveFeePercentage: string;
-    };
-    execution: {
-        minOutputWithSlippage: string;
-        maxInputWithSlippage?: string;
-        path: string[];
-        liquidityProviders: string[];
-    };
-    risk: {
-        highSlippage: boolean;
-        untrustedPools: boolean;
-        warnings: string[];
-    };
-}
-/**
- * Liquidity position in a DEX pool
- * @agent Represents a user's liquidity provision position with price/tick range, token amounts, and fee accumulation
- */
-export interface LiquidityPosition {
-    positionId: string;
-    ownerAddress: string;
-    token0: string;
-    token1: string;
-    feeTier: number;
-    tickLower: number;
-    tickUpper: number;
-    liquidity: string;
-    amount0: string;
-    amount1: string;
-    feeAmount0: string;
-    feeAmount1: string;
-    createdAt?: Date;
-    updatedAt?: Date;
-}
-/**
- * GSwap position - Type-safe liquidity position from GalaSwap API
- * @agent Represents liquidity provider position with full type safety
- * @alias LiquidityPosition - Provides type-safe return type for GSwapService methods
- */
-export type GSwapPosition = LiquidityPosition;
-/**
- * Parameters for adding liquidity by price range
- * @agent User-friendly LP creation using min/max prices. Recommended for most users. SDK calculates tick boundaries automatically
- */
-export interface AddLiquidityByPriceArgs {
-    token0: string;
-    token1: string;
-    fee: number;
-    minPrice: string;
-    maxPrice: string;
-    amount0Desired: string;
-    amount1Desired: string;
-    amount0Min?: string;
-    amount1Min?: string;
-}
-/**
- * Parameters for adding liquidity by tick range
- * @agent Advanced LP creation using precise tick boundaries. For experienced users who want full control
- */
-export interface AddLiquidityByTicksArgs {
-    token0: string;
-    token1: string;
-    feeTier: number;
-    tickLower: number;
-    tickUpper: number;
-    amount0Desired: string;
-    amount1Desired: string;
-    amount0Min?: string;
-    amount1Min?: string;
-}
-/**
- * Parameters for removing liquidity from a position
- * @agent Closes or reduces a liquidity position and withdraws underlying tokens
- *
- * Requires full pool information to resolve token class keys and construct the transaction.
- * When removing liquidity, you must specify the pool (token0, token1, fee) and position bounds (tickLower, tickUpper).
- * Use getSwapLiquidityPositionById() to fetch these values if you only have the position ID.
- */
-export interface RemoveLiquidityArgs {
-    token0: string | TokenClassKey;
-    token1: string | TokenClassKey;
-    fee: number;
-    tickLower: number;
-    tickUpper: number;
-    liquidity: string;
-    amount0Min?: string;
-    amount1Min?: string;
-    positionId?: string;
-    deadline?: number;
-}
-/**
- * Parameters for collecting accumulated position fees
- * @agent Harvest accumulated trading fees without modifying the position itself
- */
-export interface CollectFeesArgs {
-    ownerAddress: string;
-    positionId: string;
-    amount0Max?: string;
-    amount1Max?: string;
-}
-/**
- * Result from estimating liquidity removal
- * @agent Preview of tokens received when removing liquidity at current prices
- */
-export interface EstimateRemoveLiquidityResult {
-    amount0: string;
-    amount1: string;
-    fee0: string;
-    fee1: string;
-    liquidity: string;
-    tickLower: number;
-    tickUpper: number;
-    token0Symbol: string;
-    token1Symbol: string;
-    currentPrice: string;
-}
-/**
- * Real-time pool state data
- * @agent Provides liquidity depth and current price for pre-trade analysis
- */
-export interface PoolData {
-    tokenA: string;
-    tokenB: string;
-    feeTier: number;
-    liquidity: string;
-    sqrtPriceX96: string;
-    tick: number;
-    feeGrowthGlobal0X128: string;
-    feeGrowthGlobal1X128: string;
-    currentPrice: string;
-}
-/**
- * Spot price calculation result
- * @agent Current market price without executing trade
- */
-export interface SpotPriceResult {
-    tokenA: string;
-    tokenB: string;
-    feeTier: number;
-    price: string;
-    invertedPrice: string;
-    tick: number;
-    liquidity: string;
-}
-/**
- * Optimal position size calculation
- * @agent Calculates optimal token amounts for concentrated liquidity
- */
-export interface OptimalPositionResult {
-    amount0: string;
-    amount1: string;
-    liquidity: string;
-    ratio: string;
-    utilizationPercent: {
-        amount0: string;
-        amount1: string;
-    };
-}
-/**
- * Position parameter validation result
- * @agent Pre-flight validation for liquidity operations
- */
-export interface ValidationResult {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-    gasEstimate: number;
-    tickSpacing?: number;
-    currentTick?: number;
-    poolLiquidity?: string;
-}
-/**
- * Tick calculation from price range
- * @agent Converts human-readable prices to tick boundaries
- */
-export interface TickCalculationResult {
-    tokenA: string;
-    tokenB: string;
-    feeTier: number;
-    tickLower: number;
-    tickUpper: number;
-    tickSpacing: number;
-    requestedMinPrice: string;
-    requestedMaxPrice: string;
-    actualMinPrice: string;
-    actualMaxPrice: string;
-    priceDeviation: {
-        minPriceDeviation: string;
-        maxPriceDeviation: string;
-    };
-}
-/**
- * Price calculation from tick boundaries
- * @agent Converts tick boundaries back to prices
- */
-export interface PriceFromTicksResult {
-    tokenA: string;
-    tokenB: string;
-    tickLower: number;
-    tickUpper: number;
-    minPrice: string;
-    maxPrice: string;
-    currentPrice?: string;
-    priceRange: string;
-    tickSpread: number;
-}
-/**
- * Pool slot0 data from GetSlot0 API
- * Contains current pool state including price and liquidity
- */
-export interface PoolSlot0Data {
-    sqrtPrice: string;
-    tick: number;
-    liquidity: string;
-    grossPoolLiquidity: string;
-}
-/**
- * Calculated pool price data
- * Combines slot0 data with calculated price
- */
-export interface PoolPriceData {
-    price: string;
-    sqrtPrice: string;
-    tick: number;
-    liquidity: string;
-}
-/**
- * Options for liquidity position queries with optional pricing
- * @agent Controls whether to enrich positions with real-time pricing data
- * @note Concurrency level is controlled by SDK-level pricingConcurrency config (not per-call parameter)
- */
-export interface GetLiquidityPositionsOptions {
-    withPrices?: boolean;
-}
-/**
- * Pricing data for a liquidity position pool
- * @agent Contains current market price and execution estimates for position's token pair
- */
-export interface PositionPoolPrice {
-    token0: string;
-    token1: string;
-    feeTier: number;
-    currentPrice: string;
-    executionPrice: string;
-    priceImpact: string;
-    estimatedOutput: string;
-    pricedAt: Date;
-}
-/**
- * Result from fetching liquidity positions with optional pricing
- * @agent Return type for paginated position queries with optional price enrichment
- */
-export interface GetLiquidityPositionsResult {
-    items: GSwapPosition[];
-    nextBookmark?: string;
-    prices?: Map<string, PositionPoolPrice>;
-}
-//# sourceMappingURL=gswap.dto.d.ts.map

package/dist/src/types/gswap.dto.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gswap.dto.d.ts","sourceRoot":"","sources":["../../../src/types/gswap.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAEjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAKhC,gBAAgB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAG3C,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,cAAc,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAE9B,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,EAAE,MAAM,CAAC;IAKhB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAE9B,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,EAAE,MAAM,CAAC;IAGhB,WAAW,EAAE,MAAM,CAAC;IAGpB,eAAe,EAAE,MAAM,CAAC;IAGxB,OAAO,EAAE,MAAM,CAAC;IAGhB,WAAW,EAAE,MAAM,CAAC;IAGpB,cAAc,EAAE,MAAM,CAAC;IAGvB,gBAAgB,EAAE,MAAM,CAAC;IAGzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAEhC,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,EAAE,MAAM,CAAC;IAGhB,WAAW,EAAE,MAAM,CAAC;IAGpB,eAAe,EAAE,MAAM,CAAC;IAGxB,OAAO,EAAE,MAAM,CAAC;IAGhB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAEhC,aAAa,EAAE,MAAM,CAAC;IAGtB,MAAM,EAAE,MAAM,CAAC;IAGf,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,EAAE,MAAM,CAAC;IAGhB,WAAW,EAAE,MAAM,CAAC;IAGpB,YAAY,EAAE,MAAM,CAAC;IAGrB,OAAO,EAAE,MAAM,CAAC;IAGhB,iBAAiB,EAAE,MAAM,CAAC;IAG1B,SAAS,EAAE,IAAI,CAAC;IAEhB;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IAEvB,KAAK,EAAE,MAAM,CAAC;IAGd,IAAI,EAAE,MAAM,CAAC;IAGb,MAAM,EAAE,MAAM,CAAC;IAGf,QAAQ,EAAE,MAAM,CAAC;IAGjB,WAAW,EAAE,MAAM,CAAC;IAGpB,QAAQ,EAAE,OAAO,CAAC;IAGlB,YAAY,EAAE,MAAM,CAAC;IAGrB,aAAa,EAAE,MAAM,CAAC;IAGtB,QAAQ,EAAE,MAAM,CAAC;IAGjB,IAAI,EAAE,MAAM,CAAC;IAGb,UAAU,EAAE,MAAM,CAAC;IAGnB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAU,SAAQ,QAAQ;IAGzC,OAAO,EAAE,OAAO,CAAC;IAGjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,8BAA8B;IAE7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IAEvC,MAAM,EAAE,QAAQ,EAAE,CAAC;IAGnB,KAAK,EAAE,MAAM,CAAC;IAGd,IAAI,EAAE,MAAM,CAAC;IAGb,KAAK,EAAE,MAAM,CAAC;IAGd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IAEvB,MAAM,EAAE,MAAM,CAAC;IAGf,MAAM,EAAE,MAAM,CAAC;IAGf,SAAS,EAAE,MAAM,CAAC;IAGlB,QAAQ,EAAE,MAAM,EAAE,CAAC;IAGnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IAEnC,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAG5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,eAAe;IAEpD,IAAI,EAAE;QAEJ,WAAW,EAAE,MAAM,CAAC;QAGpB,oBAAoB,EAAE,MAAM,CAAC;QAG7B,QAAQ,EAAE,MAAM,CAAC;QAGjB,sBAAsB,EAAE,MAAM,CAAC;KAChC,CAAC;IAGF,SAAS,EAAE;QAET,qBAAqB,EAAE,MAAM,CAAC;QAG9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAG9B,IAAI,EAAE,MAAM,EAAE,CAAC;QAGf,kBAAkB,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;IAGF,IAAI,EAAE;QAEJ,YAAY,EAAE,OAAO,CAAC;QAGtB,cAAc,EAAE,OAAO,CAAC;QAGxB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAEhC,UAAU,EAAE,MAAM,CAAC;IAGnB,YAAY,EAAE,MAAM,CAAC;IAGrB,MAAM,EAAE,MAAM,CAAC;IAGf,MAAM,EAAE,MAAM,CAAC;IAGf,OAAO,EAAE,MAAM,CAAC;IAGhB,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,EAAE,MAAM,CAAC;IAGhB,OAAO,EAAE,MAAM,CAAC;IAGhB,UAAU,EAAE,MAAM,CAAC;IAGnB,UAAU,EAAE,MAAM,CAAC;IAGnB,SAAS,CAAC,EAAE,IAAI,CAAC;IAGjB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IAEtC,MAAM,EAAE,MAAM,CAAC;IAGf,MAAM,EAAE,MAAM,CAAC;IAGf,GAAG,EAAE,MAAM,CAAC;IAGZ,QAAQ,EAAE,MAAM,CAAC;IAGjB,QAAQ,EAAE,MAAM,CAAC;IAGjB,cAAc,EAAE,MAAM,CAAC;IAGvB,cAAc,EAAE,MAAM,CAAC;IAGvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IAEtC,MAAM,EAAE,MAAM,CAAC;IAGf,MAAM,EAAE,MAAM,CAAC;IAGf,OAAO,EAAE,MAAM,CAAC;IAGhB,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,MAAM,CAAC;IAGlB,cAAc,EAAE,MAAM,CAAC;IAGvB,cAAc,EAAE,MAAM,CAAC;IAGvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAElC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;IAG/B,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;IAG/B,GAAG,EAAE,MAAM,CAAC;IAGZ,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,MAAM,CAAC;IAGlB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAE9B,YAAY,EAAE,MAAM,CAAC;IAGrB,UAAU,EAAE,MAAM,CAAC;IAGnB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAE5C,OAAO,EAAE,MAAM,CAAC;IAGhB,OAAO,EAAE,MAAM,CAAC;IAGhB,IAAI,EAAE,MAAM,CAAC;IAGb,IAAI,EAAE,MAAM,CAAC;IAGb,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,MAAM,CAAC;IAGlB,YAAY,EAAE,MAAM,CAAC;IAGrB,YAAY,EAAE,MAAM,CAAC;IAGrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE;QACd,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAG3C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAEhC,MAAM,EAAE,MAAM,CAAC;IAGf,MAAM,EAAE,MAAM,CAAC;IAGf,OAAO,EAAE,MAAM,CAAC;IAGhB,YAAY,EAAE,MAAM,CAAC;IAGrB,cAAc,EAAE,MAAM,CAAC;IAGvB,WAAW,EAAE,MAAM,CAAC;IAGpB,eAAe,EAAE,MAAM,CAAC;IAGxB,QAAQ,EAAE,IAAI,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAE1C,KAAK,EAAE,aAAa,EAAE,CAAC;IAGvB,YAAY,CAAC,EAAE,MAAM,CAAC;IAItB,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACzC"}

package/dist/src/types/holder.types.d.ts

@@ -1,106 +0,0 @@
-/**
- * Holder and Ranking Data Types
- *
- * This module defines types and interfaces for real-time holder updates,
- * holder information queries, and rank-aware holder deltas from TRADE_EXECUTED events.
- *
- * @category Types
- * @since 7.1.0
- */
-/**
- * Types of holder delta changes that can occur after a trade
- */
-export declare const HOLDER_DELTA_TYPES: {
-    readonly NEW_HOLDER: "NEW_HOLDER";
-    readonly EXITED_HOLDER: "EXITED_HOLDER";
-    readonly BALANCE_CHANGED: "BALANCE_CHANGED";
-};
-/**
- * Holder delta type enumeration - derived from HOLDER_DELTA_TYPES const
- */
-export type HolderDeltaType = (typeof HOLDER_DELTA_TYPES)[keyof typeof HOLDER_DELTA_TYPES];
-/**
- * Information about a holder change after a trade execution
- * Includes rank information before and after the trade
- */
-export interface HolderDelta {
-    /** Type of change that occurred */
-    type: HolderDeltaType;
-    /** Wallet address of the holder whose position changed (backend format: eth|...) */
-    userAddress: string;
-    /** New token balance after the trade (string for precision) */
-    balance: string;
-    /** Current rank in the holder list (1 = largest holder) */
-    rank: number;
-    /** Previous rank before this trade (undefined if new holder) */
-    previousRank: number | undefined;
-}
-/**
- * Information about a specific user's holding in a token pool
- * Returned by getUserHolding and included in holder query responses
- */
-export interface UserHoldingData {
-    /** Token name */
-    tokenName: string;
-    /** Normalized user address (backend format: eth|...) */
-    userAddress: string;
-    /** Token quantity held (string for precision), or null if not a holder */
-    quantity: string | null;
-    /** Percentage of max supply held (0-100), or null if not a holder */
-    percentage: number | null;
-    /** Holder tier info, or null if not a holder */
-    holderTier: HolderTierData | null;
-    /** Whether this user created the token */
-    isCreator: boolean;
-    /** Holder rank (1 = largest holder), or null if not a holder */
-    rank: number | null;
-}
-/**
- * Holder tier classification based on holdings
- */
-export interface HolderTierData {
-    /** Tier name (e.g., 'WHALE', 'TOP_HOLDER', 'HODLER') */
-    name: string;
-    /** Tier level (numeric ranking) */
-    level: number;
-}
-/**
- * Response from top holders query
- */
-export interface TopHoldersData {
-    /** Token name */
-    tokenName: string;
-    /** List of top holders (usually top 10) */
-    holders: Array<{
-        /** Wallet address (backend format: eth|...) */
-        userAddress: string;
-        /** Token quantity held */
-        quantity: string;
-    }>;
-    /** Total number of holders for the token */
-    holderCount?: number;
-}
-/**
- * Metadata about holder ranking for a token
- */
-export interface HolderRankInfo {
-    /** Wallet address */
-    userAddress: string;
-    /** User's rank among all holders (1 = largest holder) */
-    rank: number;
-    /** User's token balance */
-    balance: string;
-}
-/**
- * Type guard to check if an object is a valid HolderDelta
- */
-export declare const isHolderDelta: (obj: unknown) => obj is HolderDelta;
-/**
- * Type guard to check if an object is a valid UserHoldingData
- */
-export declare const isUserHoldingData: (obj: unknown) => obj is UserHoldingData;
-/**
- * Type guard to check if a string is a valid HolderDeltaType
- */
-export declare function isHolderDeltaType(value: unknown): value is HolderDeltaType;
-//# sourceMappingURL=holder.types.d.ts.map

package/dist/src/types/holder.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"holder.types.d.ts","sourceRoot":"","sources":["../../../src/types/holder.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE3F;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,IAAI,EAAE,eAAe,CAAC;IACtB,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qEAAqE;IACrE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gDAAgD;IAChD,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC;IAClC,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,OAAO,EAAE,KAAK,CAAC;QACb,+CAA+C;QAC/C,WAAW,EAAE,MAAM,CAAC;QACpB,0BAA0B;QAC1B,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,sCAMxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,0CAQ5B,CAAC;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAO1E"}