@gala-chain/launchpad-sdk 5.0.3 → 5.0.4-beta.0

package/dist/src/bridge/utils/retry.d.ts

@@ -93,4 +93,20 @@ export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOption
  * ```
  */
 export declare function createRetryWrapper(defaultOptions: RetryOptions): <T>(fn: () => Promise<T>, overrideOptions?: RetryOptions) => Promise<T>;
+/**
+ * Simple delay utility for async operations.
+ *
+ * @param ms - Delay duration in milliseconds
+ * @returns Promise that resolves after the specified delay
+ *
+ * @example
+ * ```typescript
+ * // Wait 1 second before continuing
+ * await delay(1000);
+ *
+ * // Wait before registration
+ * await delay(REGISTRATION_DELAY_MS);
+ * ```
+ */
+export declare function delay(ms: number): Promise<void>;
 //# sourceMappingURL=retry.d.ts.map

package/dist/src/bridge/utils/retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../../src/bridge/utils/retry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAE3D;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtE;AAwCD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgCxD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,aAAa,CAAC,CAAC,GAC/D,MAAM,CAWR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAyCZ;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,YAAY,IACrD,CAAC,EAAE,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,kBAAkB,YAAY,KAAG,OAAO,CAAC,CAAC,CAAC,CAG7E"}
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../../src/bridge/utils/retry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAE3D;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtE;AAwCD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAiCxD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,aAAa,CAAC,CAAC,GAC/D,MAAM,CAWR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAyCZ;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,YAAY,IACrD,CAAC,EAAE,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,kBAAkB,YAAY,KAAG,OAAO,CAAC,CAAC,CAAC,CAG7E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/src/bridge/utils/strategyDelegation.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Strategy Delegation Helpers
+ *
+ * DRY utilities for delegating balance operations to typed strategies.
+ * Eliminates repetitive assertStrategyExists() + cast + delegate patterns
+ * across BridgeService balance methods.
+ *
+ * @module bridge/utils/strategyDelegation
+ */
+import type { BridgeStrategy } from '../strategies/BridgeStrategy.js';
+import type { EthereumBridgeStrategy } from '../strategies/EthereumBridgeStrategy.js';
+import type { SolanaBridgeStrategy } from '../strategies/SolanaBridgeStrategy.js';
+import type { ExternalNetwork } from '../types/index.js';
+/**
+ * Get Ethereum strategy with type assertion.
+ *
+ * Combines strategy existence check with type cast in a single call.
+ * Use this instead of assertStrategyExists() + manual cast.
+ *
+ * @param strategies - Strategy map from BridgeService
+ * @param customError - Optional custom error message
+ * @returns Typed EthereumBridgeStrategy
+ * @throws Error if Ethereum strategy not configured
+ *
+ * @example
+ * ```typescript
+ * const ethStrategy = getEthereumStrategy(this.strategies);
+ * const balance = await ethStrategy.getEthereumTokenBalance(symbol, address);
+ * ```
+ */
+export declare function getEthereumStrategy(strategies: Map<ExternalNetwork, BridgeStrategy>, customError?: string): EthereumBridgeStrategy;
+/**
+ * Get Solana strategy with type assertion.
+ *
+ * Combines strategy existence check with type cast in a single call.
+ * Use this instead of assertStrategyExists() + manual cast.
+ *
+ * @param strategies - Strategy map from BridgeService
+ * @param customError - Optional custom error message
+ * @returns Typed SolanaBridgeStrategy
+ * @throws Error if Solana strategy not configured
+ *
+ * @example
+ * ```typescript
+ * const solStrategy = getSolanaStrategy(this.strategies);
+ * const balance = await solStrategy.getSolanaTokenBalance(symbol, address);
+ * ```
+ */
+export declare function getSolanaStrategy(strategies: Map<ExternalNetwork, BridgeStrategy>, customError?: string): SolanaBridgeStrategy;
+/**
+ * Resolve target address with wallet fallback.
+ *
+ * A common pattern in balance methods: use provided address or fall back
+ * to strategy's configured wallet address.
+ *
+ * @param providedAddress - Optional user-provided address
+ * @param strategy - Strategy instance with getWalletAddress()
+ * @returns Resolved address (user-provided or wallet default)
+ *
+ * @example
+ * ```typescript
+ * const targetAddress = resolveTargetAddress(address, ethStrategy);
+ * // Returns address if provided, otherwise ethStrategy.getWalletAddress()
+ * ```
+ */
+export declare function resolveTargetAddress(providedAddress: string | undefined, strategy: {
+    getWalletAddress(): string;
+}): string;
+//# sourceMappingURL=strategyDelegation.d.ts.map

package/dist/src/bridge/utils/strategyDelegation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategyDelegation.d.ts","sourceRoot":"","sources":["../../../../src/bridge/utils/strategyDelegation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOzD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,GAAG,CAAC,eAAe,EAAE,cAAc,CAAC,EAChD,WAAW,CAAC,EAAE,MAAM,GACnB,sBAAsB,CAMxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,GAAG,CAAC,eAAe,EAAE,cAAc,CAAC,EAChD,WAAW,CAAC,EAAE,MAAM,GACnB,oBAAoB,CAMtB;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,QAAQ,EAAE;IAAE,gBAAgB,IAAI,MAAM,CAAA;CAAE,GACvC,MAAM,CAER"}

package/dist/src/bridge/utils/tokenIdUtils.d.ts

@@ -2,6 +2,7 @@
  * Token ID Utilities
  *
  * Functions for parsing and resolving TokenId to symbol and TokenClassKey.
+ * Re-exports and builds upon the shared token-parser utilities.
  */
 import type { TokenId, TokenClassKey } from '../../types/common.js';
 /**
@@ -16,6 +17,8 @@ export interface ParsedTokenId {
 /**
  * Check if a value is a TokenClassKey object
  *
+ * Re-exports the shared isTokenClassKey from token-parser.
+ *
  * @param value - Value to check
  * @returns True if the value is a TokenClassKey object
  */
@@ -23,6 +26,8 @@ export declare function isTokenClassKey(value: unknown): value is TokenClassKey;
 /**
  * Parse a pipe-delimited token string to TokenClassKey
  *
+ * Delegates to the shared parsePipeDelimitedToken from token-parser.
+ *
  * @param tokenString - Pipe-delimited string (e.g., "GALA|Unit|none|none")
  * @returns TokenClassKey object
  * @throws Error if string format is invalid
@@ -37,6 +42,8 @@ export declare function parseTokenString(tokenString: string): TokenClassKey;
 /**
  * Stringify a TokenClassKey to pipe-delimited format
  *
+ * Delegates to centralized stringifyTokenClassKey from utils/token-stringification.ts
+ *
  * @param key - TokenClassKey object
  * @returns Pipe-delimited string
  *

package/dist/src/bridge/utils/tokenIdUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenIdUtils.d.ts","sourceRoot":"","sources":["../../../../src/bridge/utils/tokenIdUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAStE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAgBnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAEjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAgB5D"}
+{"version":3,"file":"tokenIdUtils.d.ts","sourceRoot":"","sources":["../../../../src/bridge/utils/tokenIdUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAOpE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAEnE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAEjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAgB5D"}

package/dist/src/bridge/utils/tokenMath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenMath.d.ts","sourceRoot":"","sources":["../../../../src/bridge/utils/tokenMath.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUpE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE;AAQD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,SAAI,GAAG,MAAM,CAkBzE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAK/D"}
+{"version":3,"file":"tokenMath.d.ts","sourceRoot":"","sources":["../../../../src/bridge/utils/tokenMath.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBpE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE;AAQD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,SAAI,GAAG,MAAM,CAkBzE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAK/D"}

package/dist/src/bridge/utils/tokenMetadataResolver.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Token Metadata Resolver
+ *
+ * Shared utility for resolving bridge token metadata.
+ * Used by both EthereumBridgeStrategy and SolanaBridgeStrategy.
+ *
+ * @module bridge/utils/tokenMetadataResolver
+ */
+import type { BridgeTokenMetadata } from '../types/index.js';
+import type { GalaConnectClient } from '../GalaConnectClient.js';
+/**
+ * Configuration for TokenMetadataResolver
+ */
+export interface TokenMetadataResolverConfig {
+    /** GalaConnect client for API lookups */
+    galaConnectClient: GalaConnectClient;
+}
+/**
+ * Token Metadata Resolver
+ *
+ * Provides cached token metadata resolution with fallback to API lookup.
+ * This consolidates duplicate `getTokenMetadata()` implementations from
+ * EthereumBridgeStrategy and SolanaBridgeStrategy.
+ *
+ * Resolution order:
+ * 1. In-memory cache (fastest)
+ * 2. Static metadata for well-known tokens (GALA, GWETH, etc.)
+ * 3. GalaConnect API lookup (slowest, cached after)
+ *
+ * @example
+ * ```typescript
+ * const resolver = new TokenMetadataResolver({
+ *   galaConnectClient: client,
+ * });
+ *
+ * const metadata = await resolver.getTokenMetadata('GALA');
+ * console.log(metadata.decimals); // 8
+ * ```
+ */
+export declare class TokenMetadataResolver {
+    private readonly galaConnectClient;
+    private readonly cache;
+    constructor(config: TokenMetadataResolverConfig);
+    /**
+     * Get token metadata for a symbol.
+     *
+     * Checks cache first, then static metadata, then API.
+     * Results are cached for subsequent lookups.
+     *
+     * @param symbol - Token symbol (e.g., 'GALA', 'GWETH', 'GUSDC')
+     * @returns Token metadata including descriptor and decimals
+     * @throws Error if token metadata cannot be found
+     *
+     * @example
+     * ```typescript
+     * const metadata = await resolver.getTokenMetadata('GALA');
+     * // Returns: { descriptor: { collection: 'GALA', ... }, decimals: 8, channel: 'asset' }
+     * ```
+     */
+    getTokenMetadata(symbol: string): Promise<BridgeTokenMetadata>;
+    /**
+     * Check if metadata is available for a symbol (without API call).
+     *
+     * Only checks cache and static metadata.
+     *
+     * @param symbol - Token symbol to check
+     * @returns True if metadata is already available
+     */
+    hasMetadata(symbol: string): boolean;
+    /**
+     * Clear the metadata cache.
+     *
+     * Useful for testing or refreshing stale data.
+     */
+    clearCache(): void;
+    /**
+     * Fetch token metadata from GalaConnect API.
+     *
+     * Handles both exact symbol matches and G-prefixed variants
+     * (e.g., "USDC" -> "GUSDC").
+     *
+     * @param symbol - Token symbol to look up
+     * @returns Token metadata
+     * @throws Error if token not found in API
+     */
+    private fetchFromApi;
+}
+/**
+ * Create a TokenMetadataResolver instance.
+ *
+ * Factory function for convenience.
+ *
+ * @param galaConnectClient - GalaConnect client for API lookups
+ * @returns Configured TokenMetadataResolver
+ */
+export declare function createTokenMetadataResolver(galaConnectClient: GalaConnectClient): TokenMetadataResolver;
+//# sourceMappingURL=tokenMetadataResolver.d.ts.map

package/dist/src/bridge/utils/tokenMetadataResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenMetadataResolver.d.ts","sourceRoot":"","sources":["../../../../src/bridge/utils/tokenMetadataResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAKjE;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yCAAyC;IACzC,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;gBAEpD,MAAM,EAAE,2BAA2B;IAI/C;;;;;;;;;;;;;;;OAeG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsBpE;;;;;;;OAOG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKpC;;;;OAIG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;;;;;;OASG;YACW,YAAY;CA+B3B;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,iBAAiB,EAAE,iBAAiB,GACnC,qBAAqB,CAEvB"}