@gala-chain/launchpad-sdk 3.31.2 → 4.0.0

package/dist/utils/bignumber-pool-cache.d.ts

@@ -0,0 +1,169 @@
+import BigNumber from 'bignumber.js';
+/**
+ * Singleton BigNumber cache for performance optimization.
+ *
+ * Caches BigNumber instances to avoid repeated parsing of the same values.
+ * Typical savings: 2-5ms per swap operation by reusing instances.
+ *
+ * @example
+ * ```typescript
+ * // Use pre-cached constants
+ * const zero = BigNumberPoolCache.ZERO;
+ * const minLimit = BigNumberPoolCache.MIN_SQRT_RATIO;
+ *
+ * // Cache dynamic values
+ * const amount = BigNumberPoolCache.getCached('1000000');
+ * const amount2 = BigNumberPoolCache.getCached('1000000'); // Same instance!
+ *
+ * // Memory management (call periodically in long-running processes)
+ * BigNumberPoolCache.trimCache(1000); // Keep 1000 most recent entries
+ * ```
+ *
+ * @remarks
+ * Thread-safe for read operations (Map is thread-safe for reads).
+ * Cache grows unbounded unless trimCache() is called periodically.
+ *
+ * @see {@link https://github.com/Uniswap/v3-core/blob/main/contracts/libraries/TickMath.sol | Uniswap V3 TickMath}
+ */
+export declare class BigNumberPoolCache {
+    /**
+     * Internal cache storage (string key → BigNumber instance)
+     * @internal
+     */
+    private static readonly CACHE;
+    /**
+     * Pre-cached zero constant (most frequently used value)
+     * @constant
+     */
+    static readonly ZERO: BigNumber;
+    /**
+     * Pre-cached one constant (used in arithmetic operations)
+     * @constant
+     */
+    static readonly ONE: BigNumber;
+    /**
+     * Fee denominator for Uniswap V3 (1,000,000 = 1,000,000 pips)
+     * Used for fee calculations: actualFee = feeAmount / FEE_PIPS
+     * @constant
+     * @example
+     * ```typescript
+     * // Calculate 0.3% fee (3000 fee tier)
+     * const fee = new BigNumber(3000).div(BigNumberPoolCache.FEE_PIPS);
+     * // fee = 0.003 (0.3%)
+     * ```
+     */
+    static readonly FEE_PIPS: BigNumber;
+    /**
+     * Minimum sqrt price ratio (corresponds to tick -887272)
+     * Uniswap V3 boundary: sqrtPriceX96 cannot go below this value
+     * @constant
+     * @see {@link https://github.com/Uniswap/v3-core/blob/main/contracts/libraries/TickMath.sol#L10 | Uniswap V3 MIN_TICK}
+     */
+    static readonly MIN_SQRT_RATIO: BigNumber;
+    /**
+     * Maximum sqrt price ratio (corresponds to tick 887272)
+     * Uniswap V3 boundary: sqrtPriceX96 cannot exceed this value
+     * @constant
+     * @see {@link https://github.com/Uniswap/v3-core/blob/main/contracts/libraries/TickMath.sol#L13 | Uniswap V3 MAX_TICK}
+     */
+    static readonly MAX_SQRT_RATIO: BigNumber;
+    /**
+     * Get or create cached BigNumber instance.
+     *
+     * Returns the same instance for identical values (referential equality).
+     * Avoids redundant parsing overhead for frequently used values.
+     *
+     * @param value - Numeric value (string or number)
+     * @returns Cached BigNumber instance
+     *
+     * @example
+     * ```typescript
+     * const a = BigNumberPoolCache.getCached('1000');
+     * const b = BigNumberPoolCache.getCached('1000');
+     * console.log(a === b); // true (same instance)
+     *
+     * const c = BigNumberPoolCache.getCached(1000);
+     * console.log(a === c); // true (number coerced to string key)
+     * ```
+     *
+     * @remarks
+     * - Keys are normalized to strings via `.toString()`
+     * - Cache grows unbounded unless `trimCache()` is called
+     * - O(1) lookup complexity (Map hash table)
+     */
+    static getCached(value: string | number): BigNumber;
+    /**
+     * Clear the entire cache (removes all entries).
+     *
+     * Pre-cached constants (ZERO, ONE, etc.) remain unaffected as they
+     * are static properties, not cache entries.
+     *
+     * @example
+     * ```typescript
+     * BigNumberPoolCache.clearCache();
+     * console.log(BigNumberPoolCache.getCacheStats().size); // 0
+     *
+     * // Constants still work
+     * console.log(BigNumberPoolCache.ZERO.toString()); // "0"
+     * ```
+     *
+     * @remarks
+     * Use sparingly as it discards all cached performance benefits.
+     * Prefer `trimCache()` for periodic memory management.
+     */
+    static clearCache(): void;
+    /**
+     * Get cache statistics for monitoring and debugging.
+     *
+     * @returns Object containing cache size and entry keys
+     *
+     * @example
+     * ```typescript
+     * const stats = BigNumberPoolCache.getCacheStats();
+     * console.log(`Cache size: ${stats.size}`);
+     * console.log(`Keys: ${stats.entries.join(', ')}`);
+     * ```
+     *
+     * @remarks
+     * Useful for performance profiling and memory leak detection.
+     */
+    static getCacheStats(): {
+        size: number;
+        entries: string[];
+    };
+    /**
+     * Trim cache to maximum size (FIFO eviction strategy).
+     *
+     * Keeps the N most recently inserted entries, removes oldest entries.
+     * Designed for long-running processes (arbitrage bots, market makers).
+     *
+     * @param maxSize - Maximum cache entries to retain (default: 1000)
+     *
+     * @example
+     * ```typescript
+     * // Arbitrage bot memory management pattern
+     * let swapCount = 0;
+     * async function executeSwap(params: SwapParams) {
+     *   // ... swap logic using cached BigNumbers ...
+     *
+     *   swapCount++;
+     *   if (swapCount % 100 === 0) {
+     *     BigNumberPoolCache.trimCache(1000); // Keep 1000 hot values
+     *   }
+     * }
+     * ```
+     *
+     * @remarks
+     * - Evicts oldest entries first (Map insertion order preserved)
+     * - Recommended maxSize: 500-2000 for typical trading bots
+     * - Call after every 100-500 operations in hot loops
+     * - Does not affect pre-cached constants
+     */
+    static trimCache(maxSize?: number): void;
+}
+/**
+ * Default export for convenience
+ * @see {@link BigNumberPoolCache}
+ */
+export default BigNumberPoolCache;
+//# sourceMappingURL=bignumber-pool-cache.d.ts.map

