@gala-chain/launchpad-sdk 5.0.4-beta.6 → 5.0.4-beta.60

package/dist/services/GSwapLiquidityMutationService.d.ts

@@ -0,0 +1,138 @@
+import type { TokenClassKey } from '../types/common';
+import type { GSwapAddLiquidityResult } from '../types/gswap-responses.types';
+import { LoggerBase } from './BaseService';
+import type { GalaChainGatewayClient } from './GalaChainGatewayClient';
+import type { GSwapLiquidityQueryService } from './GSwapLiquidityQueryService';
+import type { GSwapPoolCalculationService } from './GSwapPoolCalculationService';
+import type { WebSocketService } from './WebSocketService';
+/**
+ * Configuration for GSwapLiquidityMutationService
+ */
+export interface GSwapLiquidityMutationServiceConfig {
+    privateKey?: string;
+    getWalletAddress: () => string | undefined;
+    gatewayClient: GalaChainGatewayClient;
+    bundlerBaseUrl: string;
+    galaChainBaseUrl: string;
+    webSocketService: WebSocketService;
+    calculationService: GSwapPoolCalculationService;
+    liquidityQueryService: GSwapLiquidityQueryService;
+    debugMode?: boolean;
+}
+/**
+ * Liquidity position mutation operations for GSwap DEX
+ *
+ * @since 5.15.0
+ */
+export declare class GSwapLiquidityMutationService extends LoggerBase {
+    private privateKey;
+    private getWalletAddress;
+    private gatewayClient;
+    private bundlerBaseUrl;
+    private webSocketService;
+    private calculationService;
+    private tokenConverter;
+    private bundlerClient;
+    constructor(config: GSwapLiquidityMutationServiceConfig);
+    /**
+     * Get or create the bundler HTTP client
+     */
+    private getBundlerClient;
+    /**
+     * Convert a token pair from Launchpad format to GSwap format
+     */
+    private convertTokenPair;
+    /**
+     * Calculate personal sign prefix for GalaChain compatibility
+     */
+    private calculatePersonalSignPrefix;
+    /**
+     * Ensure WebSocket is connected before transaction monitoring
+     */
+    private ensureWebSocketConnected;
+    /**
+     * Build strings instructions for state locking
+     */
+    private buildLiquidityStringsInstructions;
+    /**
+     * Monitor bundler transaction with consistent error handling
+     */
+    private monitorBundlerTransaction;
+    /**
+     * Send AddLiquidity transaction directly to bundler
+     */
+    private sendAddLiquidityToBundler;
+    /**
+     * Send RemoveLiquidity transaction directly to bundler
+     */
+    private sendRemoveLiquidityToBundler;
+    /**
+     * Send CollectPositionFees transaction directly to bundler
+     */
+    private sendCollectPositionFeesToBundler;
+    /**
+     * Add concentrated liquidity using user-friendly price ranges
+     */
+    addLiquidityByPrice(args: {
+        token0: string;
+        token1: string;
+        fee: number;
+        minPrice: string;
+        maxPrice: string;
+        amount0Desired: string;
+        amount1Desired: string;
+        amount0Min?: string;
+        amount1Min?: string;
+    }): Promise<GSwapAddLiquidityResult & {
+        timestamp?: Date;
+        wait?: (timeoutMs?: number) => Promise<void>;
+    }>;
+    /**
+     * Add concentrated liquidity using tick boundaries
+     */
+    addSwapLiquidityByTicks(args: {
+        token0: string;
+        token1: string;
+        feeTier: number;
+        tickLower: number;
+        tickUpper: number;
+        amount0Desired: string;
+        amount1Desired: string;
+        amount0Min?: string;
+        amount1Min?: string;
+    }): Promise<GSwapAddLiquidityResult & {
+        timestamp?: Date;
+        wait?: (timeoutMs?: number) => Promise<void>;
+    }>;
+    /**
+     * Remove liquidity from a position
+     */
+    removeLiquidity(args: {
+        token0: string | TokenClassKey;
+        token1: string | TokenClassKey;
+        fee: number;
+        tickLower: number;
+        tickUpper: number;
+        liquidity: string;
+        amount0Min?: string;
+        amount1Min?: string;
+        positionId?: string;
+    }): Promise<GSwapAddLiquidityResult>;
+    /**
+     * Collect accumulated trading fees from a position
+     */
+    collectPositionFees(args: {
+        token0?: string | TokenClassKey;
+        token1?: string | TokenClassKey;
+        fee?: number;
+        tickLower?: number;
+        tickUpper?: number;
+        amount0Requested?: string;
+        amount1Requested?: string;
+        positionId?: string;
+        ownerAddress?: string;
+        amount0Max?: string;
+        amount1Max?: string;
+    }): Promise<GSwapAddLiquidityResult>;
+}
+//# sourceMappingURL=GSwapLiquidityMutationService.d.ts.map

