@gala-chain/launchpad-sdk 0.4.2 → 3.0.0

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

@@ -0,0 +1,479 @@
+/**
+ * Launchpad Service
+ *
+ * This service consolidates all launchpad-backend operations from multiple API classes.
+ * It provides a unified interface for:
+ * - Image upload operations
+ * - Token launch/creation
+ * - Pool queries and data fetching
+ * - Calculation methods
+ * - Trade history
+ * - Comment operations
+ * - User profile management
+ * - User token list operations
+ * - Faucet transfers
+ *
+ * All methods use the launchpad-backend HTTP client exclusively.
+ */
+import { HttpClient } from '../utils/http';
+import { PoolsResult, CheckPoolOptions, GraphDataResult, TokenDistributionResult, TokenBadgesResult } from '../types/launchpad.dto';
+import { UploadImageByTokenNameOptions, FetchVolumeDataOptions, HasTokenBadgeOptions } from '../types/options.dto';
+import { CommentsResult } from '../types/comment.dto';
+import { FetchCommentsOptions, PostCommentOptions } from '../types/options.dto';
+import { TradesResult } from '../types/trade.dto';
+import { FetchTradesOptions } from '../types/options.dto';
+import { GetTokenListOptions, UserTokenListResult, TransferFaucetsData, UpdateProfileData, UploadProfileImageOptions } from '../types/user.dto';
+/**
+ * Launchpad Service
+ *
+ * Consolidated service for all launchpad-backend operations including:
+ * - Image uploads for token branding
+ * - Pool queries and data fetching
+ * - Token distribution and badge retrieval
+ * - Comment operations
+ * - Trade history
+ * - User profile management
+ * - User token lists
+ * - Faucet transfers
+ *
+ * @category Services
+ * @since 2.0.0
+ *
+ * @example Basic usage
+ * ```typescript
+ * const service = new LaunchpadService(httpClient);
+ *
+ * // Upload token image
+ * const imageUrl = await service.uploadImageByTokenName({
+ *   tokenName: 'mytoken',
+ *   options: { file: imageFile, tokenName: 'mytoken' }
+ * });
+ *
+ * // Fetch pools
+ * const pools = await service.fetchPools({ type: 'recent', page: 1, limit: 10 });
+ *
+ * // Get comments
+ * const comments = await service.fetchComments({ tokenName: 'mytoken' });
+ * ```
+ */
+export declare class LaunchpadService {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Uploads an image for a token pool
+     *
+     * Uploads a token image that will be used for branding and display purposes.
+     * Supports both browser File objects and Node.js Buffer objects for maximum
+     * compatibility across environments.
+     *
+     * File Requirements:
+     * - Format: PNG, JPG, JPEG, WebP
+     * - Size: Maximum 5MB
+     * - Dimensions: Recommended 512x512px or higher
+     * - Aspect ratio: Square (1:1) recommended
+     *
+     * @category File Operations
+     * @param options Upload configuration object
+     * @param options.file Image file as File object (browser) or Buffer (Node.js)
+     * @param options.tokenName Token name for the image (must be valid token name format)
+     * @returns Promise that resolves to image URL string
+     * @throws {ValidationError} If token name format is invalid
+     * @throws {FileValidationError} If file doesn't meet requirements
+     * @throws {Error} If upload fails due to network or server issues
+     * @since 2.0.0
+     *
+     * @example Browser file upload
+     * ```typescript
+     * const fileInput = document.querySelector('#image-upload') as HTMLInputElement;
+     * const file = fileInput.files?.[0];
+     *
+     * if (file) {
+     *   const imageUrl = await service.uploadImageByTokenName({
+     *     file,
+     *     tokenName: 'mytoken'
+     *   });
+     *   console.log('Image uploaded:', imageUrl);
+     * }
+     * ```
+     *
+     * @example Node.js buffer upload
+     * ```typescript
+     * import * as fs from 'fs';
+     *
+     * const imageBuffer = fs.readFileSync('./token-image.png');
+     * const imageUrl = await service.uploadImageByTokenName({
+     *   file: imageBuffer,
+     *   tokenName: 'mytoken'
+     * });
+     * console.log('Image URL:', imageUrl);
+     * ```
+     */
+    uploadImageByTokenName(options: UploadImageByTokenNameOptions): Promise<string>;
+    /**
+     * Fetches pools with filtering and pagination
+     *
+     * ✅ VERIFIED: Real API payload confirmed - endpoint /launchpad/fetch-pool
+     *
+     * @param options Fetch options including type, search, and pagination
+     * @returns Promise<PoolsResult> Clean pool data with full pagination
+     */
+    fetchPools(options?: {
+        search?: string;
+        tokenName?: string;
+        type?: 'recent' | 'popular';
+        page?: number;
+        limit?: number;
+    }): Promise<PoolsResult>;
+    /**
+     * Checks if a pool exists for given token name or symbol
+     *
+     * @param options Check options with token name and/or symbol
+     * @returns Promise<boolean> True if pool exists, false otherwise
+     */
+    checkPool(options: CheckPoolOptions): Promise<boolean>;
+    /**
+     * Checks if a token name is available (convenience method)
+     *
+     * @param tokenName Token name to check
+     * @returns Promise<boolean> True if available (pool doesn't exist)
+     */
+    isTokenNameAvailable(tokenName: string): Promise<boolean>;
+    /**
+     * Checks if a token symbol is available (convenience method)
+     *
+     * @param symbol Token symbol to check
+     * @returns Promise<boolean> True if available (pool doesn't exist)
+     */
+    isTokenSymbolAvailable(symbol: string): Promise<boolean>;
+    /**
+     * Fetches volume data for a token
+     *
+     * ✅ VERIFIED: Real API payload confirmed - endpoint /launchpad/get-graph-data
+     *
+     * @param options Volume data options
+     * @returns Promise<GraphDataResult> Clean volume and price data points
+     */
+    fetchVolumeData(options: FetchVolumeDataOptions): Promise<GraphDataResult>;
+    /**
+     * Get token distribution showing top holders
+     *
+     * Retrieves the list of top token holders for a specific token,
+     * along with their balances and percentage of total supply.
+     *
+     * @param tokenName Token name to fetch distribution for
+     * @returns Promise resolving to token distribution data
+     *
+     * @example
+     * ```typescript
+     * const distribution = await service.fetchTokenDistribution('mytoken');
+     * console.log('Top holders:', distribution.holders);
+     * ```
+     */
+    fetchTokenDistribution(tokenName: string): Promise<TokenDistributionResult>;
+    /**
+     * Gets badge achievements for a token
+     *
+     * This endpoint retrieves volume and engagement badges for a specific token.
+     * Badges indicate milestones in trading volume and community engagement.
+     *
+     * **Note**: This endpoint does not require authentication.
+     *
+     * @param tokenName The name of the token to get badges for
+     * @returns Promise<TokenBadgesResult> Badge information
+     *
+     * @example
+     * ```typescript
+     * const badges = await service.fetchTokenBadges('mytoken');
+     * console.log('Volume badges:', badges.volumeBadges);
+     * console.log('Engagement badges:', badges.engagementBadges);
+     * ```
+     */
+    fetchTokenBadges(tokenName: string): Promise<TokenBadgesResult>;
+    /**
+     * Convenience method to check if a token has achieved a specific badge
+     *
+     * @param tokenName The token name to check
+     * @param badgeType Type of badge to check ('volume' or 'engagement')
+     * @param badgeName Specific badge name to check for
+     * @returns Promise<boolean> Whether the token has achieved this badge
+     *
+     * @example
+     * ```typescript
+     * const has10kVolume = await service.hasTokenBadge('mytoken', 'volume', '10k');
+     * const hasCrowdEngagement = await service.hasTokenBadge('mytoken', 'engagement', 'CROWD');
+     * ```
+     */
+    hasTokenBadge(options: HasTokenBadgeOptions): Promise<boolean>;
+    /**
+     * Gets trades for a token by its tokenName with pagination
+     *
+     * This method provides a clean, intuitive API for fetching token trades
+     * using the token name. Follows the same pattern as CommentAPI.
+     *
+     * @param options Trade fetching options
+     * @returns Promise<TradesResult> Clean trades with full pagination
+     * @throws ValidationError if token name is invalid or not found
+     *
+     * @example
+     * ```typescript
+     * // Get first page of trades for dragnrkti token
+     * const trades = await service.fetchTrades({ tokenName: "dragnrkti" });
+     *
+     * // Get specific page with custom limit
+     * const moreTrades = await service.fetchTrades({
+     *   tokenName: "dragnrkti",
+     *   page: 2,
+     *   limit: 20
+     * });
+     * ```
+     */
+    fetchTrades(options: FetchTradesOptions): Promise<TradesResult>;
+    /**
+     * Fetches comments for a token by its tokenName
+     *
+     * This method provides a clean, intuitive API for fetching token comments
+     * using the token name. It automatically resolves the tokenName
+     * to the correct vault address internally.
+     *
+     * @param options Options for fetching comments
+     * @returns Promise<CommentsResult> Comments with pagination info
+     * @throws ValidationError if token name is invalid or not found
+     *
+     * @example
+     * ```typescript
+     * // Fetch first page of comments for dragnrkti token
+     * const comments = await service.fetchComments({ tokenName: "dragnrkti" });
+     *
+     * // Fetch specific page with more items
+     * const moreComments = await service.fetchComments({
+     *   tokenName: "dragnrkti",
+     *   page: 2,
+     *   limit: 20
+     * });
+     * ```
+     */
+    fetchComments(options: FetchCommentsOptions): Promise<CommentsResult>;
+    /**
+     * Posts a comment on a token by its tokenName
+     *
+     * This method provides a clean, intuitive API for posting comments on tokens
+     * using the token name. It automatically resolves the tokenName
+     * to the correct vault address and uses the authenticated user's wallet address.
+     *
+     * @param options Options for posting a comment
+     * @returns Promise<void> No return data
+     * @throws ValidationError if token name is invalid, not found, or content is invalid
+     *
+     * @example
+     * ```typescript
+     * // Post comment on dragnrkti token
+     * await service.postComment({
+     *   tokenName: "dragnrkti",
+     *   content: "Great project with solid fundamentals!"
+     * });
+     * ```
+     */
+    postComment(options: PostCommentOptions): Promise<void>;
+    /**
+     * Fetches user profile information
+     *
+     * ✅ VERIFIED: Real API payload confirmed - endpoint /user/profile (GET)
+     *
+     * @param walletAddress Optional wallet address (defaults to SDK wallet address)
+     * @returns Promise<any> User profile information
+     * @throws ValidationError if input validation fails
+     *
+     * @example
+     * ```typescript
+     * // Get current user's profile
+     * const profile = await service.fetchProfile();
+     *
+     * // Get specific user's profile
+     * const otherProfile = await service.fetchProfile("eth|1234567890abcdef1234567890abcdef12345678");
+     * ```
+     */
+    fetchProfile(walletAddress?: string): Promise<any>;
+    /**
+     * Updates user profile information
+     *
+     * ✅ VERIFIED: Real API payload confirmed - endpoint /user/profile (PUT)
+     *
+     * **Smart Image Preservation**: If profileImage is empty or not provided,
+     * the method automatically fetches and preserves the existing profile image
+     * to prevent accidental image loss.
+     *
+     * @param data Profile update data
+     * @returns Promise<void> No return data - throws on failure
+     * @throws ValidationError if input validation fails
+     * @throws Error if profile update fails
+     *
+     * @example
+     * ```typescript
+     * // Update with new image
+     * await service.updateProfile({
+     *   profileImage: "https://example.com/avatar.jpg",
+     *   fullName: "John Doe",
+     *   walletAddress: "eth|1234567890abcdef1234567890abcdef12345678"
+     * });
+     *
+     * // Update name only - existing image will be preserved automatically
+     * await service.updateProfile({
+     *   profileImage: "",
+     *   fullName: "Jane Doe",
+     *   walletAddress: "eth|1234567890abcdef1234567890abcdef12345678"
+     * });
+     * ```
+     */
+    updateProfile(data: UpdateProfileData): Promise<void>;
+    /**
+     * Uploads a profile image and returns the image URL
+     *
+     * ✅ VERIFIED: Real API payload confirmed - endpoint /launchpad/upload-image (for profile)
+     *
+     * @param options Profile image upload options
+     * @returns Promise<string> Clean image URL
+     * @throws ValidationError if input validation fails
+     * @throws Error if upload fails
+     *
+     * @example
+     * ```typescript
+     * // Upload profile image file
+     * const fileInput = document.getElementById('avatar') as HTMLInputElement;
+     * const file = fileInput.files[0];
+     * const imageUrl = await service.uploadProfileImage({
+     *   file: file,
+     *   walletAddress: "eth|1234567890abcdef1234567890abcdef12345678"
+     * });
+     * ```
+     */
+    uploadProfileImage(options: UploadProfileImageOptions): Promise<string>;
+    /**
+     * Fetches user token list with optional filtering and pagination
+     *
+     * ✅ VERIFIED: Real API payload confirmed - endpoint /user/token-list
+     *
+     * @param options Filtering and pagination options
+     * @returns Promise<UserTokenListResult> Clean token list with proper types
+     * @throws Error if request fails
+     */
+    fetchTokenList(options: GetTokenListOptions): Promise<UserTokenListResult>;
+    /**
+     * Fetches tokens held by user (balances)
+     *
+     * ✅ VERIFIED: Real API payload confirmed - endpoint /user/token-hold
+     *
+     * @param options Token held filtering options (address is optional)
+     * @returns Promise<UserTokenListResult> Clean tokens held with full pagination
+     * @throws ValidationError if input validation fails
+     */
+    fetchTokensHeld(options: GetTokenListOptions): Promise<UserTokenListResult>;
+    /**
+     * Fetches tokens created by user
+     *
+     * @param options Options including pagination
+     * @returns Promise<UserTokenListResult> Tokens created by the user
+     */
+    fetchTokensCreated(options?: {
+        page?: number;
+        limit?: number;
+    }): Promise<UserTokenListResult>;
+    /**
+     * Transfers faucets to a user address
+     *
+     * @param data Transfer faucets data
+     * @returns Promise<void> No return data - throws on failure
+     * @throws ValidationError if input validation fails
+     * @throws Error if transfer fails
+     *
+     * @example
+     * ```typescript
+     * await service.transferFaucets({
+     *   walletAddress: "eth|1234567890abcdef1234567890abcdef12345678",
+     *   amount: "1000000000000000000" // 1 token with 18 decimals
+     * });
+     * ```
+     */
+    transferFaucets(data: TransferFaucetsData): Promise<void>;
+    /**
+     * Gets the authenticated user's address in backend format
+     *
+     * @returns Address in eth|{40-hex-chars} format
+     */
+    getAddress(): string;
+    /**
+     * Validates a token name (exposed for external validation)
+     *
+     * @param tokenName Token name to validate
+     * @throws ValidationError if validation fails
+     */
+    validateTokenName(tokenName: string): void;
+    /**
+     * Resolves a token name to its vault address by fetching pool data
+     *
+     * @private
+     * @param tokenName Token name to resolve
+     * @returns Promise<string | null> Vault address if found, null otherwise
+     */
+    private resolveTokenNameToVault;
+    /**
+     * Builds query parameters for comment fetching
+     *
+     * @private
+     */
+    private buildGetCommentsQueryParams;
+    /**
+     * Builds query parameters for trade listing
+     *
+     * @private
+     */
+    private buildTradeQueryParams;
+    /**
+     * Builds query parameters for token list fetching
+     *
+     * @private
+     */
+    private buildTokenListQueryParams;
+    /**
+     * Builds query parameters for token hold endpoint
+     *
+     * @private
+     */
+    private buildTokenHoldQueryParams;
+    /**
+     * Validates pagination parameters
+     *
+     * @private
+     */
+    private validateTradePagination;
+    /**
+     * Validates get token list options
+     *
+     * @private
+     */
+    private validateGetTokenListOptions;
+    /**
+     * Validates user pagination parameters
+     *
+     * @private
+     */
+    private validateUserPagination;
+    /**
+     * Validates transfer faucets data
+     *
+     * @private
+     */
+    private validateTransferFaucetsData;
+    /**
+     * Validates update profile data
+     *
+     * @private
+     */
+    private validateUpdateProfileData;
+    /**
+     * Validates upload profile image options
+     *
+     * @private
+     */
+    private validateUploadProfileImageOptions;
+}
+//# sourceMappingURL=LaunchpadService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LaunchpadService.d.ts","sourceRoot":"","sources":["../../../src/services/LaunchpadService.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"SignatureService.d.ts","sourceRoot":"","sources":["../../../src/services/SignatureService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAwBH;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,QAAQ,IAAI;IACZ,YAAY,IAAI;IAChB,WAAW,IAAI;CAChB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,KAAK;gBADL,cAAc,EAAE,GAAG,EACnB,KAAK,GAAE,OAAe;IAGhC;;;;;;;;OAQG;IACG,OAAO,CACX,GAAG,EAAE,GAAG,EACR,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,gBAAgB,GAAE,gBAA4C,GAC7D,OAAO,CAAC,GAAG,CAAC;IAuEf;;OAEG;YACW,gBAAgB;IA0C9B;;OAEG;YACW,mBAAmB;IAoBjC;;;OAGG;YACW,kBAAkB;IAgDhC;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAgF3B;;OAEG;IACH,sBAAsB,IAAI,gBAAgB;CAmB3C"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"TokenClassKeyService.d.ts","sourceRoot":"","sources":["../../../src/services/TokenClassKeyService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,KAAK;gBAAL,KAAK,GAAE,OAAe;IAE1C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE;IA2C3D;;;;;;;OAOG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa;IAkBvD;;;;OAIG;IACH,kBAAkB,IAAI,aAAa;IAgBnC;;;;;;;;;;;;;OAaG;IACH,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IA4BzD;;;;;OAKG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAoCnD;;;;;;;;OAQG;IACH,2BAA2B,CACzB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,GACpB,MAAM;IAIT;;;;;OAKG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG;QAC3C,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;KACvB;CAaF"}

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

