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

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

@@ -0,0 +1,214 @@
+/**
+ * Token Ban Service
+ *
+ * Handles platform-wide token ban operations for overseers.
+ * Banned tokens are hidden from all listings and have actions blocked.
+ *
+ * This is different from BanService which handles per-token user bans.
+ * TokenBanService bans entire tokens from the platform (overseer-only),
+ * while BanService bans specific users from specific tokens (owner/admin).
+ *
+ * @category Services
+ * @since 6.x.0
+ */
+import { HttpClient } from '../utils/http';
+import { StreamTokenServiceBase } from './StreamTokenServiceBase';
+import type { JwtAuth } from '../auth/JwtAuth';
+import { BanTokenOptions, BanTokenResult, UnbanTokenOptions, UnbanTokenResult, ListTokenBansOptions, TokenBanListResult, GetTokenBanOptions, TokenBanStatusResult } from '../types/token-ban.dto';
+/**
+ * Token Ban Service Class
+ *
+ * Provides methods for managing platform-wide token bans:
+ * - Banning tokens (hides from all listings)
+ * - Unbanning tokens (restores visibility)
+ * - Listing all banned tokens
+ * - Checking ban status for specific tokens
+ *
+ * **Access Control**: All endpoints require either:
+ * - Admin API key (server-to-server)
+ * - JWT with overseer status (authenticated overseer user)
+ *
+ * **Effects of Token Bans**:
+ * - Hidden from ALL pool listings (including creator's profile)
+ * - Comments blocked on banned tokens
+ * - Live streaming blocked on banned tokens
+ * - Chat messages blocked on banned tokens
+ * - Trading NOT blocked (GalaChain handles trading independently)
+ *
+ * @remarks
+ * **Case Normalization**: Token names are automatically normalized to lowercase
+ * in all requests and responses for consistency.
+ *
+ * **Permanent Bans**: Token bans do not expire. They remain in effect until
+ * explicitly removed by an overseer.
+ *
+ * @example
+ * ```typescript
+ * const tokenBanService = new TokenBanService(httpClient, 'admin-api-key', jwtAuth, true);
+ *
+ * // Ban a token
+ * await tokenBanService.banToken({
+ *   tokenName: 'scamtoken',
+ *   reason: 'Fraudulent project - reported by multiple users'
+ * });
+ *
+ * // Check if a token is banned
+ * const status = await tokenBanService.isTokenBanned({ tokenName: 'sometoken' });
+ * if (status.banned) {
+ *   console.log('Token is banned:', status.ban?.reason);
+ * }
+ *
+ * // List all banned tokens
+ * const bans = await tokenBanService.listTokenBans({ page: 1, limit: 20 });
+ *
+ * // Unban a token
+ * await tokenBanService.unbanToken({ tokenName: 'scamtoken' });
+ * ```
+ */
+export declare class TokenBanService extends StreamTokenServiceBase {
+    constructor(http: HttpClient, adminApiKey?: string, jwtAuth?: JwtAuth, debugMode?: boolean);
+    /**
+     * Ban a token from the platform
+     *
+     * Dual-auth endpoint - supports both Admin API key and JWT (overseer) auth.
+     *
+     * When a token is banned:
+     * - Hidden from all pool listings
+     * - Hidden from creator's profile
+     * - Comments blocked
+     * - Live streaming blocked
+     * - Chat blocked
+     * - Trading still allowed (GalaChain handles)
+     *
+     * @param options - Ban options including tokenName and optional reason
+     * @returns Created ban data with token name
+     * @throws ValidationError if parameters are invalid
+     * @throws ConfigurationError if neither admin API key nor JWT is configured
+     * @throws Error if token is already banned (409 Conflict)
+     *
+     * @example
+     * ```typescript
+     * // Ban with reason
+     * const result = await tokenBanService.banToken({
+     *   tokenName: 'scamtoken',
+     *   reason: 'Fraudulent project - reported by multiple users'
+     * });
+     * console.log('Banned:', result.tokenName);
+     * console.log('Ban ID:', result.ban.id);
+     *
+     * // Ban without reason
+     * await tokenBanService.banToken({ tokenName: 'problematictoken' });
+     * ```
+     */
+    banToken(options: BanTokenOptions): Promise<BanTokenResult>;
+    /**
+     * Remove a ban from a token
+     *
+     * Dual-auth endpoint - supports both Admin API key and JWT (overseer) auth.
+     *
+     * When a token is unbanned:
+     * - Restored to all pool listings
+     * - Visible on creator's profile again
+     * - Comments re-enabled
+     * - Live streaming re-enabled
+     * - Chat re-enabled
+     *
+     * @param options - Unban options including tokenName
+     * @returns Removal confirmation with token name
+     * @throws ValidationError if token name is invalid
+     * @throws ConfigurationError if neither admin API key nor JWT is configured
+     * @throws Error if token is not banned (404 Not Found)
+     *
+     * @example
+     * ```typescript
+     * const result = await tokenBanService.unbanToken({ tokenName: 'scamtoken' });
+     * console.log('Removed ban:', result.removed); // true
+     * console.log('Token:', result.tokenName);
+     * ```
+     */
+    unbanToken(options: UnbanTokenOptions): Promise<UnbanTokenResult>;
+    /**
+     * List all banned tokens
+     *
+     * Dual-auth endpoint - supports both Admin API key and JWT (overseer) auth.
+     * Returns paginated results with ban details.
+     *
+     * @param options - List options including optional pagination and search
+     * @returns Paginated list of banned tokens
+     * @throws ValidationError if pagination parameters are invalid
+     * @throws ConfigurationError if neither admin API key nor JWT is configured
+     *
+     * @example
+     * ```typescript
+     * // Get first page with default limit (20)
+     * const page1 = await tokenBanService.listTokenBans({});
+     * console.log('Total banned tokens:', page1.meta.total);
+     *
+     * // Search for specific tokens
+     * const searchResults = await tokenBanService.listTokenBans({
+     *   search: 'scam',
+     *   page: 1,
+     *   limit: 10
+     * });
+     *
+     * // Paginate through all results
+     * let page = 1;
+     * let hasMore = true;
+     * while (hasMore) {
+     *   const results = await tokenBanService.listTokenBans({ page, limit: 20 });
+     *   console.log('Bans:', results.items);
+     *   hasMore = page < results.meta.totalPages;
+     *   page++;
+     * }
+     * ```
+     */
+    listTokenBans(options?: ListTokenBansOptions): Promise<TokenBanListResult>;
+    /**
+     * Get ban details for a specific token
+     *
+     * Dual-auth endpoint - supports both Admin API key and JWT (overseer) auth.
+     *
+     * Returns the ban record if the token is banned, or null if not banned.
+     * Use this to get full ban details including reason and who banned it.
+     *
+     * @param options - Options including tokenName
+     * @returns Ban data if banned, null if not banned
+     * @throws ValidationError if token name is invalid
+     * @throws ConfigurationError if neither admin API key nor JWT is configured
+     *
+     * @example
+     * ```typescript
+     * const status = await tokenBanService.getTokenBan({ tokenName: 'sometoken' });
+     * if (status.banned) {
+     *   console.log('Token is banned');
+     *   console.log('Reason:', status.ban?.reason);
+     *   console.log('Banned by:', status.ban?.bannedBy);
+     *   console.log('Banned at:', status.ban?.createdAt);
+     * } else {
+     *   console.log('Token is not banned');
+     * }
+     * ```
+     */
+    getTokenBan(options: GetTokenBanOptions): Promise<TokenBanStatusResult>;
+    /**
+     * Check if a token is banned (convenience method)
+     *
+     * Alias for getTokenBan() - provided for semantic clarity.
+     * Use when you just need to check if a token is banned.
+     *
+     * @param options - Options including tokenName
+     * @returns Ban status with full details if banned
+     * @throws ValidationError if token name is invalid
+     * @throws ConfigurationError if neither admin API key nor JWT is configured
+     *
+     * @example
+     * ```typescript
+     * const status = await tokenBanService.isTokenBanned({ tokenName: 'sometoken' });
+     * if (status.banned) {
+     *   console.log('Token is banned:', status.ban?.reason);
+     * }
+     * ```
+     */
+    isTokenBanned(options: GetTokenBanOptions): Promise<TokenBanStatusResult>;
+}
+//# sourceMappingURL=TokenBanService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TokenBanService.d.ts","sourceRoot":"","sources":["../../../src/services/TokenBanService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EASrB,MAAM,wBAAwB,CAAC;AAIhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,qBAAa,eAAgB,SAAQ,sBAAsB;gBAEvD,IAAI,EAAE,UAAU,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,OAAO,EACjB,SAAS,GAAE,OAAe;IAS5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAoCjE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoBvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuBpF;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsB7E;;;;;;;;;;;;;;;;;;OAkBG;IACG,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAGhF"}

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