package/dist/utils/bignumber-pool-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bignumber-pool-cache.d.ts","sourceRoot":"","sources":["../../src/utils/bignumber-pool-cache.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,cAAc,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,kBAAkB;IAC7B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAElE;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,YAAoB;IAExC;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,YAAoB;IAEvC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,YAA0B;IAElD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,cAAc,YAA+B;IAE7D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,cAAc,YAE5B;IAEF;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAUnD;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAIzB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;IAO3D;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,GAAE,MAAa,GAAG,IAAI;CAU/C;AAED;;;GAGG;AACH,eAAe,kBAAkB,CAAC"}

package/dist/utils/composite-pool-converter.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Composite Pool Data Converter
+ *
+ * Converts raw GalaChain GetCompositePool API responses into properly
+ * typed objects with BigNumber conversions for offline calculations.
+ *
+ * Ported from offline-quote-example/quote-local.mjs createCompositePoolDtoFromResponse()
+ *
+ * ## Runtime Validation Strategy for Type Assertions
+ *
+ * This module uses strategic `as any` type assertions to work around dependency
+ * version conflicts between @gala-chain/api and @gala-chain/dex. To mitigate
+ * risks from type assertions, we employ the following validation strategy:
+ *
+ * ### Type Assertion Patterns Used
+ * 1. **TokenBalance Construction** (lines 78-79, 82-83)
+ *    - Assertion: `new TokenBalance(data as any)`
+ *    - Reason: SDK may have different @gala-chain/api version than @gala-chain/dex
+ *    - Runtime Validation: BigNumber.js validates numeric conversions on line 79
+ *
+ * 2. **TickData Property Assignment** (lines 67-72)
+ *    - Assertion: `(tickDataInstance as any).propertyName = value`
+ *    - Reason: TickData constructor only accepts 2 params; properties are set after
+ *    - Runtime Validation: All values are either boolean or BigNumber conversions
+ *
+ * 3. **CompositePoolDto Construction** (lines 87-91)
+ *    - Assertion: `token0Balance as any` and `token1Balance as any`
+ *    - Reason: TokenBalance versions may differ between dependencies
+ *    - Runtime Validation: BigNumber.js automatically validates during conversions
+ *
+ * ### Validation Guarantees
+ * - **Numeric Conversions**: BigNumber.js throws when parsing invalid numbers (NaN checks)
+ * - **Object Construction**: Pool, TickData, TokenBalance throw on constructor errors
+ * - **Property Access**: Type assertions limited to isolated property assignments
+ * - **API Contract**: Response structure validated via TypeScript type inference
+ *
+ * ### When This Strategy Breaks
+ * If API response structure changes or contains unexpected data types, errors
+ * will occur during BigNumber conversion or object construction with clear
+ * error messages indicating what data was invalid.
+ *
+ * @packageDocumentation
+ */
+import { CompositePoolDto } from '@gala-chain/dex';
+import type { GetCompositePoolResponse, CompositePoolDataResult } from '../types/composite-pool.dto';
+/**
+ * Convert GetCompositePool API response to CompositePoolDto
+ *
+ * Critical conversions:
+ * - All numeric string fields → BigNumber
+ * - Raw tick data → TickData instances
+ * - Raw balances → TokenBalance instances
+ *
+ * ## BigNumber Precision Strategy
+ *
+ * All numeric fields are converted to BigNumber.js for arbitrary precision arithmetic.
+ * This is critical for DeFi operations where precision loss causes calculation errors.
+ *
+ * **Key Fields Converted:**
+ * - Pool properties: sqrtPrice, grossPoolLiquidity, liquidity, feeGrowthGlobal0/1, protocolFees, maxLiquidityPerTick
+ * - Tick data: liquidityNet, liquidityGross, feeGrowthOutside0/1
+ * - Token balances: quantity field
+ *
+ * **Precision Characteristics:**
+ * - BigNumber.js maintains arbitrary precision (no floating-point errors)
+ * - Supports numbers beyond JavaScript's safe integer limit (2^53-1)
+ * - Suitable for token amounts with 18+ decimals (GALA, GUSDC, etc.)
+ * - No rounding errors in conversions between formats
+ *
+ * **Use Cases:**
+ * - Bonding curve calculations (exponential formulas)
+ * - Swap quote computations (multiplication/division intensive)
+ * - Tick-based liquidity calculations (high precision required)
+ * - Multi-step DeFi operations (error accumulation must be prevented)
+ *
+ * @param responseData Raw API response data
+ * @returns Fully typed CompositePoolDto with BigNumber conversions
+ * @throws Error if response data is invalid or missing required fields
+ *
+ * @example Offline quote calculation with BigNumber precision
+ * ```typescript
+ * const response = await axios.post(GCP_URL, getCompositePoolDto);
+ * const compositePool = createCompositePoolDtoFromResponse(response.data.Data);
+ *
+ * // All numeric values are BigNumber instances
+ * const sqrtPrice = compositePool.pool.sqrtPrice; // BigNumber - no precision loss
+ * const liquidity = compositePool.pool.liquidity; // BigNumber - preserves full precision
+ *
+ * // Safe calculations without floating-point errors
+ * const calculatedAmount = liquidity.times(sqrtPrice).dividedBy(someNumber);
+ * // Result is still BigNumber with full precision
+ * ```
+ *
+ * @example Accessing pool data safely
+ * ```typescript
+ * const pool = compositePool.pool;
+ *
+ * // All these are BigNumber instances - safe for math operations
+ * console.log(pool.sqrtPrice.toString()); // Full precision string representation
+ * console.log(pool.liquidity.toFixed(0)); // Fixed decimal format
+ * console.log(pool.feeGrowthGlobal0.multipliedBy(2)); // Precise multiplication
+ * ```
+ */
+/**
+ * RUNTIME VALIDATION NOTES:
+ * This function uses `as any` type assertions only where necessary for dependency
+ * compatibility. All type assertions are followed by runtime validation through:
+ * - BigNumber construction (throws on NaN or invalid numbers)
+ * - Object instantiation (Pool, TickData, TokenBalance throw on errors)
+ * - Numeric field assignments (guaranteed via BigNumber.js precision)
+ */
+export declare function createCompositePoolDtoFromResponse(responseData: GetCompositePoolResponse['Data']): CompositePoolDto;
+/**
+ * Wrap CompositePoolDto with additional metadata
+ *
+ * @param compositePoolDto Converted CompositePoolDto
+ * @param rawResponse Raw response data for reference
+ * @returns CompositePoolDataResult with full metadata
+ */
+export declare function wrapCompositePoolData(compositePoolDto: CompositePoolDto, _rawResponse: GetCompositePoolResponse['Data']): CompositePoolDataResult;
+//# sourceMappingURL=composite-pool-converter.d.ts.map