@@ -0,0 +1,154 @@
+/**
+ * Token Resolver Service
+ *
+ * Centralized service for resolving token names to vault addresses and
+ * GalaChain token identifiers.
+ *
+ * Key Features:
+ * - Token name → vault address resolution
+ * - Token name → TokenClassKey resolution
+ * - Intelligent in-memory caching (vault addresses are immutable)
+ * - Service-to-service dependency (depends on LaunchpadService)
+ * - Single responsibility: all token resolution logic in one place
+ *
+ * @packageDocumentation
+ */
+import { LaunchpadService } from './LaunchpadService';
+import type { TokenClassKey } from '../types/common';
+/**
+ * Service for resolving token names to vault addresses and GalaChain identifiers
+ *
+ * This service encapsulates all token resolution logic and provides
+ * intelligent caching to minimize API calls. Since vault addresses are
+ * immutable after token creation, they can be safely cached indefinitely.
+ *
+ * @example
+ * ```typescript
+ * const launchpadService = new LaunchpadService(httpClient);
+ * const tokenResolver = new TokenResolverService(launchpadService);
+ *
+ * // Resolve token name to vault address
+ * const vaultAddress = await tokenResolver.resolveTokenToVault('dragnrkti');
+ * console.log('Vault:', vaultAddress);
+ *
+ * // Resolve token name to GalaChain TokenClassKey
+ * const tokenClassKey = await tokenResolver.resolveTokenClassKey('dragnrkti');
+ * console.log('Token:', tokenClassKey);
+ * ```
+ */
+export declare class TokenResolverService {
+    private readonly launchpadService;
+    /**
+     * In-memory cache for tokenName → vaultAddress mappings
+     * Key: lowercase token name
+     * Value: vault address string
+     */
+    private cache;
+    /**
+     * Creates a new TokenResolverService instance
+     *
+     * @param launchpadService LaunchpadService instance for fetching token data
+     */
+    constructor(launchpadService: LaunchpadService);
+    /**
+     * Resolves a token name to its vault address
+     *
+     * This method checks the cache first, and only makes an API call if needed.
+     * Since vault addresses never change after token creation, successful
+     * resolutions are cached indefinitely.
+     *
+     * @param tokenName Token name to resolve (case-insensitive)
+     * @returns Promise<string | null> Vault address if found, null if token doesn't exist
+     * @throws {ValidationError} If tokenName is invalid
+     *
+     * @example
+     * ```typescript
+     * const vaultAddress = await tokenResolver.resolveTokenToVault('dragnrkti');
+     * if (vaultAddress) {
+     *   console.log('Vault address:', vaultAddress);
+     * } else {
+     *   console.log('Token not found');
+     * }
+     * ```
+     */
+    resolveTokenToVault(tokenName: string): Promise<string | null>;
+    /**
+     * Resolves a token name to GalaChain TokenClassKey format
+     *
+     * This method first resolves the token name to a vault address,
+     * then parses the vault address to extract TokenClassKey components.
+     *
+     * @param tokenName Token name to resolve
+     * @returns Promise<TokenClassKey> GalaChain token identifier
+     * @throws {Error} If token cannot be resolved or vault address is invalid
+     *
+     * @example
+     * ```typescript
+     * const tokenClassKey = await tokenResolver.resolveTokenClassKey('dragnrkti');
+     * console.log('Collection:', tokenClassKey.collection);
+     * console.log('Category:', tokenClassKey.category);
+     * console.log('Type:', tokenClassKey.type);
+     * console.log('Additional Key:', tokenClassKey.additionalKey);
+     * ```
+     */
+    resolveTokenClassKey(tokenName: string): Promise<TokenClassKey>;
+    /**
+     * Gets cached vault address for a token name
+     *
+     * @param tokenName Token name to lookup (case-insensitive)
+     * @returns Cached vault address or null if not in cache
+     */
+    get(tokenName: string): string | null;
+    /**
+     * Caches a vault address for a token name
+     *
+     * @param tokenName Token name to cache (will be normalized to lowercase)
+     * @param vaultAddress Vault address to cache
+     */
+    set(tokenName: string, vaultAddress: string): void;
+    /**
+     * Clears the entire cache
+     *
+     * Useful for testing or when you need to force fresh token resolution.
+     */
+    clear(): void;
+    /**
+     * Gets cache statistics
+     *
+     * @returns Object with cache size and all cached token names
+     */
+    getStats(): {
+        size: number;
+        keys: string[];
+    };
+    /**
+     * Pre-warms the cache with known tokenName → vaultAddress mappings
+     *
+     * Useful for batch operations or initialization when you already
+     * know vault addresses for certain tokens.
+     *
+     * @param mappings Array of {tokenName, vaultAddress} objects
+     *
+     * @example
+     * ```typescript
+     * tokenResolver.preWarm([
+     *   { tokenName: 'dragnrkti', vaultAddress: 'service|Token$Unit$...' },
+     *   { tokenName: 'rocketri', vaultAddress: 'service|Token$Unit$...' }
+     * ]);
+     * ```
+     */
+    preWarm(mappings: Array<{
+        tokenName: string;
+        vaultAddress: string;
+    }>): void;
+    /**
+     * Parses a vault address string to extract TokenClassKey components
+     *
+     * @private
+     * @param vaultAddress Vault address in format "service|Token$Unit$SYMBOL$eth:address$launchpad"
+     * @returns TokenClassKey object
+     * @throws {Error} If vault address format is invalid
+     */
+    private parseVaultAddressToTokenClassKey;
+}
+//# sourceMappingURL=TokenResolverService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TokenResolverService.d.ts","sourceRoot":"","sources":["../../../src/services/TokenResolverService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,oBAAoB;IAanB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAZ7C;;;;OAIG;IACH,OAAO,CAAC,KAAK,CAA6B;IAE1C;;;;OAIG;gBAC0B,gBAAgB,EAAE,gBAAgB;IAE/D;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4DpE;;;;;;;;;;;;;;;;;;OAkBG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBrE;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIrC;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAIlD;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;IAO5C;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CACL,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,GAC3D,IAAI;IAMP;;;;;;;OAOG;IACH,OAAO,CAAC,gCAAgC;CAgCzC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketManager.d.ts","sourceRoot":"","sources":["../../../src/services/WebSocketManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQvE;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAmD;IAE3E;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAChB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,eAAe,EACvB,KAAK,GAAE,OAAe,GACrB,gBAAgB;IAiCnB;;;;;;;;OAQG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,IAAI;IAgClE;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,IAAI;IAc5D;;;;;;;OAOG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,GAAE,OAAe,GAAG,IAAI;IAiBlD;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,IAAI,KAAK,CAAC;QAChC,GAAG,EAAE,MAAM,CAAC;QACZ,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC;IAQF;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI1C;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAK7C;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;CAGzB"}

