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

package/dist/examples/utils/demo-registry.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Demo Registry - Central registry mapping all demos to SDK methods and API endpoints
+ *
+ * This module provides types and utilities for the demo registry system,
+ * enabling demo discovery, SDK method mapping, and backend endpoint tracking.
+ *
+ * @since 5.14.0
+ */
+/**
+ * Entry in the demo registry mapping a demo to SDK methods and API endpoints
+ */
+export interface DemoRegistryEntry {
+    /** Unique identifier for the demo (e.g., "liquidity-portfolio") */
+    id: string;
+    /** Display name for the demo (e.g., "Multi-Position Portfolio") */
+    name: string;
+    /** Category the demo belongs to (e.g., "liquidity", "dex", "core") */
+    category: string;
+    /** Relative path to the demo file (e.g., "examples/liquidity/multi-position.ts") */
+    scriptPath: string;
+    /** npm script name (e.g., "demo:liquidity:portfolio") */
+    npmScript: string;
+    /** Description of what the demo demonstrates */
+    description: string;
+    /** SDK methods used in this demo (e.g., ["addSwapLiquidity", "getSwapUserLiquidityPositions"]) */
+    sdkMethods: string[];
+    /** Backend API endpoints called (e.g., ["POST /v1/swap/liquidity/positions"]) */
+    backendEndpoints: string[];
+    /** Estimated execution time (e.g., "2-3 min") */
+    estimatedTime: string;
+    /** Whether the demo requires JWT authentication */
+    requiresAuth: boolean;
+    /** Whether the demo requires a private key / wallet */
+    requiresWallet: boolean;
+    /** Searchable tags (e.g., ["trading", "liquidity", "positions"]) */
+    tags: string[];
+    /** When this demo was last verified/updated */
+    lastVerified?: string;
+    /** Optional notes or special considerations */
+    notes?: string;
+}
+/**
+ * Complete demo registry containing all registered demos
+ */
+export interface DemoRegistry {
+    /** Version of the registry format */
+    version: string;
+    /** Timestamp when registry was generated */
+    generatedAt: string;
+    /** Total number of demos in registry */
+    totalDemos: number;
+    /** All registered demo entries */
+    entries: DemoRegistryEntry[];
+    /** Demo categories with their demo counts */
+    categories: Record<string, number>;
+}
+/**
+ * Load demo registry from JSON file
+ *
+ * @param registryPath - Path to demo-registry.json
+ * @returns Parsed demo registry
+ * @throws If registry file not found or invalid JSON
+ */
+export declare function loadRegistry(registryPath: string): DemoRegistry;
+/**
+ * Save demo registry to JSON file
+ *
+ * @param registry - Registry to save
+ * @param registryPath - Path to save to
+ */
+export declare function saveRegistry(registry: DemoRegistry, registryPath: string): void;
+/**
+ * Find demos by SDK method name
+ *
+ * @param registry - Demo registry
+ * @param methodName - SDK method name to search for
+ * @returns Demos that use the specified SDK method
+ */
+export declare function findDemosBySDKMethod(registry: DemoRegistry, methodName: string): DemoRegistryEntry[];
+/**
+ * Find demos by backend endpoint
+ *
+ * @param registry - Demo registry
+ * @param endpoint - Endpoint pattern to search for (e.g., "/v1/swap")
+ * @returns Demos that call the specified endpoint
+ */
+export declare function findDemosByEndpoint(registry: DemoRegistry, endpoint: string): DemoRegistryEntry[];
+/**
+ * Find demos by category
+ *
+ * @param registry - Demo registry
+ * @param category - Category name
+ * @returns Demos in the specified category
+ */
+export declare function findDemosByCategory(registry: DemoRegistry, category: string): DemoRegistryEntry[];
+/**
+ * Find demos by tag
+ *
+ * @param registry - Demo registry
+ * @param tag - Tag to search for
+ * @returns Demos with the specified tag
+ */
+export declare function findDemosByTag(registry: DemoRegistry, tag: string): DemoRegistryEntry[];
+/**
+ * Find demos by search term (searches across name, description, and tags)
+ *
+ * @param registry - Demo registry
+ * @param searchTerm - Term to search for
+ * @returns Demos matching the search term
+ */
+export declare function searchDemos(registry: DemoRegistry, searchTerm: string): DemoRegistryEntry[];
+/**
+ * Get all demos for a specific category
+ *
+ * @param registry - Demo registry
+ * @param category - Category name
+ * @returns Array of demos in the category
+ */
+export declare function getDemosInCategory(registry: DemoRegistry, category: string): DemoRegistryEntry[];
+/**
+ * Get all unique SDK methods covered by demos
+ *
+ * @param registry - Demo registry
+ * @returns Set of all SDK methods referenced
+ */
+export declare function getAllSDKMethods(registry: DemoRegistry): Set<string>;
+/**
+ * Get all unique backend endpoints covered by demos
+ *
+ * @param registry - Demo registry
+ * @returns Set of all backend endpoints referenced
+ */
+export declare function getAllEndpoints(registry: DemoRegistry): Set<string>;
+/**
+ * Get demo by ID
+ *
+ * @param registry - Demo registry
+ * @param demoId - Demo ID to find
+ * @returns The demo entry, or undefined if not found
+ */
+export declare function getDemoById(registry: DemoRegistry, demoId: string): DemoRegistryEntry | undefined;
+/**
+ * Validate registry completeness and consistency
+ *
+ * @param registry - Demo registry to validate
+ * @returns Array of validation errors (empty if valid)
+ */
+export declare function validateRegistry(registry: DemoRegistry): string[];
+/**
+ * Get registry path relative to SDK root
+ *
+ * @returns Path to demo-registry.json
+ */
+export declare function getRegistryPath(): string;
+//# sourceMappingURL=demo-registry.d.ts.map

