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

package/dist/examples/utils/bridge-formatters.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Bridge Demo Formatting Utilities
+ *
+ * Provides consistent formatting for bridge-related data display including:
+ * - Fee estimation results
+ * - Transaction results
+ * - Bridge status tracking
+ * - Configuration summaries
+ *
+ * @example Fee display
+ * ```typescript
+ * import { displayBridgeFee, displayTransactionResult } from '../utils/bridge-formatters';
+ *
+ * const fee = await service.estimateBridgeFee({ ... });
+ * displayBridgeFee(fee, 'Ethereum');
+ *
+ * const tx = await service.bridgeOut({ ... });
+ * displayTransactionResult(tx);
+ * ```
+ *
+ * @since 5.14.0
+ */
+import type { BridgeFeeEstimate, BridgeStatus, BridgeTransaction } from '../../src/bridge/types/bridge.dto';
+import type { BridgeConfig } from './bridge-setup';
+/**
+ * Display bridge fee estimation in a formatted way.
+ *
+ * Shows all relevant fee information with appropriate labels.
+ *
+ * @param fee - Fee estimate from BridgeService
+ * @param destinationChain - Target chain name for contextual labeling
+ *
+ * @example
+ * ```typescript
+ * const fee = await service.estimateBridgeFee({
+ *   tokenSymbol: 'GALA',
+ *   destinationChain: 'Ethereum',
+ *   amount: '100',
+ * });
+ * displayBridgeFee(fee, 'Ethereum');
+ * // Output:
+ * //    Estimated Fee (GALA): 5.25 GALA
+ * //    Estimated Fee (ETH equiv): 0.001234
+ * //    Gas Price: 25 gwei
+ * //    Exchange Rate: 0.000234
+ * //    Fee Timestamp: 2024-01-15T10:30:00.000Z
+ * ```
+ */
+export declare function displayBridgeFee(fee: BridgeFeeEstimate, destinationChain: string): void;
+/**
+ * Display bridge transaction result in a formatted way.
+ *
+ * Shows all relevant transaction information after submission.
+ *
+ * @param tx - Transaction result from bridgeIn/bridgeOut
+ *
+ * @example
+ * ```typescript
+ * const tx = await service.bridgeOut({
+ *   tokenSymbol: 'GALA',
+ *   amount: '100',
+ *   destinationChain: 'Ethereum',
+ *   recipientAddress: '0x...',
+ * });
+ * displayTransactionResult(tx);
+ * // Output:
+ * //    Direction: out
+ * //    From: GalaChain
+ * //    To: Ethereum
+ * //    Token: GALA
+ * //    Amount: 100
+ * //    Transaction Hash: 0x...
+ * //    Fee Paid: 5.25 GALA
+ * //    Timestamp: 2024-01-15T10:30:00.000Z
+ * //    Status URL: https://...
+ * ```
+ */
+export declare function displayTransactionResult(tx: BridgeTransaction): void;
+/**
+ * Display bridge status in a formatted way.
+ *
+ * @param status - Status result from getBridgeStatus
+ *
+ * @example
+ * ```typescript
+ * const status = await service.getBridgeStatus(txHash);
+ * displayBridgeStatus(status);
+ * // Output:
+ * //    Status Code: processing
+ * //    Description: Transaction is being processed by validators
+ * //    Is Complete: false
+ * ```
+ */
+export declare function displayBridgeStatus(status: BridgeStatus): void;
+/**
+ * Display bridge configuration summary.
+ *
+ * Shows the current bridge setup including token, amount, and addresses.
+ *
+ * @param config - Bridge configuration
+ * @param addresses - Derived addresses
+ * @param direction - Bridge direction ('in' or 'out')
+ * @param destinationChain - Target chain for bridge out
+ *
+ * @example
+ * ```typescript
+ * displayBridgeConfig(config, {
+ *   galaChainAddress: 'eth|...',
+ *   ethereumAddress: '0x...',
+ * }, 'out', 'Ethereum');
+ * ```
+ */
+export declare function displayBridgeConfig(config: BridgeConfig, addresses: {
+    galaChainAddress: string;
+    ethereumAddress?: string;
+}, direction: 'in' | 'out', destinationChain?: 'Ethereum' | 'Solana'): void;
+/**
+ * Display bridge process information.
+ *
+ * Shows the step-by-step process for bridge operations.
+ *
+ * @param direction - 'in' or 'out'
+ * @param chain - 'Ethereum' or 'Solana'
+ *
+ * @example
+ * ```typescript
+ * displayBridgeProcessInfo('in', 'Ethereum');
+ * // Output:
+ * // Bridge In Process:
+ * //   1. Approve bridge contract to spend tokens (if ERC-20)
+ * //   2. Call bridge contract with token amount
+ * //   3. Wait for Ethereum transaction confirmation
+ * //   4. Wait for bridge validators to process
+ * //   5. Tokens arrive on GalaChain
+ * ```
+ */
+export declare function displayBridgeProcessInfo(direction: 'in' | 'out', chain: 'Ethereum' | 'Solana'): void;
+/**
+ * Display pre-bridge warnings.
+ *
+ * Shows important warnings before executing a bridge transaction.
+ *
+ * @param tokenSymbol - Token being bridged
+ * @param amount - Amount being bridged
+ * @param chain - Target chain
+ * @param direction - 'in' or 'out'
+ */
+export declare function displayBridgeWarnings(tokenSymbol: string, amount: string, chain: 'Ethereum' | 'Solana', direction: 'in' | 'out'): void;
+/**
+ * Display follow-up instructions after a bridge transaction.
+ *
+ * @param txHash - Transaction hash for status tracking
+ */
+export declare function displayBridgeFollowUp(txHash: string): void;
+/**
+ * Format duration for display.
+ *
+ * Converts milliseconds to human-readable format.
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Formatted duration string
+ *
+ * @example
+ * ```typescript
+ * formatBridgeDuration(125000); // "2m 5s"
+ * formatBridgeDuration(45000);  // "45s"
+ * ```
+ */
+export declare function formatBridgeDuration(ms: number): string;
+/**
+ * Display roundtrip summary.
+ *
+ * Shows complete summary of a bridge roundtrip operation.
+ *
+ * @param summary - Roundtrip summary data
+ */
+export declare function displayRoundtripSummary(summary: {
+    tokenSymbol: string;
+    amount: string;
+    leg1Duration: number;
+    leg2Duration: number;
+    totalDuration: number;
+    leg1Fee?: string;
+    leg2Fee?: string;
+    leg1TxHash: string;
+    leg2TxHash: string;
+}): void;
+//# sourceMappingURL=bridge-formatters.d.ts.map