package/dist/services/GSwapLiquidityMutationService.d.ts.map

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

package/dist/services/GSwapLiquidityQueryService.d.ts

@@ -0,0 +1,75 @@
+import type { GSwapPosition } from '../types/gswap.dto';
+import type { GSwapEstimateRemoveLiquidityResult, GSwapGetPositionByIdResult, GSwapGetPositionResult } from '../types/gswap-responses.types';
+import { LoggerBase } from './BaseService';
+import type { GalaChainGatewayClient } from './GalaChainGatewayClient';
+import type { GSwapPoolCalculationService } from './GSwapPoolCalculationService';
+/**
+ * Configuration for GSwapLiquidityQueryService
+ */
+export interface GSwapLiquidityQueryServiceConfig {
+    gatewayClient: GalaChainGatewayClient;
+    galaChainBaseUrl: string;
+    calculationService: GSwapPoolCalculationService;
+    debugMode?: boolean;
+}
+/**
+ * Liquidity position query operations for GSwap DEX
+ *
+ * @since 5.15.0
+ */
+export declare class GSwapLiquidityQueryService extends LoggerBase {
+    private gatewayClient;
+    private calculationService;
+    private tokenConverter;
+    constructor(config: GSwapLiquidityQueryServiceConfig);
+    /**
+     * Convert a token pair from Launchpad format to GSwap format
+     */
+    private convertTokenPair;
+    /**
+     * Parse token string to TokenClassKey with flexible format handling
+     */
+    private parseTokenFlexible;
+    /**
+     * Extract token symbol from various API response formats
+     */
+    private extractTokenSymbol;
+    /**
+     * Normalize position response from various API formats to GSwapPosition
+     */
+    normalizePositionResponse(rawPosition: GSwapGetPositionResult | GSwapGetPositionByIdResult, ownerAddress: string): GSwapPosition;
+    /**
+     * Fetch a liquidity position by compound key
+     */
+    getLiquidityPosition(ownerAddress: string, position: {
+        token0: string;
+        token1: string;
+        fee: number;
+        tickLower: number;
+        tickUpper: number;
+    }): Promise<GSwapPosition>;
+    /**
+     * Fetch a single liquidity position using ONLY the compound key (via GalaChainGatewayClient)
+     */
+    fetchSwapPositionDirect(params: {
+        token0: string;
+        token1: string;
+        fee: number;
+        tickLower: number;
+        tickUpper: number;
+        owner: string;
+    }): Promise<GSwapPosition>;
+    /**
+     * Estimate token amounts that will be received when removing liquidity
+     */
+    estimateRemoveLiquidity(args: {
+        token0: string;
+        token1: string;
+        fee: number;
+        liquidity: string;
+        tickLower: number;
+        tickUpper: number;
+        owner: string;
+    }): Promise<GSwapEstimateRemoveLiquidityResult>;
+}
+//# sourceMappingURL=GSwapLiquidityQueryService.d.ts.map

package/dist/services/GSwapLiquidityQueryService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GSwapLiquidityQueryService.d.ts","sourceRoot":"","sources":["../../src/services/GSwapLiquidityQueryService.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,kCAAkC,EAClC,0BAA0B,EAC1B,sBAAsB,EACvB,MAAM,gCAAgC,CAAC;AASxC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAajF;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,aAAa,EAAE,sBAAsB,CAAC;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,2BAA2B,CAAC;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,UAAU;IACxD,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,cAAc,CAAuB;gBAEjC,MAAM,EAAE,gCAAgC;IAOpD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,yBAAyB,CACvB,WAAW,EAAE,sBAAsB,GAAG,0BAA0B,EAChE,YAAY,EAAE,MAAM,GACnB,aAAa;IAmFhB;;OAEG;IACG,oBAAoB,CACxB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,GACA,OAAO,CAAC,aAAa,CAAC;IAyCzB;;OAEG;IACG,uBAAuB,CAAC,MAAM,EAAE;QACpC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,aAAa,CAAC;IA+C1B;;OAEG;IACG,uBAAuB,CAAC,IAAI,EAAE;QAClC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,kCAAkC,CAAC;CAiChD"}