package/dist/examples/utils/demo-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-registry.d.ts","sourceRoot":"","sources":["../../../examples/utils/demo-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IAEX,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IAEb,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IAEjB,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;IAEnB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAElB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IAEpB,kGAAkG;IAClG,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB,iFAAiF;IACjF,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IAEtB,mDAAmD;IACnD,YAAY,EAAE,OAAO,CAAC;IAEtB,uDAAuD;IACvD,cAAc,EAAE,OAAO,CAAC;IAExB,oEAAoE;IACpE,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAEhB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAE7B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAO/D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAE/E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAIpG;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAIjG;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAIjG;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAIvF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAU3F;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAEhG;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAMpE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAMnE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEjG;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAiDjE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAMxC"}

package/dist/examples/utils/error-handler.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Shared Error Handling Utilities for Examples
+ *
+ * Provides consistent error message extraction and logging across all demo scripts.
+ * Eliminates the duplicated `error instanceof Error ? error.message : String(error)` pattern.
+ *
+ * @example
+ * ```typescript
+ * import { formatErrorMessage, logError } from '../utils/error-handler';
+ *
+ * try {
+ *   await sdk.buy({ ... });
+ * } catch (error: unknown) {
+ *   logError(error);  // Logs: "Error: <message>"
+ *   logError(error, 'Buy operation failed');  // Logs: "Buy operation failed: <message>"
+ * }
+ *
+ * // Or just get the message
+ * const message = formatErrorMessage(error);
+ * ```
+ *
+ * @since 5.12.0
+ */
+/**
+ * Extract error message from unknown error type.
+ *
+ * Handles the common TypeScript pattern where catch blocks receive `unknown` type.
+ * Safely extracts the message from Error instances or converts other values to string.
+ *
+ * @param error - The caught error of unknown type
+ * @returns The error message as a string
+ *
+ * @example
+ * ```typescript
+ * catch (error: unknown) {
+ *   console.log('Failed:', formatErrorMessage(error));
+ * }
+ * ```
+ */
+export declare function formatErrorMessage(error: unknown): string;
+/**
+ * Log an error with consistent formatting.
+ *
+ * Uses the standard error emoji prefix for visual consistency across demos.
+ *
+ * @param error - The caught error of unknown type
+ * @param prefix - Optional prefix (default: 'Error')
+ *
+ * @example
+ * ```typescript
+ * catch (error: unknown) {
+ *   logError(error);  // Output: "\n❌ Error: <message>"
+ *   logError(error, 'Failed to buy tokens');  // Output: "\n❌ Failed to buy tokens: <message>"
+ * }
+ * ```
+ */
+export declare function logError(error: unknown, prefix?: string): void;
+/**
+ * Check if an error is a Launchpad API error with specific status code.
+ *
+ * Useful for handling specific API errors like 404 (not found) or 401 (unauthorized).
+ *
+ * **Note:** This uses duck-typing intentionally rather than importing SDK error classes.
+ * Demo utilities are designed to work with any error shape, avoiding tight coupling to
+ * specific SDK error class implementations. This makes the error handling resilient to
+ * SDK error class changes and works correctly whether errors come from SDK, axios, or
+ * other sources.
+ *
+ * @param error - The caught error of unknown type
+ * @param statusCode - The HTTP status code to check for
+ * @returns True if the error is a Launchpad API error with the specified status code
+ *
+ * @example
+ * ```typescript
+ * catch (error: unknown) {
+ *   if (isLaunchpadError(error, 404)) {
+ *     log.info('Resource not found - this is expected');
+ *   } else {
+ *     logError(error);
+ *   }
+ * }
+ * ```
+ */
+export declare function isLaunchpadError(error: unknown, statusCode: number): boolean;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/examples/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../examples/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,MAAgB,GAAG,IAAI,CAEvE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAuB5E"}