package/dist/examples/utils/bridge-formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-formatters.d.ts","sourceRoot":"","sources":["../../../examples/utils/bridge-formatters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAC,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAcvF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAUpE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAW9D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,EACjE,SAAS,EAAE,IAAI,GAAG,KAAK,EACvB,gBAAgB,CAAC,EAAE,UAAU,GAAG,QAAQ,GACvC,IAAI,CA4BN;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,IAAI,GAAG,KAAK,EAAE,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CA2BpG;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,GAAG,QAAQ,EAC5B,SAAS,EAAE,IAAI,GAAG,KAAK,GACtB,IAAI,CAWN;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAG1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAUP"}

package/dist/examples/utils/bridge-setup.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Bridge Demo Setup Utilities
+ *
+ * Consolidates common bridge demo initialization patterns including:
+ * - Environment variable loading and validation
+ * - BridgeService creation with various configurations
+ * - Wallet address derivation (GalaChain format)
+ *
+ * @example Basic bridge service setup
+ * ```typescript
+ * import { setupBridgeService, getBridgeConfig } from '../utils/bridge-setup';
+ *
+ * const config = getBridgeConfig();
+ * const { service, galaChainAddress, ethereumAddress } = setupBridgeService(config);
+ * ```
+ *
+ * @example Read-only setup (no wallet required)
+ * ```typescript
+ * import { setupReadOnlyBridgeService } from '../utils/bridge-setup';
+ *
+ * const service = setupReadOnlyBridgeService();
+ * const fee = await service.estimateBridgeFee({ ... });
+ * ```
+ *
+ * @since 5.14.0
+ */
+import './suppress-logging';
+import './load-env';
+import { type BridgeEnvironment, BridgeService } from '../../src/bridge/BridgeService';
+/**
+ * Bridge configuration from environment variables
+ */
+export interface BridgeConfig {
+    /** GalaChain/Ethereum wallet private key */
+    privateKey: string | undefined;
+    /** Solana wallet private key (base58 format) */
+    solanaPrivateKey: string | undefined;
+    /** Custom Ethereum RPC URL */
+    ethereumRpcUrl: string | undefined;
+    /** Custom Solana RPC URL */
+    solanaRpcUrl: string | undefined;
+    /** Bridge environment (PROD or STAGE) */
+    environment: BridgeEnvironment;
+    /** DEX API base URL (derived from environment) */
+    dexApiUrl: string;
+    /** Token symbol to bridge */
+    tokenSymbol: string;
+    /** Token ID in pipe-delimited format (collection|category|type|additionalKey) */
+    tokenId: string;
+    /** Amount to bridge */
+    bridgeAmount: string;
+    /** Ethereum recipient address override */
+    ethereumRecipient: string | undefined;
+    /** Solana recipient address override */
+    solanaRecipient: string | undefined;
+    /** GalaChain recipient address override */
+    galaRecipient: string | undefined;
+}
+/**
+ * Result from bridge service setup
+ */
+export interface BridgeSetupResult {
+    /** Configured BridgeService instance */
+    service: BridgeService;
+    /** GalaChain address (eth|... format) */
+    galaChainAddress: string;
+    /** Ethereum address (0x... format) */
+    ethereumAddress: string;
+    /** Current environment */
+    environment: BridgeEnvironment;
+}
+/**
+ * Get bridge configuration from environment variables.
+ *
+ * Reads all bridge-related environment variables with sensible defaults.
+ *
+ * @returns Bridge configuration object
+ *
+ * @example
+ * ```typescript
+ * const config = getBridgeConfig();
+ * console.log(`Bridging ${config.bridgeAmount} ${config.tokenSymbol}`);
+ * ```
+ */
+/**
+ * Convert a token symbol to full tokenId format.
+ * Bridge operations REQUIRE pipe-delimited tokenId: collection|category|type|additionalKey
+ *
+ * Supported tokens and their full tokenIds:
+ * - GALA → GALA|Unit|none|none
+ * - GWETH → GWETH|Unit|none|none
+ * - GUSDC → GUSDC|Unit|none|none
+ * - GUSDT → GUSDT|Unit|none|none
+ * - GWBTC → GWBTC|Unit|none|none
+ * - GWTRX → GWTRX|Unit|none|none
+ * - GSOL → GSOL|Unit|none|none
+ *
+ * @param symbol - Token symbol (e.g., 'GALA', 'GUSDC')
+ * @returns Pipe-delimited tokenId (e.g., 'GALA|Unit|none|none')
+ * @throws Error if symbol is empty
+ */
+export declare function symbolToTokenId(symbol: string): string;
+/**
+ * Convert a token symbol to dollar-delimited tokenId format (alternative format).
+ * Some APIs accept both pipe (|) and dollar ($) delimiters.
+ *
+ * @param symbol - Token symbol (e.g., 'GALA', 'GUSDC')
+ * @returns Dollar-delimited tokenId (e.g., 'GALA$Unit$none$none')
+ */
+export declare function symbolToTokenIdDollar(symbol: string): string;
+/**
+ * Common bridge token symbols mapped to their full tokenIds.
+ * Use this constant to ensure consistency across all bridge operations.
+ */
+export declare const BRIDGE_TOKEN_IDS: {
+    readonly GALA: "GALA|Unit|none|none";
+    readonly GWETH: "GWETH|Unit|none|none";
+    readonly GUSDC: "GUSDC|Unit|none|none";
+    readonly GUSDT: "GUSDT|Unit|none|none";
+    readonly GWBTC: "GWBTC|Unit|none|none";
+    readonly GWTRX: "GWTRX|Unit|none|none";
+    readonly GSOL: "GSOL|Unit|none|none";
+};
+/**
+ * Get the full tokenId for a token symbol, or fallback to dynamic conversion.
+ * Prefers the constant mapping for consistency.
+ *
+ * @param symbol - Token symbol (e.g., 'GALA', 'GUSDC')
+ * @returns Full pipe-delimited tokenId
+ */
+export declare function getTokenId(symbol: string): string;
+export declare function getBridgeConfig(): BridgeConfig;
+/**
+ * Derive GalaChain address from Ethereum private key.
+ *
+ * GalaChain format: `eth|{40-hex-chars}` (no 0x prefix, preserves checksumming)
+ *
+ * @param privateKey - Ethereum private key
+ * @returns GalaChain formatted address
+ *
+ * @example
+ * ```typescript
+ * const galaAddress = deriveGalaChainAddress(privateKey);
+ * // Result: "eth|1234567890abcdef..."
+ * ```
+ */
+export declare function deriveGalaChainAddress(privateKey: string): string;
+/**
+ * Derive Ethereum address from private key.
+ *
+ * @param privateKey - Ethereum private key
+ * @returns Ethereum address with 0x prefix
+ */
+export declare function deriveEthereumAddress(privateKey: string): string;
+/**
+ * Setup BridgeService with full configuration.
+ *
+ * Creates an authenticated BridgeService for bridge operations.
+ * Requires a valid private key in the configuration.
+ *
+ * @param config - Bridge configuration (from getBridgeConfig())
+ * @param existingService - Optional existing service (from orchestrator)
+ * @returns Bridge service and derived addresses
+ * @throws Error if privateKey is not provided
+ *
+ * @example
+ * ```typescript
+ * const config = getBridgeConfig();
+ * const { service, galaChainAddress, ethereumAddress } = setupBridgeService(config);
+ *
+ * await service.bridgeOut({
+ *   tokenSymbol: 'GALA',
+ *   amount: '100',
+ *   destinationChain: 'Ethereum',
+ *   recipientAddress: ethereumAddress,
+ * });
+ * ```
+ */
+export declare function setupBridgeService(config: BridgeConfig, existingService?: BridgeService): BridgeSetupResult;
+/**
+ * Setup read-only BridgeService (no wallet required).
+ *
+ * Creates a BridgeService suitable for read-only operations like:
+ * - Fee estimation
+ * - Listing supported tokens
+ * - Checking transaction status
+ *
+ * Uses dummy credentials since these operations don't require authentication.
+ *
+ * @param environment - Optional environment override (default: from env vars)
+ * @returns Read-only BridgeService
+ *
+ * @example
+ * ```typescript
+ * const service = setupReadOnlyBridgeService();
+ *
+ * const fee = await service.estimateBridgeFee({
+ *   tokenSymbol: 'GALA',
+ *   destinationChain: 'Ethereum',
+ *   amount: '100',
+ * });
+ * ```
+ */
+export declare function setupReadOnlyBridgeService(environment?: BridgeEnvironment): BridgeService;
+/**
+ * Validate required environment variables for bridge operations.
+ *
+ * Provides helpful error messages for missing configuration.
+ *
+ * @param requirements - Object specifying which variables are required
+ * @returns Validation result with missing variables
+ *
+ * @example
+ * ```typescript
+ * const { isValid, missing } = validateBridgeRequirements({
+ *   privateKey: true,
+ *   solanaPrivateKey: true,
+ *   solanaRecipient: true,
+ * });
+ *
+ * if (!isValid) {
+ *   console.error('Missing:', missing.join(', '));
+ * }
+ * ```
+ */
+export declare function validateBridgeRequirements(requirements: {
+    privateKey?: boolean;
+    solanaPrivateKey?: boolean;
+    ethereumRecipient?: boolean;
+    solanaRecipient?: boolean;
+}): {
+    isValid: boolean;
+    missing: string[];
+};
+//# sourceMappingURL=bridge-setup.d.ts.map

