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

package/dist/examples/utilities/token-metadata-advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metadata-advanced.d.ts","sourceRoot":"","sources":["../../../examples/utilities/token-metadata-advanced.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,2BAA2B,CAAC;AAgInC;;GAEG;AACH,eAAO,MAAM,4BAA4B,wCA6SvC,CAAC"}

package/dist/examples/utilities/token-validation-complete.d.ts

@@ -0,0 +1,41 @@
+#!/usr/bin/env tsx
+/**
+ * Complete Token Validation Workflow Demo
+ *
+ * Demonstrates comprehensive token validation using SDK:
+ * - validateToken: Validate token name and symbol availability
+ * - Check naming rules and availability
+ * - Handle validation errors and edge cases
+ * - Build complete validation workflow
+ *
+ * Shows how to validate tokens before launching them on the platform.
+ *
+ * **Use Cases:**
+ * - Validate token names during token launch workflow
+ * - Check symbol availability before creating tokens
+ * - Build pre-launch validation forms
+ * - Prevent invalid token creation
+ * - Provide user feedback on validation errors
+ * - Implement naming rule enforcement
+ *
+ * @example
+ * ```bash
+ * PRIVATE_KEY=0x... ENVIRONMENT=development npm run demo:utilities:token-validation
+ * ```
+ *
+ * @since 5.14.0
+ */
+import '../utils/suppress-logging';
+/**
+ * Demo metadata for registry
+ */
+export declare const metadata: {
+    id: string;
+    title: string;
+    description: string;
+    category: string;
+    sdkMethods: string[];
+    tags: string[];
+};
+export declare const main: import("../utils").WrappedDemoFunction;
+//# sourceMappingURL=token-validation-complete.d.ts.map

package/dist/examples/utilities/token-validation-complete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-validation-complete.d.ts","sourceRoot":"","sources":["../../../examples/utilities/token-validation-complete.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,2BAA2B,CAAC;AAUnC;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;CASpB,CAAC;AAuQF,eAAO,MAAM,IAAI,wCAAwD,CAAC"}

package/dist/examples/utilities/trade-history.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Trade History Demo
+ *
+ * Demonstrates querying trade history and spot prices for bonding curve tokens.
+ *
+ * Methods demonstrated:
+ * - getTrades(options) - Query trade history with flexible filtering
+ * - fetchTokenPrice({ tokenName }) - Get current token spot price (smart router)
+ *
+ * @example
+ * ```bash
+ * npm run demo:utilities:trade-history
+ * ```
+ *
+ * @since 6.2.0
+ */
+import '../utils/suppress-logging';
+export declare const runMain: import("../utils/sdk-setup").WrappedDemoFunction;
+//# sourceMappingURL=trade-history.d.ts.map

package/dist/examples/utilities/trade-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade-history.d.ts","sourceRoot":"","sources":["../../../examples/utilities/trade-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,2BAA2B,CAAC;AAMnC,eAAO,MAAM,OAAO,kDAmLlB,CAAC"}

package/dist/examples/utilities/transfers.d.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env tsx
+/**
+ * Token Transfer Demo
+ *
+ * Demonstrates the transferToken() method for transferring tokens between wallets.
+ * This is useful for:
+ * - Moving tokens between your own wallets
+ * - Sending tokens to other users
+ * - Distributing tokens to multiple recipients
+ *
+ * Key methods demonstrated:
+ * - sdk.transferToken() - Transfer any token to another wallet
+ * - sdk.getAddress() - Get current wallet address
+ * - sdk.fetchTokenBalance() - Check token balances before/after
+ *
+ * @example
+ * ```bash
+ * # Run with wallet (required for transfers)
+ * WALLET_PRIVATE_KEY=0x... npm run demo:utilities:transfers
+ *
+ * # Transfer specific token and amount
+ * WALLET_PRIVATE_KEY=0x... TOKEN_NAME=anime AMOUNT=10 RECIPIENT=eth|... npm run demo:utilities:transfers
+ * ```
+ *
+ * @since 5.12.0
+ * @category Utilities
+ */
+import '../utils/suppress-logging';
+//# sourceMappingURL=transfers.d.ts.map

