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

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

@@ -0,0 +1,108 @@
+/**
+ * GalaChain Token Service
+ *
+ * Service responsible for token metadata and class queries from GalaChain.
+ * Extracted from GalaChainService for single responsibility.
+ *
+ * Features:
+ * - Token class metadata fetching (symbol, decimals, name, image)
+ * - Token supply information queries
+ * - Support for both native and wrapped tokens
+ *
+ * @example
+ * ```typescript
+ * const tokenService = new GalaChainTokenService(http, debug, publicAxios);
+ *
+ * // Fetch native GALA token metadata
+ * const gala = await tokenService.fetchTokenClassFromChain('GALA|Unit|none|none');
+ * console.log(`Symbol: ${gala.symbol}`); // "GALA"
+ *
+ * // Fetch token supply information
+ * const supplies = await tokenService.fetchTokenClassesWithSupply([
+ *   { collection: 'GALA', category: 'Unit', type: 'none', additionalKey: 'none' }
+ * ]);
+ * ```
+ *
+ * @category Services
+ * @since 5.15.0
+ */
+import type { AxiosInstance } from 'axios';
+import { HttpClient } from '../utils/http';
+import { BaseService } from './BaseService';
+import { TokenClassKey } from '../types/common';
+import type { TokenClass } from '@gala-chain/api';
+import { TokenClassWithSupply } from '../types/launchpad.dto';
+/**
+ * GalaChain Token Service
+ *
+ * Handles all token metadata and class queries to GalaChain gateway.
+ */
+export declare class GalaChainTokenService extends BaseService {
+    private readonly publicAxios?;
+    /**
+     * Initialize GalaChain Token Service
+     *
+     * @param http - HTTP client configured for GalaChain gateway
+     * @param debug - Enable debug logging (default: false)
+     * @param publicAxios - Unauthenticated axios instance for public token queries
+     */
+    constructor(http: HttpClient, debug?: boolean, publicAxios?: AxiosInstance | undefined);
+    /**
+     * Fetch token metadata from GalaChain using native FetchTokenClasses API
+     *
+     * Queries the authoritative GalaChain token registry for complete token metadata
+     * including symbol, decimals, name, image, and description. This is the source
+     * of truth for all tokens on GalaChain (both native and wrapped).
+     *
+     * Supports both native tokens (GALA, etc.) and wrapped DEX tokens.
+     *
+     * @param tokenId Token identifier (string or TokenClassKey format)
+     * @returns Promise<TokenClass> Complete token metadata from GalaChain
+     * @throws ValidationError if tokenId validation fails
+     * @throws Error if token fetch fails or token not found
+     *
+     * @example
+     * ```typescript
+     * // Fetch native GALA token metadata
+     * const gala = await tokenService.fetchTokenClassFromChain('GALA|Unit|none|none');
+     * console.log(`Symbol: ${gala.symbol}`); // "GALA"
+     * console.log(`Decimals: ${gala.decimals}`); // 8
+     *
+     * // Fetch wrapped token metadata
+     * const gusdc = await tokenService.fetchTokenClassFromChain({
+     *   collection: 'GUSDC',
+     *   category: 'Unit',
+     *   type: 'none',
+     *   additionalKey: 'none'
+     * });
+     * console.log(`Symbol: ${gusdc.symbol}`); // "GUSDC"
+     * ```
+     */
+    fetchTokenClassFromChain(tokenId: string | TokenClassKey): Promise<TokenClass>;
+    /**
+     * Fetch supply information for one or more token classes from GalaChain
+     *
+     * Queries GalaChain for authoritative token supply data including:
+     * - Total supply and maximum supply
+     * - Total burned amount
+     * - Mint-related supply metrics
+     * - Token metadata (symbol, decimals, name)
+     *
+     * @param tokenClasses - Array of token class keys to query
+     * @returns Promise<TokenClassWithSupply[]> Array of token classes with supply information
+     * @throws {ValidationError} if tokenClasses array is empty
+     * @throws {Error} if network request fails or GalaChain returns error status
+     *
+     * @example
+     * ```typescript
+     * const supplies = await tokenService.fetchTokenClassesWithSupply([
+     *   { collection: 'GALA', category: 'Unit', type: 'none', additionalKey: 'none' },
+     *   { collection: 'GUSDC', category: 'Unit', type: 'none', additionalKey: 'eth:0x...' }
+     * ]);
+     *
+     * console.log(`${supplies[0].symbol}: ${supplies[0].totalSupply}`);
+     * ```
+     */
+    fetchTokenClassesWithSupply(tokenClasses: TokenClassKey[]): Promise<TokenClassWithSupply[]>;
+}
+//# sourceMappingURL=GalaChainTokenService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GalaChainTokenService.d.ts","sourceRoot":"","sources":["../../../src/services/GalaChainTokenService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,oBAAoB,EAErB,MAAM,wBAAwB,CAAC;AAEhC;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,WAAW;IAWlD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAV/B;;;;;;OAMG;gBAED,IAAI,EAAE,UAAU,EAChB,KAAK,GAAE,OAAe,EACL,WAAW,CAAC,EAAE,aAAa,YAAA;IAK9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAgFpF;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,2BAA2B,CAC/B,YAAY,EAAE,aAAa,EAAE,GAC5B,OAAO,CAAC,oBAAoB,EAAE,CAAC;CAmEnC"}

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