package/dist/examples/utils/bridge-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-setup.d.ts","sourceRoot":"","sources":["../../../examples/utils/bridge-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,oBAAoB,CAAC;AAE5B,OAAO,YAAY,CAAC;AAIpB,OAAO,EAAE,KAAK,iBAAiB,EAAC,aAAa,EAA4B,MAAM,gCAAgC,CAAC;AAKhH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,8BAA8B;IAC9B,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,4BAA4B;IAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,yCAAyC;IACzC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,wCAAwC;IACxC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,2CAA2C;IAC3C,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,OAAO,EAAE,aAAa,CAAC;IACvB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAED;;;;;;;;;;;;GAYG;AACH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;CAQnB,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,wBAAgB,eAAe,IAAI,YAAY,CAwB9C;AAiBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,eAAe,CAAC,EAAE,aAAa,GAC9B,iBAAiB,CAyBnB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,CAAC,EAAE,iBAAiB,GAAG,aAAa,CAQzF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE;IACvD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAqB1C"}

package/dist/examples/utils/bridge-transaction-logger.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Bridge Transaction Logger
+ *
+ * Records bridge transactions submitted during demo runs so they can be
+ * checked later to determine if they eventually completed (useful for
+ * diagnosing timeout issues in demos vs. actual infrastructure problems).
+ */
+export interface RecordedBridgeTransaction {
+    timestamp: string;
+    demoName: string;
+    transactionHash: string;
+    direction: 'out' | 'in';
+    sourceChain: string;
+    destinationChain: string;
+    tokenSymbol: string;
+    amount: string;
+    feePaid?: string;
+    lastKnownStatus?: string;
+    timeoutAfterSeconds?: number;
+}
+export interface BridgeTransactionLog {
+    recordedAt: string;
+    demoRun: string;
+    transactions: RecordedBridgeTransaction[];
+}
+/**
+ * Ensure log directory exists
+ */
+export declare function ensureLogDir(): void;
+/**
+ * Record a bridge transaction
+ */
+export declare function recordBridgeTransaction(tx: RecordedBridgeTransaction): void;
+/**
+ * List all recorded transactions
+ */
+export declare function listRecordedTransactions(): BridgeTransactionLog[];
+/**
+ * Display transactions awaiting completion
+ */
+export declare function displayPendingTransactions(): void;
+//# sourceMappingURL=bridge-transaction-logger.d.ts.map