package/dist/examples/utils/formatting.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Formatting Utilities for Examples
+ *
+ * Provides consistent table and data formatting across all demo scripts.
+ * Eliminates duplicated formatting logic and ensures visual consistency.
+ *
+ * @example Table formatting
+ * ```typescript
+ * import { formatTable, formatBalance } from '../utils/formatting';
+ *
+ * const rows = [
+ *   { token: 'GALA', balance: '1000.5', price: '$0.05' },
+ *   { token: 'GUSDC', balance: '500.25', price: '$1.00' }
+ * ];
+ * formatTable(rows);
+ *
+ * // Format individual values
+ * const galaBalance = formatBalance('1234567.89', 8); // "1.23M GALA"
+ * ```
+ *
+ * @since 5.13.0
+ */
+/**
+ * Format large numbers with human-readable units (K, M, B, T).
+ *
+ * Automatically scales numbers to the appropriate unit for readability.
+ *
+ * @param value - Number as string or number
+ * @param decimals - Decimal places to show (default: 2)
+ * @param unit - Optional unit suffix (default: empty)
+ * @returns Formatted string (e.g., "1.23M", "4.56K tokens")
+ *
+ * @example
+ * ```typescript
+ * formatNumber('1234567'); // "1.23M"
+ * formatNumber('4567', 0); // "5K"
+ * formatNumber('999'); // "999"
+ * formatNumber('1000000000', 1, 'tokens'); // "1.0B tokens"
+ * ```
+ */
+export declare function formatNumber(value: string | number, decimals?: number, unit?: string): string;
+/**
+ * Format token balance with appropriate decimals.
+ *
+ * Handles large balances with smart decimal reduction.
+ *
+ * @param balance - Balance as string or number
+ * @param tokenDecimals - Token decimal places (default: 8 for GALA)
+ * @returns Formatted balance string (e.g., "1.23M", "456.78K")
+ *
+ * @example
+ * ```typescript
+ * formatBalance('1000000000'); // "1.00B" (for GALA with 8 decimals)
+ * formatBalance('500.25'); // "500.25"
+ * formatBalance('123456789', 6); // "123.46M"
+ * ```
+ */
+export declare function formatBalance(balance: string | number, _tokenDecimals?: number): string;
+/**
+ * Format percentage value with % symbol.
+ *
+ * @param value - Percentage value (0-100)
+ * @param decimals - Decimal places (default: 2)
+ * @returns Formatted percentage (e.g., "12.34%")
+ *
+ * @example
+ * ```typescript
+ * formatPercent('12.3456'); // "12.35%"
+ * formatPercent('0.005', 3); // "0.005%"
+ * formatPercent('99.9'); // "99.90%"
+ * ```
+ */
+export declare function formatPercent(value: string | number, decimals?: number): string;
+/**
+ * Format price with currency symbol.
+ *
+ * @param price - Price value
+ * @param currency - Currency symbol (default: '$')
+ * @param decimals - Decimal places (default: 2)
+ * @returns Formatted price (e.g., "$12.34")
+ *
+ * @example
+ * ```typescript
+ * formatPrice('12.3456'); // "$12.35"
+ * formatPrice('0.0005', '$', 4); // "$0.0005"
+ * formatPrice('1234', '€'); // "€1234.00"
+ * ```
+ */
+export declare function formatPrice(price: string | number, currency?: string, decimals?: number): string;
+/**
+ * Format duration in seconds to human-readable format.
+ *
+ * @param seconds - Duration in seconds
+ * @returns Formatted duration (e.g., "1h 23m 45s", "15s")
+ *
+ * @example
+ * ```typescript
+ * formatDuration(45); // "45s"
+ * formatDuration(125); // "2m 5s"
+ * formatDuration(3665); // "1h 1m 5s"
+ * ```
+ */
+export declare function formatDuration(seconds: number): string;
+/**
+ * Format wallet address to shortened format.
+ *
+ * Shows first and last 6 characters with ... in between.
+ *
+ * @param address - Full wallet address
+ * @returns Shortened address (e.g., "eth|0x...a1b2c3")
+ *
+ * @example
+ * ```typescript
+ * formatAddress('eth|0x123456789abcdef0123456789abcdef01234567');
+ * // "eth|0x...34567"
+ * ```
+ */
+export declare function formatAddress(address: string): string;
+/**
+ * Format transaction ID to shortened format for display.
+ *
+ * Shows first and last 8 characters.
+ *
+ * @param txId - Full transaction ID
+ * @returns Shortened transaction ID (e.g., "a1b2c3d...1a2b3c4d")
+ *
+ * @example
+ * ```typescript
+ * formatTxId('abc123def456ghi789jkl012mno345pqr678stu');
+ * // "abc123de...12mno345"
+ * ```
+ */
+export declare function formatTxId(txId: string): string;
+/**
+ * Format table data for console output.
+ *
+ * Displays data as a formatted table using console.table.
+ *
+ * @param data - Array of objects to display as table
+ * @param title - Optional title to display before table
+ *
+ * @example
+ * ```typescript
+ * const pools = [
+ *   { name: 'GALA/GUSDC', tvl: '1.5M', apy: '12.5%' },
+ *   { name: 'GUSDC/GWETH', tvl: '800K', apy: '8.2%' }
+ * ];
+ * formatTable(pools, 'Top Liquidity Pools');
+ * ```
+ */
+export declare function formatTable(data: Record<string, unknown>[], title?: string): void;
+/**
+ * Format key-value pairs for readable output.
+ *
+ * Displays related data in a labeled key-value format.
+ *
+ * @param data - Object with keys and values to display
+ * @param title - Optional title to display before data
+ *
+ * @example
+ * ```typescript
+ * formatKeyValues({
+ *   'Pool': 'GALA/GUSDC',
+ *   'TVL': '$1.5M',
+ *   'Volume (24h)': '$500K',
+ *   'APY': '12.5%'
+ * }, 'Pool Metrics');
+ * ```
+ */
+export declare function formatKeyValues(data: Record<string, string | number | boolean>, title?: string): void;
+/**
+ * Create a comparison table for two sets of values.
+ *
+ * Useful for comparing results from different sources (e.g., local vs external calculations).
+ *
+ * @param label1 - First source label
+ * @param value1 - First value
+ * @param label2 - Second source label
+ * @param value2 - Second value
+ * @param formatFn - Optional formatter function (default: identity)
+ *
+ * @example
+ * ```typescript
+ * formatComparison(
+ *   'Local', '1000.123456',
+ *   'External', '1000.123457',
+ *   formatNumber
+ * );
+ * // Outputs:
+ * // Local:    1.00K
+ * // External: 1.00K
+ * ```
+ */
+export declare function formatComparison(label1: string, value1: string | number, label2: string, value2: string | number, formatFn?: (v: string | number) => string): void;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/examples/utils/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../../examples/utils/formatting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,GAAE,MAAU,EACpB,IAAI,GAAE,MAAW,GAChB,MAAM,CA2BR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,cAAc,GAAE,MAAU,GAAG,MAAM,CAa1F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAIlF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,GAAE,MAAY,EACtB,QAAQ,GAAE,MAAU,GACnB,MAAM,CAIR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAatD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CASN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAC/C,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAYN;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,GACxC,IAAI,CAcN"}