@@ -0,0 +1,205 @@
+/**
+ * GalaChain Transfer Service
+ *
+ * Service responsible for token transfer and burn operations on GalaChain.
+ * Extracted from GalaChainService for single responsibility.
+ *
+ * Features:
+ * - GALA transfers with EIP-712 signatures
+ * - Generic token transfers (launchpad and standard tokens)
+ * - Token burning (irreversible)
+ * - Token class key resolution
+ *
+ * @example
+ * ```typescript
+ * const transferService = new GalaChainTransferService(http, wallet, tokenResolver, debug);
+ *
+ * // Transfer GALA
+ * const txId = await transferService.transferGala({
+ *   recipientAddress: 'eth|1234567890abcdef1234567890abcdef12345678',
+ *   amount: '1'
+ * });
+ *
+ * // Transfer launchpad token
+ * const txId = await transferService.transferToken({
+ *   to: 'eth|9876543210fedcba9876543210fedcba98765432',
+ *   tokenName: 'tinyevil',
+ *   amount: '100000000'
+ * });
+ *
+ * // Burn tokens (IRREVERSIBLE)
+ * const result = await transferService.burnTokens({
+ *   tokens: [{ tokenName: 'anime', amount: '100' }]
+ * });
+ * ```
+ *
+ * @category Services
+ * @since 5.15.0
+ */
+import { Wallet } from 'ethers';
+import { HttpClient } from '../utils/http';
+import { TokenResolverService } from './TokenResolverService';
+import { TokenClassKey } from '../types/common';
+import { BaseService } from './BaseService';
+import { TransferGalaData, TransferTokenData } from '../types/transfer.dto';
+import { BurnTokensData, BurnTokensResult } from '../types/burn.dto';
+/**
+ * GalaChain Transfer Service
+ *
+ * Handles all token transfer and burn operations on GalaChain.
+ */
+export declare class GalaChainTransferService extends BaseService {
+    private readonly wallet;
+    private readonly tokenResolver;
+    private readonly signatureHelper;
+    /**
+     * Initialize GalaChain Transfer Service
+     *
+     * @param http - HTTP client configured for GalaChain gateway
+     * @param wallet - Ethers wallet for signing transactions (optional for read-only operations)
+     * @param tokenResolver - Token resolver service for vault address resolution
+     * @param debug - Enable debug logging (default: false)
+     */
+    constructor(http: HttpClient, wallet: Wallet | undefined, tokenResolver: TokenResolverService, debug?: boolean);
+    /**
+     * Transfer GALA tokens between wallets
+     *
+     * Creates and signs a TransferToken transaction for GALA using EIP-712
+     * signatures and submits it to the GalaChain gateway.
+     *
+     * @param data - Transfer data including recipient and amount
+     * @returns Promise<string> Transaction ID from successful transfer
+     *
+     * @example
+     * ```typescript
+     * const transactionId = await transferService.transferGala({
+     *   recipientAddress: 'eth|1234567890abcdef1234567890abcdef12345678',
+     *   amount: '1' // 1 GALA
+     * });
+     *
+     * console.log('GALA transfer successful:', transactionId);
+     * ```
+     *
+     * @throws {TransferError} When validation fails or transfer is rejected
+     */
+    transferGala(data: TransferGalaData): Promise<string>;
+    /**
+     * Transfer launchpad tokens between wallets
+     *
+     * Creates and signs a TransferToken transaction for launchpad tokens using
+     * EIP-712 signatures and submits it to the GalaChain gateway.
+     *
+     * @param data - Transfer data including recipient, token name, and amount
+     * @returns Promise<string> Transaction ID from successful transfer
+     *
+     * @example
+     * ```typescript
+     * const transactionId = await transferService.transferToken({
+     *   to: 'eth|9876543210fedcba9876543210fedcba98765432',
+     *   tokenName: 'tinyevil',
+     *   amount: '100000000'
+     * });
+     *
+     * console.log('Token transfer successful:', transactionId);
+     * ```
+     *
+     * @throws {TransferError} When validation fails or transfer is rejected
+     */
+    transferToken(data: TransferTokenData): Promise<string>;
+    /**
+     * Resolve token class key from token name
+     *
+     * Public method to resolve a token name to its tokenClassKey for caching or optimization patterns.
+     * Uses the same resolution logic as transferToken internally.
+     *
+     * @param tokenName - Token name to resolve (e.g., 'unicorn', 'tinyevil')
+     * @returns Promise<TokenClassKey> The resolved token class key object
+     *
+     * @example
+     * ```typescript
+     * const tokenClassKey = await transferService.resolveTokenClassKey('unicorn');
+     * // Returns: { collection: "Token", category: "Unit", type: "UNI", additionalKey: "eth:..." }
+     *
+     * // Can be cached and used later for direct transfers
+     * await transferService.transferToken({
+     *   to: 'eth|...',
+     *   tokenId: tokenClassKey, // Direct, no lookup
+     *   amount: '1'
+     * });
+     * ```
+     *
+     * @throws {TransferError} When token name cannot be resolved
+     */
+    resolveTokenClassKey(tokenName: string): Promise<TokenClassKey>;
+    /**
+     * Permanently burn tokens on GalaChain
+     *
+     * WARNING: THIS OPERATION IS IRREVERSIBLE
+     * Burned tokens cannot be recovered or recreated.
+     * This reduces the total supply of the token.
+     *
+     * Supports batch burning of multiple token types in a single transaction.
+     *
+     * @param data - Burn data containing tokens array with amounts
+     * @returns Result with transaction ID and burned token details
+     * @throws {BurnError} When validation fails or burn operation is rejected
+     *
+     * @example
+     * ```typescript
+     * // Burn a single token type
+     * const result = await transferService.burnTokens({
+     *   tokens: [{ tokenName: 'anime', amount: '100' }]
+     * });
+     *
+     * // Burn multiple token types in one transaction
+     * const result = await transferService.burnTokens({
+     *   tokens: [
+     *     { tokenName: 'anime', amount: '50' },
+     *     { tokenName: 'doge', amount: '25' }
+     *   ]
+     * });
+     * ```
+     */
+    burnTokens(data: BurnTokensData): Promise<BurnTokensResult>;
+    /**
+     * Validate GALA transfer data
+     */
+    private validateTransferGalaData;
+    /**
+     * Validate token transfer data
+     */
+    private validateTransferTokenData;
+    /**
+     * Validate burn tokens data
+     */
+    private validateBurnTokensData;
+    /**
+     * Resolve token name to tokenInstance object for transfers
+     * Uses TokenResolverService to get vault address, then parses it to extract tokenInstance components
+     */
+    private resolveTokenInstance;
+    /**
+     * Extract transaction ID from transfer response
+     * Handles both GalaChain format ({ Status: 1, Data: [...] }) and legacy format ({ transactionId: "..." })
+     *
+     * @param response Transfer response from GalaChain
+     * @param transferType Type of transfer for success message ("gala" or "token")
+     * @returns Transaction ID string
+     * @throws TransferError if transaction ID cannot be extracted
+     * @private
+     */
+    private extractTransactionIdFromResponse;
+    /**
+     * Extract burn result from GalaChain response
+     */
+    private extractBurnResult;
+    /**
+     * Handle transfer/lock/unlock errors with proper typing and context
+     */
+    private handleTransferError;
+    /**
+     * Handle burn operation errors
+     */
+    private handleBurnError;
+}
+//# sourceMappingURL=GalaChainTransferService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GalaChainTransferService.d.ts","sourceRoot":"","sources":["../../../src/services/GalaChainTransferService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAQ3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAI9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EAOlB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,gBAAgB,EAMjB,MAAM,mBAAmB,CAAC;AA+B3B;;;;GAIG;AACH,qBAAa,wBAAyB,SAAQ,WAAW;IAarD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAbhC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA8B;IAE9D;;;;;;;OAOG;gBAED,IAAI,EAAE,UAAU,EACC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,aAAa,EAAE,oBAAoB,EACpD,KAAK,GAAE,OAAe;IAUxB;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAkE3D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4F7D;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA0BrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoGjE;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAuBhC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAgDjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4C9B;;;OAGG;YACW,oBAAoB;IAoDlC;;;;;;;;;OASG;IACH,OAAO,CAAC,gCAAgC;IA+CxC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkE3B;;OAEG;IACH,OAAO,CAAC,eAAe;CAwCxB"}

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