package/dist/utils/composite-pool-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-pool-converter.d.ts","sourceRoot":"","sources":["../../src/utils/composite-pool-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAkB,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAInE,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAErG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,CAChD,YAAY,EAAE,wBAAwB,CAAC,MAAM,CAAC,GAC7C,gBAAgB,CAkElB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,gBAAgB,EAClC,YAAY,EAAE,wBAAwB,CAAC,MAAM,CAAC,GAC7C,uBAAuB,CAWzB"}

package/dist/utils/errors.d.ts

@@ -389,4 +389,90 @@ export declare class GSwapPositionError extends Error {
      */
     constructor(message: string, originalError: unknown, code?: string | undefined);
 }
+/**
+ * Error thrown when DEX quote operations fail
+ *
+ * This error is thrown during DEX quote calculations (local and external),
+ * composite pool data fetching, and related operations. It captures the
+ * operation context for debugging and recovery.
+ *
+ * @example Quote calculation failure
+ * ```typescript
+ * throw new DexQuoteError(
+ *   'Failed to calculate quote for GALA/BENE swap',
+ *   {
+ *     fromToken: 'GALA|Unit|none|none',
+ *     toToken: 'Token|Unit|BENE|client:123',
+ *     amount: '1000'
+ *   }
+ * );
+ * ```
+ *
+ * @example Catching quote errors
+ * ```typescript
+ * try {
+ *   const quote = await sdk.calculateDexPoolQuoteExactAmountLocal({
+ *     compositePoolData: composite,
+ *     fromToken: 'GALA|Unit|none|none',
+ *     toToken: 'Token|Unit|BENE|client:123',
+ *     amount: '1000'
+ *   });
+ * } catch (error) {
+ *   if (error instanceof DexQuoteError) {
+ *     console.log(`Quote failed: ${error.message}`);
+ *     if (error.context) {
+ *       console.log(`Tokens: ${error.context.fromToken} → ${error.context.toToken}`);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class DexQuoteError extends ValidationError {
+    context?: any | undefined;
+    /**
+     * Creates a new DexQuoteError
+     *
+     * @param message - Human-readable error message describing what failed
+     * @param context - Optional context object with operation details (tokens, amounts, etc.)
+     */
+    constructor(message: string, context?: any | undefined);
+}
+/**
+ * Error thrown when a DEX pool is not found
+ *
+ * This error is thrown when attempting to access or fetch data for a DEX pool
+ * that does not exist, typically during composite pool data retrieval or pool
+ * discovery operations.
+ *
+ * @example Pool not found
+ * ```typescript
+ * throw new DexPoolNotFoundError(
+ *   'Pool not found: GALA/BENE with fee 3000'
+ * );
+ * ```
+ *
+ * @example Catching pool not found errors
+ * ```typescript
+ * try {
+ *   const composite = await sdk.fetchCompositePoolData({
+ *     token0: 'GALA|Unit|none|none',
+ *     token1: 'Token|Unit|BENE|client:123',
+ *     fee: 3000
+ *   });
+ * } catch (error) {
+ *   if (error instanceof DexPoolNotFoundError) {
+ *     console.log('Pool does not exist. Create it first with liquidity.');
+ *     // Implement pool creation or alternative routing
+ *   }
+ * }
+ * ```
+ */
+export declare class DexPoolNotFoundError extends ValidationError {
+    /**
+     * Creates a new DexPoolNotFoundError
+     *
+     * @param message - Human-readable error message describing which pool was not found
+     */
+    constructor(message: string);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

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

package/dist/utils/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAiB,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE1E,OAAO,EAAiB,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,oBAAoB,CAAqB;IACjD,OAAO,CAAC,qBAAqB,CAAqB;gBAEtC,IAAI,EAAE,aAAa,EAAE,MAAM,GAAE,SAAc;IAkBvD;;;;;OAKG;IACG,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAoDzD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EACf,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IASb;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IASb;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EACf,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IASb;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,GAAG,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IASb;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IASb;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnD;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;;;OAMG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IAyB3E;;;OAGG;IACG,iBAAiB,CAAC,CAAC,SAAS,MAAM,EACtC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,CAAC,EACN,WAAW,GAAE,WAAyC,GACrD,OAAO,CACR,CAAC,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,CACrF;IAaD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgFzB;;;OAGG;IACH,OAAO,IAAI,IAAI;CAahB"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"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"}

package/dist/utils/load-env.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Environment variable loader that checks both root and local .env files
+ * Useful for demo scripts and CLI tools that need wallet configuration
+ */
+/**
+ * Load environment variables from root .env and local .env files
+ * Root .env is loaded first, then local .env (local overrides root)
+ *
+ * Usage in demo scripts:
+ * ```typescript
+ * import { loadEnvWithFallback } from '../src/utils/load-env';
+ *
+ * loadEnvWithFallback();
+ *
+ * const privateKey = process.env.WALLET_PRIVATE_KEY;
+ * if (!privateKey) {
+ *   throw new Error('WALLET_PRIVATE_KEY not set in root or local .env');
+ * }
+ * ```
+ */
+export declare function loadEnvWithFallback(): void;
+/**
+ * Get a specific environment variable with detailed error message
+ * Checks both root and local .env files
+ */
+export declare function getEnvOrThrow(varName: string, context?: string): string;
+/**
+ * Get environment variable with optional default
+ */
+export declare function getEnv(varName: string, defaultValue?: string): string | undefined;
+//# sourceMappingURL=load-env.d.ts.map

package/dist/utils/load-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.d.ts","sourceRoot":"","sources":["../../src/utils/load-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAY1C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CASvE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjF"}

package/dist/utils/pool-pair-parser.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Pool Pair Parser
+ *
+ * Utilities for parsing poolPair strings from DEX pool discovery into components
+ * and converting pipe-delimited token formats to TypeClass objects.
+ *
+ * @packageDocumentation
+ */
+import type { TokenClassKey } from '../types/common';
+/**
+ * Parse poolPair string from fetchDexPools() into token0, token1, and fee components
+ *
+ * Format: "token0/token1/fee"
+ * Example: "GALA|Unit|none|none/Token|Unit|BENE|client:5c806869e7fd0e2384461ce9/3000"
+ *
+ * Each token is in pipe-delimited format: "collection|category|type|additionalKey"
+ *
+ * @param poolPair Pool pair string from fetchDexPools() result
+ * @returns Object with token0, token1 (both in pipe-delimited format), and fee tier
+ * @throws Error if poolPair format is invalid
+ *
+ * @example
+ * ```typescript
+ * const { token0, token1, fee } = parsePoolPair(
+ *   'GALA|Unit|none|none/Token|Unit|BENE|client:123/3000'
+ * );
+ * // → { token0: 'GALA|Unit|none|none', token1: 'Token|Unit|BENE|client:123', fee: 3000 }
+ * ```
+ */
+export declare function parsePoolPair(poolPair: string): {
+    token0: string;
+    token1: string;
+    fee: number;
+};
+/**
+ * Convert pipe-delimited token string to TokenClassKey object
+ *
+ * Format: "collection|category|type|additionalKey"
+ * Example: "GALA|Unit|none|none" or "Token|Unit|BENE|client:5c806869e7fd0e2384461ce9"
+ *
+ * @param pipeDelimitedToken Token string in pipe-delimited format
+ * @returns TokenClassKey object with all components
+ * @throws Error if token format is invalid
+ *
+ * @example
+ * ```typescript
+ * const tokenClass = pipeDelimitedToTokenClassKey('GALA|Unit|none|none');
+ * // → { collection: 'GALA', category: 'Unit', type: 'none', additionalKey: 'none' }
+ *
+ * const tokenClass2 = pipeDelimitedToTokenClassKey('Token|Unit|BENE|client:123');
+ * // → { collection: 'Token', category: 'Unit', type: 'BENE', additionalKey: 'client:123' }
+ * ```
+ */
+export declare function pipeDelimitedToTokenClassKey(pipeDelimitedToken: string): TokenClassKey;
+//# sourceMappingURL=pool-pair-parser.d.ts.map

package/dist/utils/pool-pair-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-pair-parser.d.ts","sourceRoot":"","sources":["../../src/utils/pool-pair-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,CA2CA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,4BAA4B,CAAC,kBAAkB,EAAE,MAAM,GAAG,aAAa,CAyCtF"}