package/dist/examples/utilities/transfers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfers.d.ts","sourceRoot":"","sources":["../../../examples/utilities/transfers.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,2BAA2B,CAAC"}

package/dist/examples/utilities/validation-and-error-handling.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env tsx
+/**
+ * Validation and Error Handling Demo
+ *
+ * Demonstrates production-ready validation and error recovery patterns:
+ * - validateToken() - Comprehensive token validation
+ * - Input validation before operations
+ * - Error classification and recovery
+ * - Retry strategies with exponential backoff
+ * - Graceful degradation and fallbacks
+ * - Type-safe error handling
+ * - Detailed error context and logging
+ *
+ * Shows best practices for building robust applications that handle
+ * edge cases, invalid inputs, and transient failures gracefully.
+ *
+ * @example
+ * ```bash
+ * npm run demo:utilities:validation-error-handling
+ * ```
+ *
+ * @since 5.14.0
+ * @category Utilities
+ */
+import '../utils/suppress-logging';
+export declare const runDemo: import("../utils").WrappedDemoFunction;
+//# sourceMappingURL=validation-and-error-handling.d.ts.map

package/dist/examples/utilities/validation-and-error-handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-and-error-handling.d.ts","sourceRoot":"","sources":["../../../examples/utilities/validation-and-error-handling.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,2BAA2B,CAAC;AAkqBnC,eAAO,MAAM,OAAO,wCAAsC,CAAC"}

package/dist/examples/utilities/wrappable-tokens.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env tsx
+/**
+ * Wrappable Token Discovery Demo
+ *
+ * Demonstrates the wrappable token fetching methods that retrieve
+ * tokens which can be wrapped/unwrapped (e.g., MUSIC <-> GMUSIC).
+ *
+ * This demo showcases:
+ * - Fetching all wrappable tokens from DEX API
+ * - Checking if specific tokens are wrappable by tokenId
+ * - Finding wrap counterparts (MUSIC -> GMUSIC, GMUSIC -> MUSIC)
+ * - Cache efficiency (second calls use cached data)
+ * - User-specific queries with balance data
+ *
+ * Key Concept: Wrappable tokens are pairs where one can be wrapped
+ * into the other. For example:
+ * - $MUSIC|Unit|none|none <-> Token|Unit|GMUSIC|none
+ * - The "wrap" field on each token points to its counterpart
+ *
+ * Run with: npm run demo:utilities:wrappable-tokens
+ */
+import '../utils/suppress-logging';
+/**
+ * Run wrappable token discovery demo
+ */
+export declare const runWrappableTokensDemo: import("../utils").WrappedDemoFunction;
+//# sourceMappingURL=wrappable-tokens.d.ts.map

package/dist/examples/utilities/wrappable-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrappable-tokens.d.ts","sourceRoot":"","sources":["../../../examples/utilities/wrappable-tokens.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,2BAA2B,CAAC;AAKnC;;GAEG;AACH,eAAO,MAAM,sBAAsB,wCAgOjC,CAAC"}

package/dist/examples/utility/auth-utilities.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env tsx
+/**
+ * Authentication Utilities Demo
+ *
+ * Demonstrates JWT token management and authentication helpers:
+ * - ensureValidToken() - Ensure access token is valid, refresh if needed
+ * - getAccessToken() - Get current access token
+ * - shouldRefreshToken() - Check if token should be refreshed
+ *
+ * This is useful for:
+ * - Managing JWT token lifecycle
+ * - Preventing token expiry during operations
+ * - Implementing automatic token refresh
+ * - Monitoring authentication status
+ * - Building reliable authentication flows
+ *
+ * @example
+ * ```bash
+ * # Run with authenticated session
+ * npm run demo:utility:auth-utilities
+ *
+ * # Set custom refresh threshold
+ * REFRESH_THRESHOLD_MS=300000 npm run demo:utility:auth-utilities
+ * ```
+ *
+ * @since 6.0.0
+ * @category Utility
+ */
+import '../utils/suppress-logging';
+//# sourceMappingURL=auth-utilities.d.ts.map

