@gala-chain/launchpad-sdk 0.4.3 → 3.0.0

package/dist/src/types/transfer.dto.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Transfer API Data Transfer Objects and Types
+ *
+ * This module contains all types and interfaces related to token transfers
+ * including GALA transfers and launchpad token transfers via GalaChain.
+ *
+ * Transfer operations support wallet-to-wallet transfers with EIP-712 signing
+ * for secure blockchain transactions through the GalaChain gateway.
+ */
+/**
+ * Data required for transferring GALA tokens between wallets
+ */
+export interface TransferGalaData {
+    /** Recipient wallet address in backend format (eth|40hex) or Ethereum format (0x...) */
+    recipientAddress: string;
+    /** Amount of GALA to transfer in decimal format (e.g., "0.001", "1.5") */
+    amount: string;
+    /** Optional unique key for idempotency - prevents duplicate transfers */
+    uniqueKey?: string;
+}
+/**
+ * Data required for transferring launchpad tokens between wallets
+ */
+export interface TransferTokenData {
+    /** Recipient wallet address in backend format (eth|40hex) or Ethereum format (0x...) */
+    to: string;
+    /** Amount of tokens to transfer in decimal format (integers recommended) */
+    amount: string;
+    /** Flexible token identifier - accepts string, TokenClassKey, or TokenInstanceKey */
+    tokenId?: import('../types/common').TokenId;
+    /** Token name for lookup (e.g., 'tinyevil', 'dragnrkti') - used if tokenId not provided */
+    tokenName?: string;
+    /** Optional unique key for idempotency - auto-generated if not provided */
+    uniqueKey?: string;
+}
+/**
+ * Internal response from GALA transfer endpoint
+ * Handles both legacy format and GalaChain format
+ */
+export type InternalTransferGalaResponse = {
+    /** GalaChain response format (actual response) */
+    Status: number;
+    Data: Array<{
+        additionalKey?: string;
+        category?: string;
+        collection?: string;
+        owner?: string;
+        quantity?: string;
+        type?: string;
+        inUseHolds?: any[];
+        instanceIds?: any[];
+        lockedHolds?: any[];
+        txnId?: string;
+        transactionId?: string;
+        id?: string;
+        TxnId?: string;
+        [key: string]: any;
+    }>;
+} | {
+    /** Legacy response format */
+    transactionId: string;
+    from: string;
+    to: string;
+    amount: string;
+    timestamp: number;
+    fee?: string;
+    blockNumber?: number;
+};
+/**
+ * Internal response from token transfer endpoint
+ * Handles both legacy format and GalaChain format
+ */
+export type InternalTransferTokenResponse = {
+    /** GalaChain response format (actual response) */
+    Status: number;
+    Data: Array<{
+        additionalKey?: string;
+        category?: string;
+        collection?: string;
+        owner?: string;
+        quantity?: string;
+        type?: string;
+        inUseHolds?: any[];
+        instanceIds?: any[];
+        lockedHolds?: any[];
+        txnId?: string;
+        transactionId?: string;
+        id?: string;
+        TxnId?: string;
+        [key: string]: any;
+    }>;
+} | {
+    /** Legacy response format */
+    transactionId: string;
+    from: string;
+    to: string;
+    amount: string;
+    tokenName: string;
+    timestamp: number;
+    fee?: string;
+    blockNumber?: number;
+};
+/**
+ * Type guard to check if an object is valid TransferGalaData
+ */
+export declare function isTransferGalaData(obj: any): obj is TransferGalaData;
+/**
+ * Type guard to check if an object is valid TransferTokenData
+ */
+export declare function isTransferTokenData(obj: any): obj is TransferTokenData;
+/**
+ * Validation constraints for transfer operations
+ */
+export declare const TRANSFER_CONSTRAINTS: {
+    /** Maximum length for unique keys */
+    readonly MAX_UNIQUE_KEY_LENGTH: 64;
+    /** Pattern for valid unique keys (must have GalaChain operation prefix) */
+    readonly UNIQUE_KEY_PATTERN: RegExp;
+    /** Pattern for valid token names */
+    readonly TOKEN_NAME_PATTERN: RegExp;
+    /** Pattern for valid Ethereum addresses (0x format) */
+    readonly ETH_ADDRESS_PATTERN: RegExp;
+    /** Pattern for valid backend addresses (eth| format) */
+    readonly BACKEND_ADDRESS_PATTERN: RegExp;
+};
+/**
+ * Common transfer error types
+ */
+export declare enum TransferErrorType {
+    INVALID_RECIPIENT = "INVALID_RECIPIENT",
+    INVALID_AMOUNT = "INVALID_AMOUNT",
+    INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+    TOKEN_NOT_FOUND = "TOKEN_NOT_FOUND",
+    SIGNATURE_FAILED = "SIGNATURE_FAILED",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    DUPLICATE_TRANSFER = "DUPLICATE_TRANSFER",
+    TRANSFER_LIMIT_EXCEEDED = "TRANSFER_LIMIT_EXCEEDED"
+}
+/**
+ * Transfer error with detailed information
+ */
+export declare class TransferError extends Error {
+    readonly type: TransferErrorType;
+    readonly details?: {
+        recipientAddress?: string;
+        amount?: string;
+        tokenName?: string;
+        balance?: string;
+        limit?: string;
+        uniqueKey?: string;
+    } | undefined;
+    constructor(message: string, type: TransferErrorType, details?: {
+        recipientAddress?: string;
+        amount?: string;
+        tokenName?: string;
+        balance?: string;
+        limit?: string;
+        uniqueKey?: string;
+    } | undefined);
+}
+//# sourceMappingURL=transfer.dto.d.ts.map

