@gala-chain/launchpad-sdk 4.0.12 → 4.0.14

package/dist/src/services/BridgeableTokenService.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Bridgeable Token Service
+ *
+ * Service for fetching and caching bridgeable tokens from the DEX API.
+ * Provides methods to query which tokens can be bridged to Ethereum or Solana,
+ * and retrieves their contract addresses dynamically.
+ *
+ * ## Key Features
+ * - Dynamic token discovery (no hardcoded contract addresses)
+ * - Permanent caching (bridgeable tokens never change)
+ * - Lazy loading (fetches only when needed)
+ * - Environment-aware (STAGE vs PROD URLs determine network)
+ *
+ * ## Caching Strategy
+ * - Tokens are cached permanently after first fetch
+ * - Separate caches per network (Ethereum, Solana)
+ * - Cache persists for entire SDK lifetime
+ * - No fallback - API failure throws error
+ *
+ * @category Services
+ * @since 3.33.0
+ */
+import { HttpClient } from '../utils/http.js';
+import { BridgeableTokenCache } from './BridgeableTokenCache.js';
+import type { BridgeableToken, BridgeableNetwork, FetchBridgeableTokensOptions, FetchBridgeableTokensResult, IsTokenBridgeableOptions, IsTokenBridgeableResult } from '../bridge/types/bridgeable-token.dto.js';
+/**
+ * BridgeableTokenService
+ *
+ * Fetches and caches bridgeable token information from the DEX API.
+ * Provides efficient lookups for bridge operations.
+ *
+ * @example Basic usage
+ * ```typescript
+ * const service = new BridgeableTokenService(dexApiHttp, true);
+ *
+ * // Fetch all Ethereum-bridgeable tokens
+ * const result = await service.fetchAllBridgeableTokensByNetwork('ETHEREUM');
+ * console.log(`Found ${result.tokenCount} tokens`);
+ *
+ * // Check if a specific token is bridgeable
+ * const isBridgeable = await service.isTokenBridgeableToNetwork({
+ *   tokenSymbol: 'GALA',
+ *   network: 'ETHEREUM'
+ * });
+ * console.log(`GALA bridgeable to Ethereum: ${isBridgeable.isBridgeable}`);
+ *
+ * // Get contract address for a token
+ * const address = await service.getContractAddress('GWETH', 'ETHEREUM');
+ * console.log(`GWETH Ethereum address: ${address}`);
+ * ```
+ */
+export declare class BridgeableTokenService {
+    private readonly dexApiHttp;
+    private readonly logger;
+    private readonly cache;
+    constructor(dexApiHttp: HttpClient, debugMode?: boolean);
+    /**
+     * Fetch bridgeable tokens for a network with pagination
+     *
+     * @param options - Fetch options including network, offset, and limit
+     * @returns Promise resolving to fetch result with tokens array
+     * @throws NetworkError if API request fails
+     */
+    fetchBridgeableTokensByNetwork(options: FetchBridgeableTokensOptions): Promise<FetchBridgeableTokensResult>;
+    /**
+     * Fetch ALL bridgeable tokens for a network (auto-pagination)
+     *
+     * Returns cached data if available, otherwise fetches from API.
+     * Automatically handles pagination to retrieve all tokens.
+     *
+     * @param network - Network to fetch tokens for
+     * @returns Promise resolving to fetch result with all tokens
+     * @throws NetworkError if API request fails
+     */
+    fetchAllBridgeableTokensByNetwork(network: BridgeableNetwork): Promise<FetchBridgeableTokensResult>;
+    /**
+     * Convenience: Fetch all tokens bridgeable to Ethereum
+     *
+     * @returns Promise resolving to fetch result with Ethereum-bridgeable tokens
+     */
+    fetchAllTokensBridgeableToEthereum(): Promise<FetchBridgeableTokensResult>;
+    /**
+     * Convenience: Fetch all tokens bridgeable to Solana
+     *
+     * @returns Promise resolving to fetch result with Solana-bridgeable tokens
+     */
+    fetchAllTokensBridgeableToSolana(): Promise<FetchBridgeableTokensResult>;
+    /**
+     * Check if a token is bridgeable to a network
+     *
+     * Uses cache for efficient lookup. If network not cached, fetches first.
+     *
+     * @param options - Token symbol and target network
+     * @returns Promise resolving to bridgeability result
+     */
+    isTokenBridgeableToNetwork(options: IsTokenBridgeableOptions): Promise<IsTokenBridgeableResult>;
+    /**
+     * Convenience: Check if token is bridgeable to Ethereum
+     *
+     * @param tokenSymbol - Token symbol to check
+     * @returns Promise resolving to bridgeability result
+     */
+    isTokenBridgeableToEthereum(tokenSymbol: string): Promise<IsTokenBridgeableResult>;
+    /**
+     * Convenience: Check if token is bridgeable to Solana
+     *
+     * @param tokenSymbol - Token symbol to check
+     * @returns Promise resolving to bridgeability result
+     */
+    isTokenBridgeableToSolana(tokenSymbol: string): Promise<IsTokenBridgeableResult>;
+    /**
+     * Get token by symbol from cache (or fetch if not cached)
+     *
+     * @param symbol - Token symbol (case-insensitive)
+     * @param network - Network to search
+     * @returns Promise resolving to bridgeable token or undefined
+     */
+    getTokenBySymbol(symbol: string, network: BridgeableNetwork): Promise<BridgeableToken | undefined>;
+    /**
+     * Get token by stringified TokenClassKey (tokenId) from cache (or fetch if not cached)
+     *
+     * @param tokenId - Stringified TokenClassKey (e.g., "GALA|Unit|none|none")
+     * @param network - Network to search
+     * @returns Promise resolving to bridgeable token or undefined
+     */
+    getTokenByTokenId(tokenId: string, network: BridgeableNetwork): Promise<BridgeableToken | undefined>;
+    /**
+     * Get contract address for a token on a network
+     *
+     * @param symbol - Token symbol (case-insensitive)
+     * @param network - Target network
+     * @returns Promise resolving to contract address or undefined
+     */
+    getContractAddress(symbol: string, network: BridgeableNetwork): Promise<string | undefined>;
+    /**
+     * Get all supported token symbols for a network
+     *
+     * @param network - Network to get symbols for
+     * @returns Promise resolving to array of token symbols
+     */
+    getSupportedTokenSymbols(network: BridgeableNetwork): Promise<string[]>;
+    /**
+     * Preload bridgeable tokens for both networks
+     *
+     * Fetches and caches tokens for Ethereum and Solana in parallel.
+     * Useful for eager loading to avoid latency on first bridge operation.
+     */
+    preload(): Promise<void>;
+    /**
+     * Get cache statistics
+     *
+     * @returns Cache statistics including token counts and timestamps
+     */
+    getCacheStats(): ReturnType<BridgeableTokenCache['getStats']>;
+    /**
+     * Clear cache for a network or all networks
+     *
+     * @param network - Optional network to clear (clears all if not provided)
+     */
+    clearCache(network?: BridgeableNetwork): void;
+    /**
+     * Transform API response tokens to SDK format
+     *
+     * @param apiTokens - Raw API response tokens
+     * @param targetNetwork - Network being queried
+     * @returns Array of transformed bridgeable tokens
+     */
+    private transformTokens;
+}
+//# sourceMappingURL=BridgeableTokenService.d.ts.map