package/dist/examples/utility/auth-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-utilities.d.ts","sourceRoot":"","sources":["../../../examples/utility/auth-utilities.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,2BAA2B,CAAC"}

package/dist/examples/utility/pool-utilities.d.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env tsx
+/**
+ * Pool Utilities Demo
+ *
+ * Demonstrates pool discovery and token graduation utilities:
+ * - fetchAllPools() - Fetch all bonding curve pools with auto-pagination
+ * - isTokenGraduated() - Check if token has graduated to DEX
+ *
+ * This is useful for:
+ * - Discovering all available token pools
+ * - Checking token graduation status
+ * - Building pool analytics and dashboards
+ * - Filtering tokens by graduation status
+ * - Analyzing pool distribution and statistics
+ *
+ * @example
+ * ```bash
+ * # Discover all pools
+ * npm run demo:utility:pool-utilities
+ *
+ * # Check specific token graduation
+ * TOKEN_NAME=anime npm run demo:utility:pool-utilities
+ * ```
+ *
+ * @since 6.0.0
+ * @category Utility
+ */
+export declare const runMain: import("../utils/sdk-setup").WrappedDemoFunction;
+//# sourceMappingURL=pool-utilities.d.ts.map

package/dist/examples/utility/pool-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-utilities.d.ts","sourceRoot":"","sources":["../../../examples/utility/pool-utilities.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAaH,eAAO,MAAM,OAAO,kDA2QlB,CAAC"}

package/dist/examples/utility/sdk-configuration.d.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env tsx
+/**
+ * SDK Configuration and Metadata Demo
+ *
+ * Demonstrates SDK configuration and metadata inspection:
+ * - getConfig() - Get current SDK configuration
+ * - getVersion() - Get SDK version information
+ * - getUrlByTokenName() - Resolve API URL for token-specific operations
+ *
+ * This is useful for:
+ * - Verifying SDK setup and configuration
+ * - Getting SDK version for logging/debugging
+ * - Resolving token-specific API endpoints
+ * - Understanding SDK capabilities
+ *
+ * @example
+ * ```bash
+ * # Check SDK configuration
+ * npm run demo:utility:sdk-configuration
+ *
+ * # Get URL for specific token
+ * TOKEN_NAME=anime npm run demo:utility:sdk-configuration
+ * ```
+ *
+ * @since 6.0.0
+ * @category Utility
+ */
+export declare const runMain: import("../utils/sdk-setup").WrappedDemoFunction;
+//# sourceMappingURL=sdk-configuration.d.ts.map

package/dist/examples/utility/sdk-configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-configuration.d.ts","sourceRoot":"","sources":["../../../examples/utility/sdk-configuration.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAYH,eAAO,MAAM,OAAO,kDA8PlB,CAAC"}

package/dist/examples/utility/wallet-management-advanced.d.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env tsx
+/**
+ * Advanced Wallet Management Demo
+ *
+ * Demonstrates advanced wallet operations and state inspection:
+ * - getWallet() - Get the configured wallet instance
+ * - hasWallet() - Check if a wallet is configured
+ * - setWallet() - Configure wallet dynamically
+ * - validateWallet() - Validate wallet configuration
+ * - getEthereumAddress() - Get Ethereum address from wallet
+ *
+ * This is useful for:
+ * - Multi-wallet management and switching
+ * - Wallet validation and health checks
+ * - Runtime wallet configuration
+ * - Address resolution across different formats
+ * - Permission/authorization verification
+ *
+ * @example
+ * ```bash
+ * # Demonstrate wallet operations
+ * npm run demo:utility:wallet-management-advanced
+ *
+ * # Override with specific wallet
+ * WALLET_PRIVATE_KEY=0x... npm run demo:utility:wallet-management-advanced
+ * ```
+ *
+ * @since 6.0.0
+ * @category Utility
+ */
+import '../utils/suppress-logging';
+//# sourceMappingURL=wallet-management-advanced.d.ts.map