package/dist/src/types/transfer.dto.d.ts.map

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

package/dist/{types → src/types}/user.dto.d.ts

@@ -71,18 +71,23 @@ export interface UserTokenInfo {
     [key: string]: any;
 }
 /**
- * Response from get token list endpoint
+ * Clean paginated response for user token lists
  */
-export interface GetTokenListResponse {
-    /** Array of user tokens */
-    data: UserTokenInfo[];
-    /** Pagination metadata */
+export interface UserTokenListResult {
+    /** Array of user tokens with Date objects */
+    tokens: UserTokenInfo[];
+    /** Current page number */
     page: number;
+    /** Items per page */
     limit: number;
+    /** Total number of items */
     total: number;
+    /** Total number of pages */
     totalPages: number;
-    hasNextPage: boolean;
-    hasPrevPage: boolean;
+    /** Whether there are more pages */
+    hasNext: boolean;
+    /** Whether there is a previous page */
+    hasPrevious: boolean;
 }
 /**
  * Data required for transferring faucets to user
@@ -94,27 +99,16 @@ export interface TransferFaucetsData {
     amount: string;
 }
 /**
- * Response from transfer faucets endpoint
+ * Internal response from transfer faucets endpoint
+ * Note: data field is never populated by backend
  */
-export interface TransferFaucetsResponse {
+export interface InternalTransferFaucetsResponse {
     /** HTTP status code */
     status: number;
     /** Error flag (false for success) */
     error: boolean;
     /** Success/error message from backend */
     message: string;
-    /** Optional transfer details (may be added by backend in future) */
-    data?: {
-        /** Transaction hash */
-        txHash?: string;
-        /** Amount transferred */
-        amount?: string;
-        /** Token address */
-        tokenAddress?: string;
-        /** Transfer timestamp */
-        timestamp?: string;
-        [key: string]: any;
-    };
 }
 /**
  * Options for fetching GALA balance
@@ -138,20 +132,22 @@ export interface GalaBalanceInfo {
     /** Token decimals */
     decimals: number;
     /** Last update timestamp */
-    lastUpdated: string;
+    lastUpdated: Date;
     /** Additional balance metadata */
     [key: string]: any;
 }
 /**
- * Response from fetch GALA balance endpoint
+ * Internal response from fetch GALA balance endpoint
  */
-export interface FetchGalaBalanceResponse {
-    /** Success status */
-    success: boolean;
+export interface InternalFetchGalaBalanceResponse {
+    /** HTTP status code */
+    status: number;
+    /** Error flag */
+    error: boolean;
+    /** Response message */
+    message: string;
     /** Balance information */
     data?: GalaBalanceInfo;
-    /** Error message if fetch failed */
-    message?: string;
 }
 /**
  * Data required for updating user profile
@@ -165,15 +161,17 @@ export interface UpdateProfileData {
     walletAddress: AddressFormat;
 }
 /**
- * Response from update profile endpoint
+ * Internal response from update profile endpoint
  */
-export interface UpdateProfileResponse {
-    /** Success status */
-    success: boolean;
+export interface InternalUpdateProfileResponse {
+    /** HTTP status code */
+    status: number;
+    /** Error flag */
+    error: boolean;
+    /** Success/error message */
+    message: string;
     /** Updated profile data */
     data?: any;
-    /** Success/error message */
-    message?: string;
 }
 /**
  * Options for uploading profile image
@@ -185,11 +183,15 @@ export interface UploadProfileImageOptions {
     walletAddress?: AddressFormat;
 }
 /**
- * Response from profile image upload endpoint
+ * Internal response from profile image upload endpoint
  */
-export interface UploadProfileImageResponse {
+export interface InternalUploadProfileImageResponse {
     /** Success status */
     success: boolean;
+    /** HTTP status code */
+    status: number;
+    /** Error flag */
+    error: boolean;
     /** Upload result data */
     data?: {
         /** Uploaded image URL or identifier */
@@ -224,9 +226,9 @@ export interface TokenBalanceInfo {
     vaultAddress: string;
 }
 /**
- * Response from token balance check endpoint
+ * Internal response from token balance check endpoint
  */
-export interface GetTokenBalanceResponse {
+export interface InternalGetTokenBalanceResponse {
     /** HTTP status code */
     status: number;
     /** Error status */
@@ -327,4 +329,62 @@ export declare function isValidFullName(fullName: string): boolean;
  * Type guard to check if an object is valid UploadProfileImageOptions
  */
 export declare function isUploadProfileImageOptions(obj: any): obj is UploadProfileImageOptions;
+/**
+ * Options for fetching token balance from GalaChain FetchBalances endpoint
+ */
+export interface FetchTokenBalanceOptions {
+    /** Wallet address in eth|[40-hex-chars] format or standard Ethereum format */
+    address: string;
+    /** Flexible token identifier - accepts string, TokenClassKey, or TokenInstanceKey */
+    tokenId?: import('./common').TokenId;
+    /** Token class key object */
+    tokenClassKey?: import('./common').TokenClassKey;
+    /** Token name/symbol (e.g., "UNICORN", "BOBA") - will be converted to tokenClassKey format */
+    tokenName?: string;
+}
+/**
+ * GalaChain balance response for a single token
+ */
+export interface GalaChainTokenBalance {
+    /** Token collection (e.g., "GALA") */
+    collection: string;
+    /** Token category (e.g., "Unit") */
+    category: string;
+    /** Additional key (e.g., "none") */
+    additionalKey: string;
+    /** Token type (e.g., "none") */
+    type: string;
+    /** Instance identifier (e.g., "0") */
+    instance: string;
+    /** Token quantity as decimal string */
+    quantity: string;
+}
+/**
+ * Internal GalaChain FetchBalances API response
+ */
+export interface InternalGalaChainFetchBalancesResponse {
+    /** Response status */
+    Status: number;
+    /** Error message if any */
+    Message?: string;
+    /** Array of token balances */
+    Data: GalaChainTokenBalance[];
+}
+/**
+ * Clean result for fetchTokenBalance method
+ */
+export interface TokenBalanceResult {
+    /** Token quantity as decimal string */
+    quantity: string;
+    /** Token collection (e.g., "GALA") */
+    collection: string;
+    /** Token category (e.g., "Unit") */
+    category: string;
+    /** Full token ID (e.g., "GALA|Unit|none|none") */
+    tokenId: string;
+}
+/**
+ * Type guard to check if an object is valid FetchTokenBalanceOptions
+ */
+export declare function isFetchTokenBalanceOptions(obj: any): obj is FetchTokenBalanceOptions;
 //# sourceMappingURL=user.dto.d.ts.map

package/dist/src/types/user.dto.d.ts.map

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

package/dist/src/types/websocket.types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * WebSocket Types and Status Constants
+ *
+ * This module provides type-safe enums and mappings for WebSocket transaction
+ * monitoring statuses. It defines both backend statuses (as received from the
+ * WebSocket server) and SDK statuses (normalized for public API).
+ *
+ * @packageDocumentation
+ */
+/**
+ * Status values received from the backend WebSocket server
+ *
+ * These are the actual string values sent by the bundle backend
+ * WebSocket server for transaction status updates.
+ *
+ * @example
+ * ```typescript
+ * // Backend sends these statuses
+ * socket.on('transactionId', (data) => {
+ *   console.log(data.status); // 'PROCESSED', 'COMPLETED', etc.
+ * });
+ * ```
+ */
+export declare enum BackendSocketStatus {
+    /** Transaction has been processed successfully */
+    PROCESSED = "PROCESSED",
+    /** Transaction completed successfully (alternative to PROCESSED) */
+    COMPLETED = "COMPLETED",
+    /** Transaction succeeded (alternative completion status) */
+    SUCCESS = "SUCCESS",
+    /** Transaction failed */
+    FAILED = "FAILED",
+    /** Transaction encountered an error (alternative to FAILED) */
+    ERROR = "ERROR",
+    /** Transaction is currently being processed */
+    PROCESSING = "PROCESSING",
+    /** Transaction is pending processing */
+    PENDING = "PENDING"
+}
+/**
+ * Normalized status values used by the SDK
+ *
+ * These are the standardized status values exposed in the public API.
+ * All backend statuses are mapped to these normalized values.
+ *
+ * @example
+ * ```typescript
+ * const status: TransactionStatus = {
+ *   transactionId: '123',
+ *   status: SDKTransactionStatus.COMPLETED,
+ *   message: 'Transaction successful',
+ *   timestamp: Date.now()
+ * };
+ * ```
+ */
+export declare enum SDKTransactionStatus {
+    /** Transaction is pending processing */
+    PENDING = "pending",
+    /** Transaction is currently being processed */
+    PROCESSING = "processing",
+    /** Transaction completed successfully */
+    COMPLETED = "completed",
+    /** Transaction failed */
+    FAILED = "failed",
+    /** Transaction monitoring timed out */
+    TIMEOUT = "timeout"
+}
+/**
+ * Maps backend WebSocket statuses to SDK statuses
+ *
+ * This constant provides a centralized mapping from backend status values
+ * to normalized SDK status values. Used by the WebSocketService to convert
+ * incoming status updates to the public API format.
+ *
+ * @example
+ * ```typescript
+ * const backendStatus = 'PROCESSED';
+ * const sdkStatus = SOCKET_STATUS_MAP[backendStatus]; // 'completed'
+ * ```
+ */
+export declare const SOCKET_STATUS_MAP: Record<BackendSocketStatus, SDKTransactionStatus>;
+//# sourceMappingURL=websocket.types.d.ts.map

package/dist/src/types/websocket.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.types.d.ts","sourceRoot":"","sources":["../../../src/types/websocket.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;GAaG;AACH,oBAAY,mBAAmB;IAC7B,kDAAkD;IAClD,SAAS,cAAc;IACvB,oEAAoE;IACpE,SAAS,cAAc;IACvB,4DAA4D;IAC5D,OAAO,YAAY;IACnB,yBAAyB;IACzB,MAAM,WAAW;IACjB,+DAA+D;IAC/D,KAAK,UAAU;IACf,+CAA+C;IAC/C,UAAU,eAAe;IACzB,wCAAwC;IACxC,OAAO,YAAY;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,oBAAY,oBAAoB;IAC9B,wCAAwC;IACxC,OAAO,YAAY;IACnB,+CAA+C;IAC/C,UAAU,eAAe;IACzB,yCAAyC;IACzC,SAAS,cAAc;IACvB,yBAAyB;IACzB,MAAM,WAAW;IACjB,uCAAuC;IACvC,OAAO,YAAY;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,mBAAmB,EAAE,oBAAoB,CAQ/E,CAAC"}

package/dist/src/utils/Logger.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Unified Logger Utility
+ *
+ * Provides standardized logging across all SDK services and components.
+ * Replaces three different logging patterns (console.log with debug checks,
+ * custom debug functions, and inline logging) with a single consistent approach.
+ *
+ * Features:
+ * - Standardized log format with timestamps and prefixes
+ * - Log level support (debug, info, warn, error)
+ * - Conditional logging based on debug flag
+ * - Contextual prefixes for different services
+ * - Zero overhead when debug is disabled
+ *
+ * @packageDocumentation
+ */
+/**
+ * Log levels supported by the Logger
+ */
+export declare enum LogLevel {
+    DEBUG = "DEBUG",
+    INFO = "INFO",
+    WARN = "WARN",
+    ERROR = "ERROR"
+}
+/**
+ * Logger configuration options
+ */
+export interface LoggerConfig {
+    /** Enable debug logging */
+    debug: boolean;
+    /** Context prefix for log messages (e.g., 'BundleService', 'WebSocket') */
+    context?: string;
+    /** Minimum log level to output (defaults to DEBUG when debug=true, INFO otherwise) */
+    minLevel?: LogLevel;
+}
+/**
+ * Unified Logger class for consistent logging across the SDK
+ *
+ * @example Basic usage
+ * ```typescript
+ * const logger = new Logger({ debug: true, context: 'BundleService' });
+ * logger.debug('Processing buy transaction', { tokenName: 'mytoken' });
+ * logger.info('Transaction submitted', { txId: '0x123' });
+ * logger.warn('High slippage detected', { slippage: 0.15 });
+ * logger.error('Transaction failed', error);
+ * ```
+ *
+ * @example Conditional logging
+ * ```typescript
+ * // With debug: false, only info/warn/error are logged
+ * const logger = new Logger({ debug: false, context: 'WebSocket' });
+ * logger.debug('Connection details', data); // Not logged
+ * logger.info('Connected to server'); // Logged
+ * ```
+ */
+export declare class Logger {
+    private readonly debugEnabled;
+    private readonly context;
+    private readonly minLevel;
+    private readonly levelPriority;
+    constructor(config: LoggerConfig);
+    /**
+     * Log a debug message
+     * Only logged when debug mode is enabled
+     *
+     * @param message Log message
+     * @param data Optional data object to log
+     */
+    debug(message: string, data?: any): void;
+    /**
+     * Log an info message
+     * Always logged (unless minLevel is higher)
+     *
+     * @param message Log message
+     * @param data Optional data object to log
+     */
+    info(message: string, data?: any): void;
+    /**
+     * Log a warning message
+     * Always logged (unless minLevel is higher)
+     *
+     * @param message Log message
+     * @param data Optional data object to log
+     */
+    warn(message: string, data?: any): void;
+    /**
+     * Log an error message
+     * Always logged
+     *
+     * @param message Log message
+     * @param error Optional error object or data
+     */
+    error(message: string, error?: any): void;
+    /**
+     * Internal logging implementation
+     * @private
+     */
+    private log;
+    /**
+     * Get appropriate console method for log level
+     * @private
+     */
+    private getConsoleMethod;
+    /**
+     * Create a child logger with a sub-context
+     * Useful for creating method-specific or operation-specific loggers
+     *
+     * @param subContext Additional context to append
+     * @returns New Logger instance with combined context
+     *
+     * @example
+     * ```typescript
+     * const serviceLogger = new Logger({ debug: true, context: 'BundleService' });
+     * const methodLogger = serviceLogger.child('buyToken');
+     * methodLogger.debug('Starting buy operation'); // [BundleService:buyToken] [DEBUG] Starting buy operation
+     * ```
+     */
+    child(subContext: string): Logger;
+    /**
+     * Check if debug logging is enabled
+     * Useful for avoiding expensive operations when debug is off
+     *
+     * @returns True if debug logging is enabled
+     *
+     * @example
+     * ```typescript
+     * if (logger.isDebugEnabled()) {
+     *   const expensiveData = computeExpensiveDebugInfo();
+     *   logger.debug('Debug info', expensiveData);
+     * }
+     * ```
+     */
+    isDebugEnabled(): boolean;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/src/utils/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../src/utils/Logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAK5B;gBAEU,MAAM,EAAE,YAAY;IAQhC;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIxC;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvC;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvC;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,IAAI;IAIzC;;;OAGG;IACH,OAAO,CAAC,GAAG;IAgCX;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAexB;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAQjC;;;;;;;;;;;;;OAaG;IACH,cAAc,IAAI,OAAO;CAG1B"}