@@ -7,8 +7,10 @@
  * @since 3.6.0
  */
 import { HttpClient } from '../utils/http';
+import { UpdateSocialLinksDto, UpdateSocialLinksResponse } from '../types/launchpad.dto';
 import { UploadImageByTokenNameOptions } from '../types/options.dto';
 import { BaseService } from './BaseService';
+import type { JwtAuth } from '../auth/JwtAuth';
 /**
  * Image Service Class
  *
@@ -68,15 +70,16 @@ export declare class ImageService extends BaseService {
      * Creates an ImageService instance
      *
      * @param http Configured HttpClient with authentication
+     * @param jwtAuth Optional JWT auth manager for authenticated uploads
      * @param debugMode Enable debug logging (default: false)
      *
      * @example
      * ```typescript
      * const httpClient = new HttpClient(config);
-     * const imageService = new ImageService(httpClient, true);
+     * const imageService = new ImageService(httpClient, jwtAuth, true);
      * ```
      */
-    constructor(http: HttpClient, debugMode?: boolean);
+    constructor(http: HttpClient, jwtAuth?: JwtAuth, debugMode?: boolean);
     /**
      * Uploads an image for a token pool
      *
@@ -91,8 +94,7 @@ export declare class ImageService extends BaseService {
      * - Aspect ratio: Square (1:1) recommended
      *
      * Security:
-     * - Automatic signature generation via wallet
-     * - Custom headers for authentication
+     * - **Requires JWT authentication** - call sdk.login() before using this method
      * - Server-side validation
      *
      * @param options Upload configuration object
@@ -101,7 +103,7 @@ export declare class ImageService extends BaseService {
      * @returns Promise resolving to image URL string (empty string if no URL returned)
      * @throws {ValidationError} If token name format is invalid
      * @throws {FileValidationError} If file doesn't meet requirements (size, format)
-     * @throws {ConfigurationError} If wallet not configured for signature generation
+     * @throws {ConfigurationError} If JWT auth is not configured (call sdk.login() first)
      * @throws {ConfigurationError} If FormData not supported in environment
      * @throws {ApiError} If upload fails due to network or server issues
      *
@@ -148,23 +150,37 @@ export declare class ImageService extends BaseService {
      *
      * @example Error handling
      * ```typescript
+     * import { getErrorMessage } from '../utils/error-utils';
+     *
      * try {
      *   const imageUrl = await service.uploadImageByTokenName({
      *     file: imageFile,
      *     tokenName: 'GUSDC'
      *   });
      *   console.log('Success:', imageUrl);
-     * } catch (error) {
+     * } catch (error: unknown) {
      *   if (error instanceof ValidationError) {
      *     console.error('Invalid token name:', error.message);
-     *   } else if (error.message.includes('FormData')) {
+     *   } else if (getErrorMessage(error).includes('FormData')) {
      *     console.error('Environment does not support file uploads');
      *   } else {
-     *     console.error('Upload failed:', error);
+     *     console.error('Upload failed:', getErrorMessage(error));
      *   }
      * }
      * ```
      */
     uploadImageByTokenName(options: UploadImageByTokenNameOptions): Promise<string>;