package/dist/examples/utils/get-environment.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared utility for reading ENVIRONMENT from .env
+ * Used by all demo scripts and examples
+ */
+import './load-env';
+type EnvironmentType = 'PROD' | 'STAGE';
+/**
+ * Get environment from .env with validation
+ * @returns 'PROD' or 'STAGE' (defaults to STAGE if not set)
+ */
+export declare function getEnvironment(): EnvironmentType;
+/**
+ * Type guard for environment values
+ */
+export declare function isValidEnvironment(value: unknown): value is EnvironmentType;
+export {};
+//# sourceMappingURL=get-environment.d.ts.map

package/dist/examples/utils/get-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-environment.d.ts","sourceRoot":"","sources":["../../../examples/utils/get-environment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,YAAY,CAAC;AAEpB,KAAK,eAAe,GAAG,MAAM,GAAG,OAAO,CAAC;AAExC;;;GAGG;AACH,wBAAgB,cAAc,IAAI,eAAe,CAqBhD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE3E"}

package/dist/examples/utils/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shared Utilities Index
+ *
+ * Centralized export of all demo utilities for convenient importing.
+ *
+ * @example Import everything
+ * ```typescript
+ * import {
+ *   log,
+ *   setupAuthenticatedSDK,
+ *   waitForTransaction,
+ *   generateTestTokenName,
+ *   formatBalance,
+ *   checkGalaBalance,
+ *   wrapAuthenticatedDemo,
+ * } from '../utils';
+ * ```
+ *
+ * @example Import specific utilities
+ * ```typescript
+ * import { log } from '../utils';
+ * import { waitForTransaction, waitForBackendIndexing } from '../utils';
+ * import { generateTestTokenPair } from '../utils';
+ * ```
+ *
+ * @since 5.13.0
+ */
+export { log, type Logger } from './logger';
+export { type DemoFunction, type DemoSetupOptions, type DemoSetupResult, requirePrivateKey, runIfMain, setupAuthenticatedDemoSDK, setupAuthenticatedSDK, setupDemoSDK, setupReadOnlyDemoSDK, setupReadOnlySDK, setupSDK, type SetupSDKOptions, type SetupSDKResult, setupStreamingSDK, wrapAuthenticatedDemo, wrapDemoFunction, type WrapDemoOptions, type WrappedDemoFunction, wrapReadOnlyDemo, } from './sdk-setup';
+export { formatErrorMessage, isLaunchpadError, logError, } from './error-handler';
+export { delay, } from './indexing';
+export { waitForBackendIndexing, waitForTransaction, } from './transaction-helpers';
+export { generateTestSymbol, generateTestTokenName, generateTestTokenPair, isValidTokenName, isValidTokenSymbol, } from './token-naming';
+export { formatAddress, formatBalance, formatComparison, formatDuration, formatKeyValues, formatNumber, formatPercent, formatPrice, formatTable, formatTxId, } from './formatting';
+export { type BalanceCheckResult, checkGalaBalance, checkMultipleBalances, checkTokenBalance, requireGalaBalance, requireTokenBalance, } from './balance-checking';
+export { getEnvironment, isValidEnvironment, } from './get-environment';
+export { type DemoConfig, formatDemoConfig, getDemoConfig, shouldSkipWriteOps, } from './demo-config';
+export { type BuyOptions, type BuyResult, executeBuy, executeRoundTrip, executeSell, FeeTracker, type SellOptions, type SellResult, } from './trade-helpers';
+export { calculatePoolStats, displayPoolDetails, displayPoolMetrics, displayPoolStats, ensurePool, type ExtendedPoolData, findActivePool, findActivePools, findPoolByTVL, findPools, findRandomPool, type PoolSelectionCriteria, requirePool, } from './pool-helpers';
+export { type BridgeConfig, type BridgeSetupResult, deriveEthereumAddress, deriveGalaChainAddress, getBridgeConfig, setupBridgeService, setupReadOnlyBridgeService, validateBridgeRequirements, } from './bridge-setup';
+export { displayBridgeConfig, displayBridgeFee, displayBridgeFollowUp, displayBridgeProcessInfo, displayBridgeStatus, displayBridgeWarnings, displayRoundtripSummary, displayTransactionResult, formatBridgeDuration, } from './bridge-formatters';
+export { envFileExists, getEnvPath, loadEnvFromRoot, } from './load-env';
+export { clearBootstrapCache, ensureModeratorAccess, ensureOverseerAccess, ensureStreamingAccess, hasAdminApiKey, } from './auth-bootstrap';
+//# sourceMappingURL=index.d.ts.map