package/dist/examples/utility/wallet-management-advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-management-advanced.d.ts","sourceRoot":"","sources":["../../../examples/utility/wallet-management-advanced.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,2BAA2B,CAAC"}

package/dist/examples/utils/auth-bootstrap.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Auth Bootstrap Utilities
+ *
+ * Provides self-bootstrapping for auth-required demos that need
+ * overseer or moderator access. Uses Admin API key to create and
+ * claim overseer/moderator invites automatically.
+ *
+ * **Bootstrap Strategy:**
+ * ```
+ * Admin API Key -> Create Overseer Invite -> Claim with Demo Wallet -> Demo Wallet is Overseer
+ * ```
+ *
+ * **Environment Requirements:**
+ * - `STREAM_ADMIN_API_KEY` - Required for overseer self-bootstrap
+ * - `WALLET_PRIVATE_KEY` - Required for authentication
+ *
+ * @since 8.3.0
+ */
+import type { LaunchpadSDK } from '../../src';
+/**
+ * Check if the STREAM_ADMIN_API_KEY environment variable is set.
+ * This is required for creating overseer invites.
+ *
+ * @returns true if the admin API key is available
+ */
+export declare function hasAdminApiKey(): boolean;
+/**
+ * Ensure the current user has overseer access.
+ *
+ * If already an overseer, returns immediately.
+ * Otherwise, attempts to self-bootstrap by:
+ * 1. Creating an overseer invite using Admin API key
+ * 2. Immediately claiming that invite
+ *
+ * **Caching:** Results are cached per wallet address to avoid
+ * re-bootstrapping in the same session.
+ *
+ * @param sdk - Authenticated LaunchpadSDK instance
+ * @returns true if the user now has overseer access, false if bootstrap failed
+ *
+ * @example
+ * ```typescript
+ * export const runDemo = wrapAuthenticatedDemo(async (sdk) => {
+ *   const hasAccess = await ensureOverseerAccess(sdk);
+ *   if (!hasAccess) {
+ *     log.warn('Skipping demo - requires STREAM_ADMIN_API_KEY for bootstrap');
+ *     return;
+ *   }
+ *
+ *   // ... rest of demo that requires overseer access
+ * });
+ * ```
+ */
+export declare function ensureOverseerAccess(sdk: LaunchpadSDK): Promise<boolean>;
+/**
+ * Ensure the current user has moderator access for a specific token.
+ *
+ * Moderator access requires token ownership. If the user doesn't own
+ * any tokens, this function will return false without creating a token
+ * (to avoid unexpected token launches).
+ *
+ * @param sdk - Authenticated LaunchpadSDK instance
+ * @param tokenName - Optional specific token name to check. If not provided,
+ *                    checks if user owns any tokens.
+ * @returns Object with success status and the token name to use for moderator operations
+ *
+ * @example
+ * ```typescript
+ * export const runDemo = wrapAuthenticatedDemo(async (sdk) => {
+ *   const { success, tokenName } = await ensureModeratorAccess(sdk);
+ *   if (!success) {
+ *     log.warn('Skipping demo - no owned tokens for moderator operations');
+ *     return;
+ *   }
+ *
+ *   // Use tokenName for moderator invite creation
+ *   await sdk.createModeratorInvite({ tokenName, role: 'MODERATOR', ... });
+ * });
+ * ```
+ */
+export declare function ensureModeratorAccess(sdk: LaunchpadSDK, tokenName?: string): Promise<{
+    success: boolean;
+    tokenName: string | null;
+}>;
+/**
+ * Ensure the current user can perform streaming operations on a token.
+ *
+ * Streaming operations require either:
+ * 1. Token ownership (creator)
+ * 2. Moderator/Manager access on the token
+ * 3. Overseer access (global)
+ *
+ * This function checks in order of least privilege:
+ * 1. Token ownership
+ * 2. Moderated tokens (MANAGER/TECHNICAL_PRODUCER role)
+ * 3. Overseer access
+ *
+ * @param sdk - Authenticated LaunchpadSDK instance
+ * @param tokenName - Optional specific token name to check
+ * @returns Object with success status and the token name to use
+ *
+ * @example
+ * ```typescript
+ * const { success, tokenName, accessType } = await ensureStreamingAccess(sdk, 'mytoken');
+ * if (!success) {
+ *   log.warn('No streaming access available');
+ *   return;
+ * }
+ * log.info(`Streaming via ${accessType} on ${tokenName}`);
+ * ```
+ */
+export declare function ensureStreamingAccess(sdk: LaunchpadSDK, tokenName?: string): Promise<{
+    success: boolean;
+    tokenName: string | null;
+    accessType: 'owner' | 'moderator' | 'overseer' | null;
+}>;
+/**
+ * Clear the bootstrap cache.
+ *
+ * Useful for testing or when you need to re-check access status.
+ */
+export declare function clearBootstrapCache(): void;
+//# sourceMappingURL=auth-bootstrap.d.ts.map