+    /**
+     * Updates token social media links
+     *
+     * Requires JWT authentication (pool owner only).
+     *
+     * @param options Update options containing tokenName and optional social URLs
+     * @returns Updated token metadata with social links
+     * @throws ValidationError if token name is invalid or JWT auth is not available
+     * @throws Error if user is not authorized to update this token
+     * @since 6.x.0
+     */
+    updateTokenSocials(options: UpdateSocialLinksDto): Promise<UpdateSocialLinksResponse>;
 }
 //# sourceMappingURL=ImageService.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ImageService.d.ts","sourceRoot":"","sources":["../../../src/services/ImageService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAM3C,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAIrE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAQ5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;;OAWG;gBACS,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,OAAe;IAIxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuFG;IACG,sBAAsB,CAC1B,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,MAAM,CAAC;CAgEnB"}
+{"version":3,"file":"ImageService.d.ts","sourceRoot":"","sources":["../../../src/services/ImageService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAM3C,OAAO,EAEL,oBAAoB,EACpB,yBAAyB,EAE1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAOrE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;;;OAYG;gBACS,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,SAAS,GAAE,OAAe;IAI3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwFG;IACG,sBAAsB,CAC1B,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,MAAM,CAAC;IA+ClB;;;;;;;;;;OAUG;IACG,kBAAkB,CACtB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,yBAAyB,CAAC;CA8BtC"}

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

@@ -30,10 +30,12 @@
  */
 import { HttpClient } from '../utils/http';
 import { PoolService } from './PoolService';
-import { CheckPoolOptions, PoolsResult, GraphDataResult, TokenDistributionResult, TokenBadgesResult } from '../types/launchpad.dto';
+import type { JwtAuth } from '../auth/JwtAuth';
+import { CheckPoolOptions, PoolsResult, GraphDataResult, TokenDistributionResult, TokenBadgesResult, UserHolderContext } from '../types/launchpad.dto';
 import { UploadImageByTokenNameOptions, FetchVolumeDataOptions, HasTokenBadgeOptions, FetchTradesOptions } from '../types/options.dto';
 import { TradesResult } from '../types/trade.dto';
-import { GetTokenListOptions, UserTokenListResult, UpdateProfileData, UploadProfileImageOptions } from '../types/user.dto';
+import { GetTradesOptions, TradesQueryResult } from '../types/trades-query.dto';
+import { GetTokenListOptions, UserTokenListResult, UpdateProfileData, UploadProfileImageOptions, GetManagedTokensOptions, ManagedTokensResult } from '../types/user.dto';
 /**
  * Launchpad Service (Facade Pattern)
  *
@@ -48,7 +50,16 @@ export declare class LaunchpadService {
     private readonly tradeService;
     private readonly userService;
     private readonly imageService;
-    constructor(http: HttpClient, debugMode?: boolean);
+    constructor(http: HttpClient, jwtAuth?: JwtAuth, debugMode?: boolean);
+    /**
+     * Set the JWT authentication manager for profile and image operations
+     *
+     * This allows dynamic configuration of JWT auth after service creation.
+     * Required for updateProfile, uploadProfileImage, and uploadImageByTokenName.
+     *
+     * @param jwtAuth - JWT auth manager instance
+     */
+    setJwtAuth(jwtAuth: JwtAuth): void;
     /**
      * Uploads an image for a token pool
      *
@@ -57,6 +68,18 @@ export declare class LaunchpadService {
      * @since 2.0.0
      */
     uploadImageByTokenName(options: UploadImageByTokenNameOptions): Promise<string>;
+    /**
+     * Updates token social media links
+     *
+     * Requires JWT authentication (pool owner only).
+     *
+     * @param options Update options containing tokenName and social URLs
+     * @returns Updated token metadata with social links
+     * @throws ValidationError if token name is invalid
+     * @throws Error if user is not authorized to update this token
+     * @since 6.x.0
+     */
+    updateTokenSocials(options: import('../types/launchpad.dto').UpdateSocialLinksDto): Promise<import('../types/launchpad.dto').UpdateSocialLinksResponse>;
     /**
      * Fetches pools with filtering and pagination
      *
@@ -73,7 +96,11 @@ export declare class LaunchpadService {
     fetchPools(options?: {
         search?: string;
         tokenName?: string;
-        type?: 'recent' | 'popular';
+        type?: 'recent' | 'popular' | 'recordings' | 'seconds_streamed';
+        hasUpcomingShows?: boolean;
+        language?: string;
+        recentlyStreamed?: number;
+        hasRecordings?: boolean;
         page?: number;
         limit?: number;
     }): Promise<PoolsResult>;
@@ -90,7 +117,11 @@ export declare class LaunchpadService {
     fetchAllPools(options?: {
         search?: string;
         tokenName?: string;
-        type?: 'recent' | 'popular';
+        type?: 'recent' | 'popular' | 'recordings' | 'seconds_streamed';
+        hasUpcomingShows?: boolean;
+        language?: string;
+        recentlyStreamed?: number;
+        hasRecordings?: boolean;
     }): Promise<PoolsResult>;
     /**
      * Checks if a pool exists for given token name or symbol
@@ -100,6 +131,18 @@ export declare class LaunchpadService {
      * @since 2.0.0
      */
     checkPool(options: CheckPoolOptions): Promise<boolean>;
+    /**
+     * Checks if a pool exists for given token name or symbol (alias for checkPool)
+     *
+     * Convenience method that accepts tokenName and/or symbol parameters.
+     * At least one parameter is required.
+     *
+     * @param tokenName Optional token name to check
+     * @param symbol Optional token symbol to check
+     * @returns Promise<boolean> True if pool exists, false otherwise
+     * @since 6.x.0
+     */
+    checkPoolExists(tokenName?: string, symbol?: string): Promise<boolean>;
     /**
      * Checks if a token name is available (convenience method)
      *
@@ -132,6 +175,15 @@ export declare class LaunchpadService {
      * @since 2.0.0
      */
     fetchTokenDistribution(tokenName: string): Promise<TokenDistributionResult>;
+    /**
+     * Get a specific user's holder context for a token
+     *
+     * @param tokenName Token name to check holdings for
+     * @param userAddress User address to lookup
+     * @returns Promise resolving to user holder context data
+     * @since 3.7.0
+     */
+    fetchUserHolderContext(tokenName: string, userAddress: string): Promise<UserHolderContext>;
     /**
      * Gets badge achievements for a token
      *
@@ -156,6 +208,18 @@ export declare class LaunchpadService {
      * @since 2.0.0
      */
     fetchTrades(options: FetchTradesOptions): Promise<TradesResult>;
+    /**
+     * Gets trades with flexible filtering (v6.2.0+)
+     *
+     * Public endpoint - no authentication required.
+     * Filter by tokenName, userAddress, or both.
+     * At least one filter is required.
+     *
+     * @param options Query options with tokenName and/or userAddress
+     * @returns Paginated list of trades with metadata
+     * @since 6.2.0
+     */
+    getTrades(options: GetTradesOptions): Promise<TradesQueryResult>;
     /**
      * Fetches user profile information
      *
@@ -209,6 +273,14 @@ export declare class LaunchpadService {
         search?: string;
         tokenName?: string;
     }): Promise<UserTokenListResult>;
+    /**
+     * Fetches all tokens the user can manage (owned + moderated + overseer status)
+     *
+     * @param options Optional pagination options
+     * @returns Promise<ManagedTokensResult> Managed tokens result
+     * @since 5.11.0
+     */
+    getManagedTokens(options?: GetManagedTokensOptions): Promise<ManagedTokensResult>;
     /**
      * Gets the authenticated user's address in backend format
      *

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

@@ -1 +1 @@
-{"version":3,"file":"LaunchpadService.d.ts","sourceRoot":"","sources":["../../../src/services/LaunchpadService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAI3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAOf,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,SAAgB,WAAW,EAAE,WAAW,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEf,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,OAAe;IAYzE;;;;;;OAMG;IACG,sBAAsB,CAC1B,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,MAAM,CAAC;IAQlB;;;;;;;;;;;;OAYG;IACG,UAAU,CACd,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GACL,OAAO,CAAC,WAAW,CAAC;IAIvB;;;;;;;;;OASG;IACG,aAAa,CACjB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;KAC7B,GACA,OAAO,CAAC,WAAW,CAAC;IAIvB;;;;;;OAMG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5D;;;;;;OAMG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D;;;;;;OAMG;IACG,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D;;;;;;OAMG;IACG,eAAe,CACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,eAAe,CAAC;IAI3B;;;;;;OAMG;IACG,sBAAsB,CAC1B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,CAAC;IAInC;;;;;;OAMG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIrE;;;;;;OAMG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpE;;;;;;OAMG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAQrE;;;;;;OAMG;IAEG,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAIlD;;;;;;OAMG;IACG,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D;;;;;;OAMG;IACG,kBAAkB,CACtB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC;IAQlB;;;;;;OAMG;IACG,cAAc,CAClB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAI/B;;;;;;OAMG;IACG,eAAe,CACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAI/B;;;;;;OAMG;IACG,kBAAkB,CACtB,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnF,OAAO,CAAC,mBAAmB,CAAC;IAQ/B;;;;;OAKG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;;;OAMG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAG3C"}
+{"version":3,"file":"LaunchpadService.d.ts","sourceRoot":"","sources":["../../../src/services/LaunchpadService.ts"],"names":[],"mappings":"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"}