package/dist/examples/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../examples/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,GAAG,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,iBAAiB,EAEjB,SAAS,EACT,yBAAyB,EACzB,qBAAqB,EAErB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,iBAAiB,EACjB,qBAAqB,EAErB,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,KAAK,GACN,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,cAAc,EACd,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,KAAK,UAAU,EACf,gBAAgB,EAChB,aAAa,EACb,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,KAAK,gBAAgB,EACrB,cAAc,EACd,eAAe,EACf,aAAa,EACb,SAAS,EACT,cAAc,EACd,KAAK,qBAAqB,EAC1B,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,aAAa,EACb,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,GACf,MAAM,kBAAkB,CAAC"}

package/dist/examples/utils/indexing.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Blockchain Indexing Utilities for Examples
+ *
+ * This file now only provides the general-purpose `delay()` utility.
+ * All blockchain indexing/transaction confirmation functions have been removed in favor of
+ * the new WebSocket-based transaction confirmation pattern.
+ *
+ * ✅ RECOMMENDED PATTERN (NEW):
+ * Import from transaction-helpers.ts instead:
+ * - waitForTransaction() - Real-time WebSocket confirmation
+ * - waitForBackendIndexing() - Optimized backend sync
+ *
+ * @example Modern pattern (recommended)
+ * ```typescript
+ * import { waitForTransaction, waitForBackendIndexing } from './transaction-helpers';
+ *
+ * const result = await sdk.launchToken({ ... });
+ * await waitForTransaction(result, 'token creation');    // Real-time (2-5s)
+ * await waitForBackendIndexing(5000, 'pool indexing');   // Backend sync (5s)
+ * ```
+ *
+ * @since 5.13.0
+ */
+/**
+ * Simple delay utility for short pauses between operations.
+ *
+ * Use this for brief pauses that don't need logging, such as:
+ * - Small delays between consecutive trades
+ * - Brief pauses to avoid rate limiting
+ * - Short waits between API calls
+ *
+ * For transaction confirmation, use `waitForTransaction()` or `waitForBackendIndexing()` from transaction-helpers.ts.
+ *
+ * @param ms - Delay in milliseconds
+ * @returns Promise that resolves after the specified delay
+ *
+ * @example
+ * ```typescript
+ * // Wait 1 second between trades
+ * await sdk.executeSwap(...);
+ * await delay(1000);
+ * await sdk.executeSwap(...);
+ * ```
+ *
+ * @since 5.17.0
+ */
+export declare function delay(ms: number): Promise<void>;
+//# sourceMappingURL=indexing.d.ts.map