package/dist/src/services/BridgeableTokenService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BridgeableTokenService.d.ts","sourceRoot":"","sources":["../../../src/services/BridgeableTokenService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAGjB,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,yCAAyC,CAAC;AAQjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,sBAAsB;IAK/B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;gBAG1B,UAAU,EAAE,UAAU,EACvC,SAAS,GAAE,OAAe;IAS5B;;;;;;OAMG;IACG,8BAA8B,CAClC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC;IA4CvC;;;;;;;;;OASG;IACG,iCAAiC,CACrC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,2BAA2B,CAAC;IA4DvC;;;;OAIG;IACG,kCAAkC,IAAI,OAAO,CAAC,2BAA2B,CAAC;IAIhF;;;;OAIG;IACG,gCAAgC,IAAI,OAAO,CAAC,2BAA2B,CAAC;IAI9E;;;;;;;OAOG;IACG,0BAA0B,CAC9B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC;IA8BnC;;;;;OAKG;IACG,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIxF;;;;;OAKG;IACG,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAItF;;;;;;OAMG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAUvC;;;;;;OAMG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAUvC;;;;;;OAMG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAS9B;;;;;OAKG;IACG,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQ7E;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;;;OAIG;IACH,aAAa,IAAI,UAAU,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAI7D;;;;OAIG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAI7C;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;CAuDxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-sdk",
-  "version": "4.0.12",
+  "version": "4.0.14",
   "description": "TypeScript SDK for Gala Launchpad Backend API - 100+ public methods with 373+ fully documented APIs supporting optional wallet (read-only and full-access modes). Production-ready DeFi token launchpad integration with AgentConfig setup, GalaChain trading, GSwap DEX integration, price history, token creation, DEX pool discovery, WebSocket event watchers, and comprehensive user operations. Multi-format output (ESM, CJS, UMD).",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -113,6 +113,7 @@
     "demo:bridge:sol:in": "tsx examples/bridge/solana-in.ts",
     "demo:bridge:sol:roundtrip": "tsx examples/bridge/solana-roundtrip.ts",
     "demo:bridge:balances": "tsx examples/bridge/wallet-balances.ts",
+    "demo:bridge:bridgeable": "tsx examples/bridge/bridgeable-tokens.ts",
     "test:demos:core": "npm run demo && npm run demo:read-only && npm run demo:authenticated && npm run demo:privatekey-override",
     "test:demos:dex": "npm run demo:dex:pools && npm run demo:dex:pricing && npm run demo:dex:quotes && npm run demo:dex && npm run demo:dex:roundtrip",
     "test:demos:liquidity": "npm run demo:liquidity:all",