package/dist/examples/utils/bridge-transaction-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-transaction-logger.d.ts","sourceRoot":"","sources":["../../../examples/utils/bridge-transaction-logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,yBAAyB,EAAE,CAAC;CAC3C;AAMD;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAInC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,yBAAyB,GAAG,IAAI,CAyB3E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,oBAAoB,EAAE,CAejE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAiCjD"}

package/dist/examples/utils/cli-input.d.ts

@@ -0,0 +1,41 @@
+/**
+ * CLI Input Utilities - Interactive prompts for demo orchestrators
+ *
+ * Provides readline-based prompts for user interaction during demo execution.
+ * Used for interactive error handling and user decisions.
+ *
+ * @since 5.15.0
+ */
+/**
+ * Prompt user for input and return their response
+ *
+ * @param question - Question to display to user
+ * @param timeoutMs - Timeout in milliseconds (default: 60000 = 60 seconds)
+ * @returns User's response or empty string on timeout
+ */
+export declare function promptUser(question: string, timeoutMs?: number): Promise<string>;
+/**
+ * Prompt user when a demo fails in interactive mode
+ *
+ * @param demoId - Demo identifier
+ * @param demoName - Demo display name
+ * @param category - Demo category
+ * @param error - Error message
+ * @returns User's choice: 'continue', 'skip', 'abort', or 'retry'
+ */
+export declare function promptOnError(demoId: string, demoName: string, category: string, error: string): Promise<'continue' | 'skip' | 'abort' | 'retry'>;
+/**
+ * Prompt user to confirm action
+ *
+ * @param question - Question to display
+ * @returns true if user answers yes, false otherwise
+ */
+export declare function promptConfirm(question: string): Promise<boolean>;
+/**
+ * Format milliseconds as human-readable duration string
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Formatted duration string (e.g., "1.5s", "2.3m")
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=cli-input.d.ts.map

package/dist/examples/utils/cli-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-input.d.ts","sourceRoot":"","sources":["../../../examples/utils/cli-input.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,CAgClD;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD"}

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

@@ -0,0 +1,155 @@
+/**
+ * Centralized Demo Configuration Utility
+ *
+ * Provides single-source-of-truth for demo control flags, test data defaults,
+ * and performance tuning options. Eliminates scattered process.env lookups
+ * across demo files.
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { getDemoConfig } from '../utils/demo-config';
+ *
+ * const config = getDemoConfig();
+ * if (config.dryRun != null) {
+ *   log.info('Running in DRY RUN mode - no write operations');
+ * }
+ * const tokenName = config.defaultTokenName;
+ * ```
+ *
+ * @example In streaming demos
+ * ```typescript
+ * import { getDemoConfig } from '../utils/demo-config';
+ *
+ * const config = getDemoConfig();
+ * const watchDuration = config.defaultWatchDuration;
+ * setTimeout(() => process.exit(0), watchDuration);
+ * ```
+ *
+ * @since 5.17.0
+ */
+import './suppress-logging';
+import './load-env';
+/**
+ * Configuration for demo execution
+ */
+export interface DemoConfig {
+    /**
+     * DRY RUN mode - disable all write operations, just read/preview
+     * Set via DRY_RUN=true environment variable
+     * @default false
+     */
+    dryRun: boolean;
+    /**
+     * VERBOSE mode - enable additional logging for debugging
+     * Set via VERBOSE=true environment variable
+     * @default false
+     */
+    verbose: boolean;
+    /**
+     * RUN_WRITE_OPS mode - enable/disable write operations globally
+     * Set via RUN_WRITE_OPS=true|false environment variable
+     * @default true
+     */
+    runWriteOps: boolean;
+    /**
+     * Default token name for demos that need a token symbol
+     * Set via TOKEN_NAME environment variable
+     * @default 'anime'
+     */
+    defaultTokenName: string;
+    /**
+     * Default amount for demos that need a quantity/amount
+     * Set via AMOUNT environment variable
+     * @default '10'
+     */
+    defaultAmount: string;
+    /**
+     * Default watch duration (in milliseconds) for streaming/monitoring demos
+     * Set via WATCH_DURATION environment variable (ms)
+     * @default 30000 (30 seconds)
+     */
+    defaultWatchDuration: number;
+    /**
+     * Concurrency level for pricing operations (DEX pool pricing, etc.)
+     * Set via PRICING_CONCURRENCY environment variable
+     * Limits parallel requests to avoid rate limiting
+     * @default 5
+     */
+    pricingConcurrency: number;
+    /**
+     * Default bridge transaction hash for status tracking demos
+     * Set via BRIDGE_TX_HASH environment variable
+     * Used as fallback when a real hash is not available
+     * @default '0x' + '1'.repeat(64) (sample hash)
+     */
+    defaultBridgeTxHash: string;
+    /**
+     * Default Ethereum transaction hash for bridge tracking
+     * Set via ETHEREUM_TX_HASH environment variable
+     * @default '0x' + '1'.repeat(64) (sample hash)
+     */
+    defaultEthereumTxHash: string;
+    /**
+     * Default Solana transaction signature for bridge tracking
+     * Set via SOLANA_TX_SIGNATURE environment variable
+     * @default 'b'.repeat(88) (sample signature)
+     */
+    defaultSolanaTxSignature: string;
+}
+/**
+ * Get centralized demo configuration from environment variables.
+ *
+ * Reads all demo-related environment variables with sensible defaults.
+ * This is the single source of truth for demo config across all demos.
+ *
+ * @returns Demo configuration object
+ *
+ * @example
+ * ```typescript
+ * const config = getDemoConfig();
+ *
+ * // Use config instead of process.env throughout the demo
+ * if (config.dryRun != null) {
+ *   log.warn('DRY RUN - no write operations');
+ * }
+ *
+ * const tokenName = config.defaultTokenName; // From TOKEN_NAME env var
+ * const amount = config.defaultAmount;       // From AMOUNT env var
+ * ```
+ */
+export declare function getDemoConfig(): DemoConfig;
+/**
+ * Check if write operations should be skipped (either dryRun or runWriteOps is false)
+ *
+ * Convenience helper to avoid needing to check both flags in every demo.
+ *
+ * @returns true if write ops should be skipped
+ *
+ * @example
+ * ```typescript
+ * const config = getDemoConfig();
+ *
+ * if (shouldSkipWriteOps(config)) {
+ *   log.info('Skipping write operations - preview mode');
+ *   // Skip write operations
+ * } else {
+ *   // Perform actual write operations
+ *   await sdk.buy({ ... });
+ * }
+ * ```
+ */
+export declare function shouldSkipWriteOps(config: DemoConfig): boolean;
+/**
+ * Format demo config for logging (useful for demo startup logging)
+ *
+ * @param config - Demo configuration
+ * @returns Formatted string for logging
+ *
+ * @example
+ * ```typescript
+ * const config = getDemoConfig();
+ * log.info(formatDemoConfig(config));
+ * ```
+ */
+export declare function formatDemoConfig(config: DemoConfig): string;
+//# sourceMappingURL=demo-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"demo-config.d.ts","sourceRoot":"","sources":["../../../examples/utils/demo-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,OAAO,oBAAoB,CAAC;AAE5B,OAAO,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;;;;OAKG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;;;;OAKG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,wBAAwB,EAAE,MAAM,CAAC;CAClC;AA2BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAgC1C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAU3D"}