package/dist/services/GSwapPoolCalculationService.d.ts

@@ -0,0 +1,187 @@
+import type BigNumber from 'bignumber.js';
+import type { Logger } from '../utils/Logger';
+/**
+ * Configuration for GSwapPoolCalculationService
+ */
+export interface GSwapPoolCalculationServiceConfig {
+    logger?: Logger;
+}
+/**
+ * Pure math calculations for DEX pool operations
+ *
+ * All methods in this service are pure functions that:
+ * - Take inputs and return outputs without side effects
+ * - Do not make any API calls
+ * - Do not depend on external state
+ *
+ * @since 5.15.0
+ */
+export declare class GSwapPoolCalculationService {
+    private logger;
+    constructor(config?: GSwapPoolCalculationServiceConfig);
+    /**
+     * Get tick spacing for a given fee tier (Uniswap v3 standard)
+     *
+     * Fee tier to tick spacing mapping:
+     * - 500 (0.05%): tickSpacing = 10
+     * - 3000 (0.30%): tickSpacing = 60
+     * - 10000 (1.00%): tickSpacing = 200
+     *
+     * @param feeTier Fee tier in basis points (500, 3000, or 10000)
+     * @returns Tick spacing for the fee tier
+     * @throws ValidationError if fee tier is invalid
+     */
+    getTickSpacing(feeTier: number): number;
+    /**
+     * Validate that tick values are valid multiples of the tick spacing for the given fee tier
+     *
+     * @param tickLower - Lower tick boundary
+     * @param tickUpper - Upper tick boundary
+     * @param feeTier - Fee tier (500, 3000, or 10000)
+     * @throws ValidationError if ticks are not valid multiples of tick spacing
+     */
+    validateTickSpacing(tickLower: number, tickUpper: number, feeTier: number): void;
+    /**
+     * Calculate price from sqrtPriceX96 format (Uniswap v3 standard)
+     * price = (sqrtPriceX96 / 2^96)^2
+     *
+     * @param sqrtPriceX96 Square root price in X96 format
+     * @returns Calculated price as BigNumber
+     */
+    calculatePriceFromSqrtPriceX96(sqrtPriceX96: BigNumber): BigNumber;
+    /**
+     * Calculate price from sqrtPrice in decimal format (GetSlot0 API)
+     * Different from sqrtPriceX96 - GetSlot0 returns already-decoded decimal
+     * Formula: price = sqrtPrice²
+     *
+     * @param sqrtPrice Square root price in decimal format
+     * @returns Calculated price as BigNumber
+     */
+    calculatePriceFromSqrtPriceDecimal(sqrtPrice: BigNumber): BigNumber;
+    /**
+     * Calculate liquidity from amount0 (Uniswap v3 math)
+     * Uses @gala-chain/dex liquidity0() function for production-accurate calculation
+     *
+     * @param amount0 Amount of token0
+     * @param tickLower Lower tick boundary
+     * @param tickUpper Upper tick boundary
+     * @returns Calculated liquidity
+     */
+    calculateLiquidityFromAmount0(amount0: BigNumber, tickLower: number, tickUpper: number): BigNumber;
+    /**
+     * Calculate liquidity from amount1 (Uniswap v3 math)
+     * Uses @gala-chain/dex liquidity1() function for production-accurate calculation
+     *
+     * @param amount1 Amount of token1
+     * @param tickLower Lower tick boundary
+     * @param tickUpper Upper tick boundary
+     * @returns Calculated liquidity
+     */
+    calculateLiquidityFromAmount1(amount1: BigNumber, tickLower: number, tickUpper: number): BigNumber;
+    /**
+     * Calculate amount0 from liquidity (Uniswap v3 math)
+     * Uses @gala-chain/dex getAmount0Delta() function for production-accurate calculation
+     *
+     * @param liquidity Liquidity amount
+     * @param tickLower Lower tick boundary
+     * @param tickCurrent Current tick
+     * @returns Amount of token0
+     */
+    calculateAmount0FromLiquidity(liquidity: BigNumber, tickLower: number, tickCurrent: number): BigNumber;
+    /**
+     * Calculate amount1 from liquidity (Uniswap v3 math)
+     * Uses @gala-chain/dex getAmount1Delta() function for production-accurate calculation
+     *
+     * @param liquidity Liquidity amount
+     * @param tickCurrent Current tick
+     * @param tickUpper Upper tick boundary
+     * @returns Amount of token1
+     */
+    calculateAmount1FromLiquidity(liquidity: BigNumber, tickCurrent: number, tickUpper: number): BigNumber;
+    /**
+     * Calculate optimal token amounts for concentrated liquidity position
+     *
+     * @param currentTick Current pool tick
+     * @param desiredAmount0 Desired amount of token0
+     * @param desiredAmount1 Desired amount of token1
+     * @param tickLower Lower tick boundary
+     * @param tickUpper Upper tick boundary
+     * @returns Optimal amounts and utilization percentages
+     */
+    calculateOptimalPositionSize(currentTick: number, desiredAmount0: string, desiredAmount1: string, tickLower: number, tickUpper: number): {
+        amount0: string;
+        amount1: string;
+        liquidity: string;
+        ratio: string;
+        utilizationPercent: {
+            amount0: string;
+            amount1: string;
+        };
+    };
+    /**
+     * Validate liquidity position parameters before creation
+     *
+     * @param feeTier Fee tier (500, 3000, or 10000 basis points)
+     * @param tickLower Lower tick boundary
+     * @param tickUpper Upper tick boundary
+     * @param amount0 Token A amount
+     * @param amount1 Token B amount
+     * @param currentTick Current pool tick (optional)
+     * @param poolLiquidity Current pool liquidity (optional)
+     * @returns Validation result with errors and warnings
+     */
+    validatePositionParameters(feeTier: number, tickLower: number, tickUpper: number, amount0: string, amount1: string, currentTick?: number, poolLiquidity?: string): {
+        valid: boolean;
+        errors: string[];
+        warnings: string[];
+        gasEstimate: number;
+        tickSpacing?: number;
+        currentTick?: number;
+        poolLiquidity?: string;
+    };
+    /**
+     * Convert human-readable price range to tick boundaries
+     *
+     * @param minPrice Minimum price boundary
+     * @param maxPrice Maximum price boundary
+     * @param feeTier Fee tier (500, 3000, or 10000 basis points)
+     * @returns Calculated tick boundaries and price deviations
+     */
+    calculateTicksForPrice(minPrice: string, maxPrice: string, feeTier: number): {
+        tickLower: number;
+        tickUpper: number;
+        tickSpacing: number;
+        requestedMinPrice: string;
+        requestedMaxPrice: string;
+        actualMinPrice: string;
+        actualMaxPrice: string;
+        priceDeviation: {
+            minPriceDeviation: string;
+            maxPriceDeviation: string;
+        };
+    };
+    /**
+     * Convert tick boundaries back to human-readable prices
+     *
+     * @param tickLower Lower tick boundary
+     * @param tickUpper Upper tick boundary
+     * @returns Price range
+     */
+    calculatePriceForTicks(tickLower: number, tickUpper: number): {
+        tickLower: number;
+        tickUpper: number;
+        minPrice: string;
+        maxPrice: string;
+        priceRange: string;
+        tickSpread: number;
+    };
+    /**
+     * Calculate execution price (output per unit input)
+     *
+     * @param inputAmount Amount of input token
+     * @param outputAmount Amount of output token
+     * @returns Execution price as string
+     */
+    calculateExecutionPrice(inputAmount: string | BigNumber, outputAmount: string | BigNumber): string;
+}
+//# sourceMappingURL=GSwapPoolCalculationService.d.ts.map