@@ -1 +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;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAU3C;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;gBACtC,SAAS,GAAE,OAAe;IAItC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE;IAwC3D;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa;IAgBvD;;;;;;;;;;;;;;;;;;OAkBG;IACH,kBAAkB,IAAI,aAAa;IAcnC;;;;;;;;;;;;;OAaG;IACH,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IA0BzD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IA4CnD;;;;;;;;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;CAcF"}
+{"version":3,"file":"TokenClassKeyService.d.ts","sourceRoot":"","sources":["../../../src/services/TokenClassKeyService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAY3C;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;gBACtC,SAAS,GAAE,OAAe;IAItC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE;IAwC3D;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa;IAgBvD;;;;;;;;;;;;;;;;;;OAkBG;IACH,kBAAkB,IAAI,aAAa;IAcnC;;;;;;;;;;;;;OAaG;IACH,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IA0BzD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IA4CnD;;;;;;;;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;CAcF"}

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

@@ -12,14 +12,16 @@
  * @category Services
  * @since 3.9.2
  */
-import { LoggerBase } from './BaseService';
+import { AbstractCacheService, type BaseCacheStats } from './AbstractCacheService';
 /**
- * Token metadata cache entry
+ * Bonding curve cache entry
  *
- * Stores immutable token properties needed for local calculations.
+ * Stores immutable token properties needed for local bonding curve calculations.
  * All properties are optional - cache can be partially populated.
+ *
+ * @since 6.10.0 - Renamed from TokenMetadata for clarity (distinct from blockchain metadata)
  */
-export interface TokenMetadata {
+export interface BondingCurveCacheEntry {
     /** Minimum reverse bonding curve fee factor (0.0 - 1.0) */
     reverseBondingCurveMinFeeFactor?: number;
     /** Maximum reverse bonding curve fee factor (0.0 - 1.0) */
@@ -38,7 +40,7 @@ export interface TokenMetadata {
 /**
  * Cache statistics for monitoring and debugging
  */
-export interface CacheStats {
+export interface CacheStats extends BaseCacheStats {
     /** Total number of tokens in cache */
     totalTokens: number;
     /** Approximate cache size in bytes */
@@ -91,11 +93,19 @@ export interface CacheStats {
  * @category Services
  * @since 3.9.2
  */
-export declare class TokenMetadataCache extends LoggerBase {
+export declare class TokenMetadataCache extends AbstractCacheService<string, BondingCurveCacheEntry, CacheStats> {
     /** Maximum cache size (10,000 tokens ≈ 2.5MB max memory) */
     private static readonly MAX_CACHE_SIZE;
-    private cache;
     constructor(debugMode?: boolean);
+    /**
+     * Normalize token name for consistent cache keys
+     *
+     * Handles edge cases: unicode control chars, multiple spaces, case insensitivity.
+     *
+     * @param tokenName Raw token name
+     * @returns Normalized token name (lowercase, trimmed, cleaned)
+     */
+    protected normalizeKey(tokenName: string): string;
     /**
      * Get least recently updated entry for LRU eviction
      *
@@ -106,16 +116,6 @@ export declare class TokenMetadataCache extends LoggerBase {
      * @private
      */
     private getLRUKey;
-    /**
-     * Normalize token name for consistent cache keys
-     *
-     * Handles edge cases: unicode control chars, multiple spaces, case insensitivity.
-     *
-     * @param tokenName Raw token name
-     * @returns Normalized token name (lowercase, trimmed, cleaned)
-     * @private
-     */
-    private normalizeTokenName;
     /**
      * Update cache entry with LRU management
      *
@@ -150,7 +150,7 @@ export declare class TokenMetadataCache extends LoggerBase {
      * });
      * ```
      */
-    warmFromPoolData(tokenName: string, poolData: Partial<TokenMetadata>): void;
+    warmFromPoolData(tokenName: string, poolData: Partial<BondingCurveCacheEntry>): void;
     /**
      * Set or update cache entry for a token
      *
@@ -166,22 +166,22 @@ export declare class TokenMetadataCache extends LoggerBase {
      * });
      * ```
      */
-    set(tokenName: string, metadata: Partial<TokenMetadata>): void;
+    set(tokenName: string, metadata: Partial<BondingCurveCacheEntry>): void;
     /**
      * Get cached metadata for a token
      *
      * @param tokenName Token name (normalized to lowercase)
-     * @returns Cached metadata or null if not cached
+     * @returns Cached metadata or undefined if not cached
      *
      * @example Retrieving cached data
      * ```typescript
-     * const metadata = cache.get('anime');
+     * const metadata = cache.getByName('anime');
      * if (metadata?.reverseBondingCurveMaxFeeFactor) {
      *   console.log('RBC max fee:', metadata.reverseBondingCurveMaxFeeFactor);
      * }
      * ```
      */
-    get(tokenName: string): TokenMetadata | null;
+    getByName(tokenName: string): BondingCurveCacheEntry | undefined;
     /**
      * Get maxSupply for a token (returns cached or default constant)
      *
@@ -231,12 +231,12 @@ export declare class TokenMetadataCache extends LoggerBase {
      *
      * @example Dump cache for debugging
      * ```typescript
-     * const cacheData = cache.dump();
+     * const cacheData = cache.dumpAsObject();
      * console.log('Cached tokens:', Object.keys(cacheData));
      * console.log('Cache contents:', JSON.stringify(cacheData, null, 2));
      * ```
      */
-    dump(): Record<string, TokenMetadata>;
+    dumpAsObject(): Record<string, BondingCurveCacheEntry>;
     /**
      * Get cache statistics
      *
@@ -254,7 +254,16 @@ export declare class TokenMetadataCache extends LoggerBase {
      * console.log(`Oldest entry: ${new Date(stats.oldestEntry).toISOString()}`);
      * ```
      */
-    stats(): CacheStats;
+    getStats(): CacheStats;
+    /**
+     * Calculate cache size in bytes and find oldest entry
+     *
+     * Helper method for getStats() - O(n) iteration over all entries.
+     *
+     * @returns Object with cacheSize (bytes) and oldestEntry (timestamp)
+     * @private
+     */
+    private calculateCacheSizeAndAge;
     /**
      * Get cached metadata by tokenId (DEX token format)
      *
@@ -272,7 +281,7 @@ export declare class TokenMetadataCache extends LoggerBase {
      * }
      * ```
      */
-    getByTokenId(tokenId: string): TokenMetadata | null;
+    getByTokenId(tokenId: string): BondingCurveCacheEntry | null;
     /**
      * Set or update cache entry by tokenId (DEX token format)
      *
@@ -289,7 +298,7 @@ export declare class TokenMetadataCache extends LoggerBase {
      * });
      * ```
      */
-    setByTokenId(tokenId: string, metadata: Partial<TokenMetadata>): void;
+    setByTokenId(tokenId: string, metadata: Partial<BondingCurveCacheEntry>): void;
     /**
      * Check if a tokenId exists in cache (DEX token format)
      *

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

@@ -1 +1 @@
-{"version":3,"file":"TokenMetadataCache.d.ts","sourceRoot":"","sources":["../../../src/services/TokenMetadataCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC,2DAA2D;IAC3D,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC,uDAAuD;IACvD,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAS;IAE/C,OAAO,CAAC,KAAK,CAAoC;gBAErC,SAAS,GAAE,OAAe;IAItC;;;;;;;;OAQG;IACH,OAAO,CAAC,SAAS;IAKjB;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAK3E;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAK9D;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAK5C;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAQvC;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAK/B;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAS/B;;;;;;;;;;;;;OAaG;IACH,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;IAQrC;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,IAAI,UAAU;IAwCnB;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAKnD;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAKrE;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAIvC"}
+{"version":3,"file":"TokenMetadataCache.d.ts","sourceRoot":"","sources":["../../../src/services/TokenMetadataCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGnF;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC,2DAA2D;IAC3D,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC,uDAAuD;IACvD,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBAAa,kBAAmB,SAAQ,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,EAAE,UAAU,CAAC;IACtG,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAEnC,SAAS,GAAE,OAAe;IAItC;;;;;;;OAOG;IACH,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAOjD;;;;;;;;OAQG;IACH,OAAO,CAAC,SAAS;IAMjB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI;IAKpF;;;;;;;;;;;;;;OAcG;IACI,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI;IAK9E;;;;;;;;;;;;;OAaG;IACI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAKvE;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAQvC;;;;;OAKG;IACI,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAKtC;;;;;;;;;;;;;;OAcG;IACI,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAStC;;;;;;;;;;;;;OAaG;IACI,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC;IAQ7D;;;;;;;;;;;;;;;;OAgBG;IACI,QAAQ,IAAI,UAAU;IAY7B;;;;;;;OAOG;IACH,OAAO,CAAC,wBAAwB;IAuChC;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAK5D;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI;IAK9E;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAIvC"}

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

@@ -79,19 +79,39 @@
  */
 import { LoggerBase } from './BaseService';
 import type { TokenClass } from '../types/gswap.dto';
-export interface TokenMetadata {
+/**
+ * Blockchain-verified token metadata from GalaChain
+ *
+ * Contains authoritative token properties fetched from the blockchain,
+ * distinct from bonding curve cache entries or bridge metadata.
+ *
+ * @since 6.10.0 - Renamed from TokenMetadata for clarity
+ */
+export interface BlockchainTokenMetadata {
+    /** Official token symbol from blockchain (e.g., "ANIME", "GALA") */
     symbol: string;
+    /** Token full name (optional) */
     name?: string;
+    /** Token decimal places (e.g., 8 for GALA, 18 for WETH) */
     decimals: number;
+    /** Token collection (e.g., "Token", "GALA") */
     collection: string;
+    /** Token category (e.g., "Unit") */
     category: string;
+    /** Token type (e.g., "ANIME", "none") */
     type: string;
+    /** Additional identifier (e.g., chain/address, "none") */
     additionalKey: string;
+    /** Whether token is Gala-verified */
     verified: boolean;
 }
-export interface TokenMetadataCache {
+/**
+ * Internal cache structure for blockchain token metadata
+ * @internal
+ */
+export interface BlockchainTokenMetadataCache {
     [key: string]: {
-        data: TokenMetadata;
+        data: BlockchainTokenMetadata;
         timestamp: number;
     };
 }
@@ -190,7 +210,7 @@ export declare class TokenMetadataService extends LoggerBase {
      * @category Metadata Resolution
      * @since 3.0.0
      */
-    resolveTokenMetadata(token: string | TokenClass): Promise<TokenMetadata>;
+    resolveTokenMetadata(token: string | TokenClass): Promise<BlockchainTokenMetadata>;
     /**
      * Get token symbol from blockchain
      *

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

@@ -1 +1 @@
-{"version":3,"file":"TokenMetadataService.d.ts","sourceRoot":"","sources":["../../../src/services/TokenMetadataService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG;QACb,IAAI,EAAE,aAAa,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,WAAW,CAAmB;gBAE1B,SAAS,GAAE,OAAe;IAItC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0FG;IACG,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAyB9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAKjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuDG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAUnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;IAQpD;;;OAGG;IAEH,OAAO,CAAC,WAAW;IAYnB;;;;;;;OAOG;IAEH,OAAO,CAAC,eAAe;IAyDvB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAItB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAIjC"}
+{"version":3,"file":"TokenMetadataService.d.ts","sourceRoot":"","sources":["../../../src/services/TokenMetadataService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKrD;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,CAAC,GAAG,EAAE,MAAM,GAAG;QACb,IAAI,EAAE,uBAAuB,CAAC;QAC9B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,WAAW,CAAmB;gBAE1B,SAAS,GAAE,OAAe;IAItC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0FG;IACG,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAyBxF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAKjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuDG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAUnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;IAQpD;;;OAGG;IAEH,OAAO,CAAC,WAAW;IAYnB;;;;;;;OAOG;IAEH,OAAO,CAAC,eAAe;IAyDvB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAItB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAIjC"}

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

@@ -1 +1 @@
-{"version":3,"file":"TokenResolverService.d.ts","sourceRoot":"","sources":["../../../src/services/TokenResolverService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKrD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;IActC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAbxC;;;;OAIG;IACH,OAAO,CAAC,KAAK,CAA6B;IAE1C;;;;;OAKG;gBAC0B,WAAW,EAAE,WAAW,EAAE,SAAS,GAAE,OAAe;IAIjF;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmCpE;;;;;;;;;;;;;;;;;;OAkBG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAerE;;;;;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;CAkBzC"}
+{"version":3,"file":"TokenResolverService.d.ts","sourceRoot":"","sources":["../../../src/services/TokenResolverService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMrD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;IActC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAbxC;;;;OAIG;IACH,OAAO,CAAC,KAAK,CAA6B;IAE1C;;;;;OAKG;gBAC0B,WAAW,EAAE,WAAW,EAAE,SAAS,GAAE,OAAe;IAIjF;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA+BpE;;;;;;;;;;;;;;;;;;OAkBG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAerE;;;;;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;CAkBzC"}

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

@@ -10,6 +10,7 @@ import { BaseService } from './BaseService';
 import { HttpClient } from '../utils/http';
 import { TradesResult } from '../types/trade.dto';
 import { FetchTradesOptions } from '../types/options.dto';
+import { GetTradesOptions, TradesQueryResult } from '../types/trades-query.dto';
 /**
  * Trade Service Class
  *
@@ -207,5 +208,77 @@ export declare class TradeService extends BaseService {
      * ```
      */
     fetchTrades(options: FetchTradesOptions): Promise<TradesResult>;
+    /**
+     * Build query parameters for trades endpoint
+     */
+    private buildTradesQueryParams;
+    /**
+     * Get trades with flexible filtering (v6.2.0+)
+     *
+     * Public endpoint - no authentication required.
+     * Filter by tokenName, userAddress, or both.
+     * At least one filter is required.
+     *
+     * This is the unified trades endpoint that replaces the legacy
+     * token-only fetchTrades method for more flexible querying.
+     *
+     * @param options Query options with tokenName and/or userAddress
+     * @returns Paginated list of trades with metadata
+     * @throws ValidationError if neither tokenName nor userAddress provided
+     * @throws ValidationError if options contain invalid values
+     *
+     * @category Trade Operations
+     * @since 6.2.0
+     *
+     * @example Get all trades for a token
+     * ```typescript
+     * const { trades, meta } = await tradeService.getTrades({
+     *   tokenName: 'anime'
+     * });
+     * console.log(`Found ${meta.totalItems} trades`);
+     * trades.forEach(trade => {
+     *   console.log(`${trade.txnType}: ${trade.inputAmount} -> ${trade.outputAmount}`);
+     * });
+     * ```
+     *
+     * @example Get all trades by a user
+     * ```typescript
+     * const { trades, meta } = await tradeService.getTrades({
+     *   userAddress: 'eth|1234567890abcdef...'
+     * });
+     * console.log(`User has ${meta.totalItems} trades across all tokens`);
+     * ```
+     *
+     * @example Get a user's trades on a specific token with pagination
+     * ```typescript
+     * const { trades, meta } = await tradeService.getTrades({
+     *   tokenName: 'anime',
+     *   userAddress: 'eth|1234567890abcdef...',
+     *   page: 2,
+     *   limit: 20
+     * });
+     * console.log(`Page ${meta.currentPage} of ${meta.totalPages}`);
+     * ```
+     *
+     * @example Calculate trading volume for a user
+     * ```typescript
+     * const result = await tradeService.getTrades({
+     *   userAddress: 'eth|1234567890abcdef...',
+     *   limit: 50
+     * });
+     *
+     * let totalBought = 0;
+     * let totalSold = 0;
+     * for (const trade of result.trades) {
+     *   if (trade.txnType === 'BUY') {
+     *     totalBought += trade.outputAmount;
+     *   } else {
+     *     totalSold += trade.inputAmount;
+     *   }
+     * }
+     * console.log(`Bought: ${totalBought} tokens, Sold: ${totalSold} tokens`);
+     * ```
+     */
+    getTrades(options: GetTradesOptions): Promise<TradesQueryResult>;
 }
 //# sourceMappingURL=TradeService.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"TradeService.d.ts","sourceRoot":"","sources":["../../../src/services/TradeService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAO3C,OAAO,EAEL,YAAY,EAEb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAwB,MAAM,sBAAsB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;;OAWG;gBACS,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,OAAe;IAIxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoIG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;CA2DtE"}
+{"version":3,"file":"TradeService.d.ts","sourceRoot":"","sources":["../../../src/services/TradeService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAY3C,OAAO,EAEL,YAAY,EAEb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,kBAAkB,EAAwB,MAAM,sBAAsB,CAAC;AAChF,OAAO,EACL,gBAAgB,EAEhB,iBAAiB,EAGlB,MAAM,2BAA2B,CAAC;AAGnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;;OAWG;gBACS,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,OAAe;IAIxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoIG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAyDrE;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4C9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkEG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAgBvE"}

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

@@ -9,7 +9,8 @@
  */
 import { HttpClient } from '../utils/http';
 import { BaseService } from './BaseService';
-import { GetTokenListOptions, UserTokenListResult, UpdateProfileData, UploadProfileImageOptions } from '../types/user.dto';
+import type { JwtAuth } from '../auth/JwtAuth';
+import { GetTokenListOptions, UserTokenListResult, UpdateProfileData, UploadProfileImageOptions, GetManagedTokensOptions, ManagedTokensResult } from '../types/user.dto';
 /**
  * User Service Class
  *
@@ -25,7 +26,7 @@ import { GetTokenListOptions, UserTokenListResult, UpdateProfileData, UploadProf
  * // Get user profile
  * const profile = await userService.fetchProfile();
  *
- * // Update profile
+ * // Update profile (requires JWT auth - call sdk.login() first)
  * await userService.updateProfile({
  *   profileImage: "https://example.com/avatar.jpg",
  *   fullName: "John Doe",
@@ -34,7 +35,7 @@ import { GetTokenListOptions, UserTokenListResult, UpdateProfileData, UploadProf
  * ```
  */
 export declare class UserService extends BaseService {
-    constructor(http: HttpClient, debugMode?: boolean);
+    constructor(http: HttpClient, jwtAuth?: JwtAuth, debugMode?: boolean);
     /**
      * Fetch user profile information from launchpad backend
      *
@@ -64,6 +65,8 @@ export declare class UserService extends BaseService {
     /**
      * Updates user profile information
      *
+     * **Requires JWT authentication** - call sdk.login() before using this method.
+     *
      * **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.
@@ -71,15 +74,19 @@ export declare class UserService extends BaseService {
      * @param data Profile update data
      * @returns Promise<void> No return data - throws on failure
      * @throws ValidationError if input validation fails
+     * @throws ConfigurationError if JWT auth is not configured
      * @throws Error if profile update fails
      */
     updateProfile(data: UpdateProfileData): Promise<void>;
     /**
      * Uploads a profile image and returns the image URL
      *
+     * **Requires JWT authentication** - call sdk.login() before using this method.
+     *
      * @param options Profile image upload options
      * @returns Promise<string> Clean image URL
      * @throws ValidationError if input validation fails
+     * @throws ConfigurationError if JWT auth is not configured
      * @throws Error if upload fails
      */
     uploadProfileImage(options: UploadProfileImageOptions): Promise<string>;
@@ -195,6 +202,52 @@ export declare class UserService extends BaseService {
         search?: string;
         tokenName?: string;
     }): Promise<UserTokenListResult>;
+    /**
+     * Get all tokens the authenticated user can manage
+     *
+     * Returns a comprehensive view of the user's management capabilities:
+     * - **ownedTokens**: Tokens the user created (full OWNER access)
+     * - **moderatedTokens**: Tokens with moderator access via claimed invites
+     * - **isOverseer**: Whether user has platform-wide overseer access
+     * - **overseerSince**: When user became overseer (if applicable)
+     *
+     * This is used by the /moderators dashboard page to show all tokens
+     * a user can access in Studio.
+     *
+     * **Requires JWT authentication** - call sdk.login() before using this method.
+     *
+     * @param options Optional pagination options (page, limit)
+     * @returns ManagedTokensResult with owned tokens, moderated tokens, and overseer status
+     * @throws ConfigurationError if JWT auth is not configured
+     * @throws ValidationError if pagination parameters are invalid
+     *
+     * @since 5.11.0
+     *
+     * @example
+     * ```typescript
+     * const managed = await userService.getManagedTokens();
+     *
+     * console.log(`Owned tokens: ${managed.ownedTokensCount}`);
+     * console.log(`Moderated tokens: ${managed.moderatedTokensCount}`);
+     * console.log(`Is overseer: ${managed.isOverseer}`);
+     *
+     * // List owned tokens with Studio links
+     * managed.ownedTokens.forEach(token => {
+     *   console.log(`${token.tokenName} - ${token.isLive ? 'LIVE' : 'offline'}`);
+     * });
+     *
+     * // List moderated tokens with role info
+     * managed.moderatedTokens.forEach(token => {
+     *   console.log(`${token.tokenName} - ${token.role} (${token.inviteScope})`);
+     * });
+     *
+     * // Check overseer status
+     * if (managed.isOverseer) {
+     *   console.log(`Overseer since: ${managed.overseerSince}`);
+     * }
+     * ```
+     */
+    getManagedTokens(options?: GetManagedTokensOptions): Promise<ManagedTokensResult>;
     /**
      * Builds and executes a token fetch request with consistent error handling and normalization
      *