package/dist/examples/utils/auth-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-bootstrap.d.ts","sourceRoot":"","sources":["../../../examples/utils/auth-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAM9C;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAGxC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAuD9E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,YAAY,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAgDzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,YAAY,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,CAAA;CAAE,CAAC,CA8DhH;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/examples/utils/balance-checking.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Balance Checking Utilities for Examples
+ *
+ * Provides consistent balance validation and checks before operations.
+ * Eliminates duplicated balance fetch and validation logic.
+ *
+ * @example Check GALA balance before operation
+ * ```typescript
+ * import { checkGalaBalance } from '../utils/balance-checking';
+ *
+ * const balance = await checkGalaBalance(sdk, 100);
+ * if (balance.sufficient != null) {
+ *   // Proceed with operation
+ * } else {
+ *   log.warn(`Need ${balance.required}, have ${balance.actual}`);
+ * }
+ * ```
+ *
+ * @example Check token balance
+ * ```typescript
+ * import { checkTokenBalance } from '../utils/balance-checking';
+ *
+ * const balance = await checkTokenBalance(sdk, 'anime', 1000);
+ * if (!balance.sufficient) {
+ *   log.error(`Insufficient balance`);
+ *   process.exit(1);
+ * }
+ * ```
+ *
+ * @since 5.13.0
+ */
+import type { LaunchpadSDK } from '../../src';
+/**
+ * Result of a balance check operation
+ */
+export interface BalanceCheckResult {
+    /** Whether balance meets the minimum requirement */
+    sufficient: boolean;
+    /** Actual balance in smallest unit */
+    actual: string;
+    /** Required minimum balance */
+    required: string;
+    /** Token decimals (for display formatting) */
+    decimals: number;
+    /** Shortfall amount if insufficient (or '0' if sufficient) */
+    shortfall: string;
+}
+/**
+ * Check GALA balance before operation.
+ *
+ * GALA is the native token with 8 decimals.
+ *
+ * @param sdk - Configured LaunchpadSDK instance
+ * @param minimumRequired - Minimum GALA amount required (in atomic units)
+ * @param silent - Skip logging (default: false)
+ * @returns Balance check result with sufficiency status
+ *
+ * @throws Error if balance fetch fails
+ *
+ * @example
+ * ```typescript
+ * const check = await checkGalaBalance(sdk, '10000000000'); // 10 GALA
+ * if (check.sufficient != null) {
+ *   log.success('Sufficient GALA balance');
+ * } else {
+ *   log.error(`Need ${formatBalance(check.required)} GALA`);
+ * }
+ * ```
+ */
+export declare function checkGalaBalance(sdk: LaunchpadSDK, minimumRequired?: string | number, silent?: boolean): Promise<BalanceCheckResult>;
+/**
+ * Check token balance before operation.
+ *
+ * Fetches balance for a specific token at the provided address.
+ *
+ * @param sdk - Configured LaunchpadSDK instance
+ * @param tokenName - Name of the token
+ * @param minimumRequired - Minimum amount required (in atomic units)
+ * @param address - Wallet address (default: SDK wallet address)
+ * @param silent - Skip logging (default: false)
+ * @returns Balance check result with sufficiency status
+ *
+ * @throws Error if balance fetch fails
+ *
+ * @example
+ * ```typescript
+ * const check = await checkTokenBalance(sdk, 'anime', '1000000000', walletAddress);
+ * if (!check.sufficient) {
+ *   log.error('Insufficient anime tokens');
+ *   process.exit(1);
+ * }
+ * ```
+ */
+export declare function checkTokenBalance(sdk: LaunchpadSDK, tokenName: string, minimumRequired?: string | number, address?: string, silent?: boolean): Promise<BalanceCheckResult>;
+/**
+ * Check multiple token balances at once.
+ *
+ * Efficiently checks balances for several tokens and returns a summary.
+ *
+ * @param sdk - Configured LaunchpadSDK instance
+ * @param tokens - Object mapping token names to minimum required amounts
+ * @param address - Wallet address (default: SDK wallet address)
+ * @returns Map of token names to balance check results
+ *
+ * @example
+ * ```typescript
+ * const balances = await checkMultipleBalances(sdk, {
+ *   'GALA': '10000000000', // 10 GALA
+ *   'anime': '1000000000',  // 1B anime tokens
+ *   'gusdc': '100000000',   // 1 GUSDC
+ * });
+ *
+ * if (!balances.GALA.sufficient) {
+ *   log.error('Need more GALA');
+ * }
+ * ```
+ */
+export declare function checkMultipleBalances(sdk: LaunchpadSDK, tokens: Record<string, string | number>, address?: string): Promise<Record<string, BalanceCheckResult>>;
+/**
+ * Ensure minimum GALA balance or exit with error.
+ *
+ * Checks GALA balance and exits the process if insufficient.
+ * Useful for validating prerequisites before running demos.
+ *
+ * @param sdk - Configured LaunchpadSDK instance
+ * @param minimumRequired - Minimum GALA required (in atomic units)
+ * @param exitCode - Process exit code on failure (default: 1)
+ *
+ * @example
+ * ```typescript
+ * await requireGalaBalance(sdk, '10000000000'); // Require 10 GALA
+ * // If insufficient, logs error and exits process
+ *
+ * // If sufficient, continues execution
+ * const balance = await sdk.fetchGalaBalance();
+ * ```
+ */
+export declare function requireGalaBalance(sdk: LaunchpadSDK, minimumRequired?: string | number, exitCode?: number): Promise<void>;
+/**
+ * Ensure minimum token balance or exit with error.
+ *
+ * Checks token balance and exits the process if insufficient.
+ * Useful for validating prerequisites before running demos.
+ *
+ * @param sdk - Configured LaunchpadSDK instance
+ * @param tokenName - Name of the token to check
+ * @param minimumRequired - Minimum amount required (in atomic units)
+ * @param address - Wallet address (default: SDK wallet address)
+ * @param exitCode - Process exit code on failure (default: 1)
+ *
+ * @example
+ * ```typescript
+ * await requireTokenBalance(sdk, 'anime', '1000000000');
+ * // If insufficient, logs error and exits process
+ * ```
+ */
+export declare function requireTokenBalance(sdk: LaunchpadSDK, tokenName: string, minimumRequired?: string | number, address?: string, exitCode?: number): Promise<void>;
+//# sourceMappingURL=balance-checking.d.ts.map

package/dist/examples/utils/balance-checking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance-checking.d.ts","sourceRoot":"","sources":["../../../examples/utils/balance-checking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAK9C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,UAAU,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,YAAY,EACjB,eAAe,GAAE,MAAM,GAAG,MAAY,EACtC,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,kBAAkB,CAAC,CA0B7B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,MAAM,EACjB,eAAe,GAAE,MAAM,GAAG,MAAY,EACtC,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAqC7B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EACvC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CA+B7C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,YAAY,EACjB,eAAe,GAAE,MAAM,GAAG,MAAY,EACtC,QAAQ,GAAE,MAAU,GACnB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,MAAM,EACjB,eAAe,GAAE,MAAM,GAAG,MAAY,EACtC,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAU,GACnB,OAAO,CAAC,IAAI,CAAC,CAUf"}