package/dist/services/GSwapPoolCalculationService.d.ts.map

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

package/dist/services/GSwapPoolQueryService.d.ts

@@ -0,0 +1,115 @@
+/**
+ * GSwapPoolQueryService - Pool Data Queries
+ *
+ * Provides pool query operations:
+ * - Pool data fetching (getPoolData)
+ * - Pool slot0 queries (getPoolSlot0)
+ * - Pool info aggregation (getPoolInfo)
+ * - Spot price calculation (calculateDexPoolSpotPrice)
+ * - Position current price (getPositionCurrentPrice)
+ *
+ * This service handles all read-only pool data queries from GalaChain Gateway.
+ */
+import type { TokenClassKey } from '../types/common';
+import type { PoolInfo, PoolPriceData, PoolSlot0Data } from '../types/gswap.dto';
+import { LoggerBase } from './BaseService';
+import type { GalaChainGatewayClient } from './GalaChainGatewayClient';
+import type { GSwapPoolCalculationService } from './GSwapPoolCalculationService';
+/**
+ * Configuration for GSwapPoolQueryService
+ */
+export interface GSwapPoolQueryServiceConfig {
+    gatewayClient: GalaChainGatewayClient;
+    galaChainBaseUrl: string;
+    calculationService: GSwapPoolCalculationService;
+    debugMode?: boolean;
+}
+/**
+ * Pool query operations for GSwap DEX
+ *
+ * @since 5.15.0
+ */
+export declare class GSwapPoolQueryService extends LoggerBase {
+    private gatewayClient;
+    private calculationService;
+    private tokenConverter;
+    constructor(config: GSwapPoolQueryServiceConfig);
+    /**
+     * Convert a token pair from Launchpad format to GSwap format
+     *
+     * @param token0 - First token in any supported format
+     * @param token1 - Second token in any supported format
+     * @returns Object with converted tokens as gswapToken0 and gswapToken1
+     */
+    private convertTokenPair;
+    /**
+     * Get real-time pool state with liquidity depth and current price
+     *
+     * @param tokenA First token symbol (e.g., 'GALA')
+     * @param tokenB Second token symbol (e.g., 'GUSDC')
+     * @param feeTier Fee tier (500, 3000, or 10000 basis points)
+     * @returns Pool data with liquidity, current tick, and price
+     */
+    getPoolData(tokenA: string, tokenB: string, feeTier: number): Promise<{
+        tokenA: string;
+        tokenB: string;
+        feeTier: number;
+        liquidity: string;
+        sqrtPriceX96: string;
+        tick: number;
+        feeGrowthGlobal0X128: string;
+        feeGrowthGlobal1X128: string;
+        currentPrice: string;
+    }>;
+    /**
+     * Get pool information for token pair (aggregates across fee tiers)
+     *
+     * @param tokenA First token
+     * @param tokenB Second token
+     * @returns Pool information with total liquidity
+     */
+    getPoolInfo(tokenA: string, tokenB: string): Promise<PoolInfo>;
+    /**
+     * Get current pool state (slot0 data) for a token pair
+     * Fetches sqrtPrice, tick, and liquidity from GalaChain Gateway
+     *
+     * @param token0 First token symbol or TokenClassKey
+     * @param token1 Second token symbol or TokenClassKey
+     * @param fee Fee tier in basis points (500, 3000, 10000)
+     * @returns PoolSlot0Data with current sqrtPrice, tick, liquidity, and feeGrowth
+     */
+    getPoolSlot0(token0: string | TokenClassKey, token1: string | TokenClassKey, fee: number): Promise<PoolSlot0Data>;
+    /**
+     * Calculate current market price for a token pair from DEX pool
+     *
+     * @param tokenA First token symbol
+     * @param tokenB Second token symbol
+     * @param feeTier Fee tier (500, 3000, or 10000 basis points)
+     * @returns Current spot price without executing trade
+     */
+    calculateDexPoolSpotPrice(tokenA: string, tokenB: string, feeTier: number): Promise<{
+        tokenA: string;
+        tokenB: string;
+        feeTier: number;
+        price: string;
+        invertedPrice: string;
+        tick: number;
+        liquidity: string;
+    }>;
+    /**
+     * Get current price for a liquidity position's pool
+     * Fetches slot0 data and calculates token0/token1 price ratio
+     *
+     * @param position Position token pair and fee tier
+     */
+    getPositionCurrentPrice(position: {
+        token0: string;
+        token1: string;
+        feeTier: number;
+    }): Promise<PoolPriceData>;
+    /**
+     * Chunk array into smaller batches for concurrent processing
+     */
+    chunkArray<T>(array: T[], size: number): T[][];
+}
+//# sourceMappingURL=GSwapPoolQueryService.d.ts.map

package/dist/services/GSwapPoolQueryService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GSwapPoolQueryService.d.ts","sourceRoot":"","sources":["../../src/services/GSwapPoolQueryService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,aAAa,EACd,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,sBAAsB,CAAC;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,2BAA2B,CAAC;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;IACnD,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,cAAc,CAAuB;gBAEjC,MAAM,EAAE,2BAA2B;IAO/C;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;;;;;;OAOG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,oBAAoB,EAAE,MAAM,CAAC;QAC7B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IA4CF;;;;;;OAMG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAqEpE;;;;;;;;OAQG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,GAAG,aAAa,EAC9B,MAAM,EAAE,MAAM,GAAG,aAAa,EAC9B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,aAAa,CAAC;IA0CzB;;;;;;;OAOG;IACG,yBAAyB,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IA2BF;;;;;OAKG;IACG,uBAAuB,CAAC,QAAQ,EAAE;QACtC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,aAAa,CAAC;IAqC1B;;OAEG;IACH,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE;CAO/C"}