package/dist/{api → src}/services/WebSocketService.d.ts

@@ -7,9 +7,10 @@
  * @category Services
  * @since 2.0.0
  */
+import { SDKTransactionStatus } from '../types/websocket.types';
 export interface TransactionStatus {
     transactionId: string;
-    status: 'pending' | 'processing' | 'completed' | 'failed' | 'timeout';
+    status: SDKTransactionStatus;
     message?: string;
     timestamp: number;
     blockHash?: string;
@@ -25,9 +26,11 @@ export declare class WebSocketService {
     private socket;
     private config;
     private listeners;
+    private timeouts;
     private reconnectCount;
     private debug;
     private isSocketIOAvailable;
+    private readonly logger;
     constructor(config: WebSocketConfig, debug?: boolean);
     /**
      * Check if Socket.IO is available in the current environment

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketService.d.ts","sourceRoot":"","sources":["../../../src/services/WebSocketService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAEL,oBAAoB,EAErB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CACL;IACZ,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,mBAAmB,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,eAAe,EAAE,KAAK,GAAE,OAAe;IAc3D;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAiBjC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwD9B;;OAEG;IACG,kBAAkB,CACtB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAC5C,OAAO,CAAC,IAAI,CAAC;IA8HhB;;OAEG;IACG,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAY3E;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;YACW,eAAe;IAmB7B;;OAEG;IACH,UAAU,IAAI,IAAI;IAelB;;OAEG;IACH,WAAW,IAAI,OAAO;CAGvB"}