package/dist/examples/utils/indexing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexing.d.ts","sourceRoot":"","sources":["../../../examples/utils/indexing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErD"}

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

@@ -0,0 +1,90 @@
+/**
+ * Centralized Environment Loading Utility
+ *
+ * Provides a single, consistent way to load the .env file from the repository root.
+ * This eliminates duplicate path.resolve calculations across demo files.
+ *
+ * **Path Resolution:**
+ * - From `packages/sdk/examples/utils/` to repo root `.env`
+ * - Goes up 4 directories: utils -> examples -> sdk -> packages -> root
+ *
+ * **Usage:**
+ * ```typescript
+ * // Option 1: Import side-effect (loads .env immediately on import)
+ * import '../utils/load-env';
+ *
+ * // Option 2: Import and call explicitly
+ * import { loadEnvFromRoot } from '../utils/load-env';
+ * loadEnvFromRoot();
+ *
+ * // Option 3: Get env path for custom handling
+ * import { getEnvPath } from '../utils/load-env';
+ * console.log('Env file at:', getEnvPath());
+ * ```
+ *
+ * @since 5.16.0
+ */
+/**
+ * Get the absolute path to the .env file at the repository root.
+ *
+ * @returns Absolute path to .env file
+ *
+ * @example
+ * ```typescript
+ * import { getEnvPath } from '../utils/load-env';
+ * console.log('Loading env from:', getEnvPath());
+ * // Output: /home/user/project/.env
+ * ```
+ */
+export declare function getEnvPath(): string;
+/**
+ * Check if the .env file exists at the repository root.
+ *
+ * @returns true if .env file exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { envFileExists } from '../utils/load-env';
+ * if (!envFileExists()) {
+ *   console.warn('No .env file found - using defaults');
+ * }
+ * ```
+ */
+export declare function envFileExists(): boolean;
+/**
+ * Load environment variables from the repository root .env file.
+ *
+ * This function is idempotent - calling it multiple times has no effect
+ * after the first successful load. This prevents performance issues from
+ * redundant file reads in large demo suites.
+ *
+ * @param options - Optional configuration
+ * @param options.force - Force reload even if already loaded (default: false)
+ * @param options.silent - Suppress warning if file doesn't exist (default: true)
+ * @returns true if .env was loaded, false if skipped or file doesn't exist
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { loadEnvFromRoot } from '../utils/load-env';
+ * loadEnvFromRoot();
+ * // Environment variables are now available
+ * console.log(process.env.WALLET_PRIVATE_KEY);
+ * ```
+ *
+ * @example Force reload
+ * ```typescript
+ * loadEnvFromRoot({ force: true });
+ * ```
+ *
+ * @example With existence check
+ * ```typescript
+ * if (!loadEnvFromRoot()) {
+ *   console.warn('No .env file found');
+ * }
+ * ```
+ */
+export declare function loadEnvFromRoot(options?: {
+    force?: boolean;
+    silent?: boolean;
+}): boolean;
+//# sourceMappingURL=load-env.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.d.ts","sourceRoot":"","sources":["../../../examples/utils/load-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAwBH;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CACb,GAAG,OAAO,CAqBf"}