@gala-chain/launchpad-sdk 4.0.3 → 4.0.4-beta.1

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

@@ -36,11 +36,29 @@ import { GetTokenListOptions, UserTokenListResult, UpdateProfileData, UploadProf
 export declare class UserService extends BaseService {
     constructor(http: HttpClient, debugMode?: boolean);
     /**
-     * Fetches user profile information
+     * Fetch user profile information from launchpad backend
      *
-     * @param address Optional wallet address (defaults to SDK wallet address)
-     * @returns Promise<any> User profile information
-     * @throws ValidationError if input validation fails
+     * Retrieves complete profile data including display name, avatar, token statistics,
+     * and social links. If no address is provided, fetches profile for the authenticated wallet.
+     *
+     * @param address Optional wallet address in eth|[40-hex-chars] format (defaults to SDK wallet)
+     * @returns Promise<any> User profile data including name, image, bio, and token stats
+     * @throws ValidationError if address format is invalid
+     * @category User Management
+     * @since 2.0.0
+     *
+     * @example Fetch authenticated user's profile
+     * ```typescript
+     * const profile = await userService.fetchProfile();
+     * console.log('User:', profile.data.fullName);
+     * console.log('Avatar:', profile.data.profileImage);
+     * ```
+     *
+     * @example Fetch another user's profile
+     * ```typescript
+     * const otherProfile = await userService.fetchProfile('eth|1234567890abcdef...');
+     * console.log('User:', otherProfile.data.fullName);
+     * ```
      */
     fetchProfile(address?: string): Promise<any>;
     /**
@@ -66,26 +84,110 @@ export declare class UserService extends BaseService {
      */
     uploadProfileImage(options: UploadProfileImageOptions): Promise<string>;
     /**
-     * Fetches user token list with optional filtering and pagination
+     * Fetch paginated token list for a user with filtering
      *
-     * @param options Filtering and pagination options
-     * @returns Promise<UserTokenListResult> Clean token list with proper types
-     * @throws Error if request fails
+     * Queries user's token holdings or created tokens with optional search and pagination.
+     * Supports both exact tokenName matching (fast) and fuzzy search across all fields.
+     *
+     * @param options Filtering and pagination options (address, search, tokenName, type, page, limit)
+     * @returns Promise<UserTokenListResult> Paginated token list with metadata and navigation flags
+     * @throws ValidationError if pagination or filter parameters are invalid
+     * @category User Management
+     * @since 2.0.0
+     *
+     * @example Search user's token holdings
+     * ```typescript
+     * const tokens = await userService.fetchTokenList({
+     *   address: 'eth|1234...',
+     *   search: 'dragon',
+     *   type: 'DEFI',
+     *   page: 1,
+     *   limit: 20
+     * });
+     * console.log(`Found ${tokens.total} matching tokens`);
+     * ```
+     *
+     * @example Exact token lookup (fastest)
+     * ```typescript
+     * const result = await userService.fetchTokenList({
+     *   tokenName: 'anime',
+     *   limit: 1
+     * });
+     * // Reduces payload by ~99% vs search
+     * ```
      */
     fetchTokenList(options: GetTokenListOptions): Promise<UserTokenListResult>;
     /**
-     * Fetches tokens held by user (balances)
+     * Fetch tokens currently held by a user (non-zero balances)
      *
-     * @param options Token held filtering options (address is optional)
-     * @returns Promise<UserTokenListResult> Clean tokens held with full pagination
-     * @throws ValidationError if input validation fails
+     * Retrieves all tokens where the user has a non-zero balance, with optional filtering.
+     * Useful for portfolio displays and wallet balance summaries. If no address is provided,
+     * defaults to the authenticated wallet.
+     *
+     * **Performance Tip**: Use exact tokenName match instead of search to reduce payload by ~99%.
+     *
+     * @param options Token held filtering options (address defaults to authenticated wallet)
+     * @returns Promise<UserTokenListResult> Paginated list of held tokens with balances
+     * @throws ValidationError if address format or pagination parameters are invalid
+     * @category User Management
+     * @since 2.0.0
+     *
+     * @example Get authenticated user's portfolio
+     * ```typescript
+     * const holdings = await userService.fetchTokensHeld({
+     *   page: 1,
+     *   limit: 50
+     * });
+     * console.log(`User holds ${holdings.total} different tokens`);
+     * holdings.tokens.forEach(token => {
+     *   console.log(`${token.tokenName}: ${token.balance}`);
+     * });
+     * ```
+     *
+     * @example Check specific token balance
+     * ```typescript
+     * const result = await userService.fetchTokensHeld({
+     *   tokenName: 'anime',
+     *   limit: 1
+     * });
+     * const hasToken = result.tokens.length > 0;
+     * ```
      */
     fetchTokensHeld(options: GetTokenListOptions): Promise<UserTokenListResult>;
     /**
-     * Fetches tokens created by user
+     * Fetch tokens created by the authenticated user
+     *
+     * Retrieves all tokens launched by the currently authenticated wallet, with optional
+     * search filtering. Automatically uses the wallet address from SDK configuration.
+     *
+     * **Use Cases**: Creator dashboards, portfolio tracking, launch history
+     *
+     * @param options Pagination and search options (page, limit, search, tokenName)
+     * @returns Promise<UserTokenListResult> Paginated list of user-created tokens
+     * @throws ValidationError if wallet is not configured or pagination parameters invalid
+     * @category User Management
+     * @since 2.0.0
+     *
+     * @example Get all tokens created by user
+     * ```typescript
+     * const created = await userService.fetchTokensCreated({
+     *   page: 1,
+     *   limit: 20
+     * });
+     * console.log(`User created ${created.total} tokens`);
+     * created.tokens.forEach(token => {
+     *   console.log(`${token.tokenName}: ${token.marketCap} market cap`);
+     * });
+     * ```
      *
-     * @param options Options including pagination
-     * @returns Promise<UserTokenListResult> Tokens created by the user
+     * @example Search user's created tokens
+     * ```typescript
+     * const searchResult = await userService.fetchTokensCreated({
+     *   search: 'dragon',
+     *   limit: 10
+     * });
+     * console.log(`Found ${searchResult.tokens.length} tokens matching "dragon"`);
+     * ```
      */
     fetchTokensCreated(options?: {
         page?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"UserService.d.ts","sourceRoot":"","sources":["../../../src/services/UserService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAU3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EAEjB,yBAAyB,EAO1B,MAAM,mBAAmB,CAAC;AAQ3B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,OAAe;IAIxD;;;;;;OAMG;IAEG,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAyBlD;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyD3D;;;;;;;OAOG;IACG,kBAAkB,CACtB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC;IAqElB;;;;;;OAMG;IACG,cAAc,CAClB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAO/B;;;;;;OAMG;IACG,eAAe,CACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAO/B;;;;;OAKG;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;IA4B/B;;;;;;;;;;;;;;;;OAgBG;YACW,iBAAiB;IAwD/B;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAuCnC;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAkBjC;;;;OAIG;IACH,OAAO,CAAC,iCAAiC;CAW1C"}
+{"version":3,"file":"UserService.d.ts","sourceRoot":"","sources":["../../../src/services/UserService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAU3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EAEjB,yBAAyB,EAO1B,MAAM,mBAAmB,CAAC;AAQ3B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,OAAe;IAIxD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IAEG,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAyBlD;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyD3D;;;;;;;OAOG;IACG,kBAAkB,CACtB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC;IAqElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,cAAc,CAClB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAO/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,eAAe,CACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAO/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;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;IA4B/B;;;;;;;;;;;;;;;;OAgBG;YACW,iBAAiB;IAwD/B;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAuCnC;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAkBjC;;;;OAIG;IACH,OAAO,CAAC,iCAAiC;CAW1C"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gala-chain/launchpad-sdk",
-  "version": "4.0.3",
-  "description": "TypeScript SDK for Gala Launchpad Backend API - 72 methods supporting optional wallet (read-only and full-access modes). Production-ready DeFi token launchpad integration with AgentConfig setup, GalaChain trading, GSwap DEX integration, price history, token creation, DEX pool discovery, WebSocket event watchers, and comprehensive user operations. Multi-format output (ESM, CJS, UMD).",
+  "version": "4.0.4-beta.1",
+  "description": "TypeScript SDK for Gala Launchpad Backend API - 100+ public methods with 373+ fully documented APIs supporting optional wallet (read-only and full-access modes). Production-ready DeFi token launchpad integration with AgentConfig setup, GalaChain trading, GSwap DEX integration, price history, token creation, DEX pool discovery, WebSocket event watchers, and comprehensive user operations. Multi-format output (ESM, CJS, UMD).",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
   "types": "dist/index.d.ts",
@@ -45,6 +45,13 @@
     "demo:authenticated": "tsx examples/core/authenticated-operations.ts",
     "demo:privatekey-override": "tsx examples/core/privatekey-override-pattern.ts",
     "demo:trades": "tsx examples/bonding-curve/basic-trading.ts",
+    "demo:bonding:orchestrator": "tsx examples/bonding-curve/orchestrator.ts",
+    "demo:bonding:graduation": "tsx examples/bonding-curve/graduation-workflow.ts",
+    "demo:bonding:pool-discovery": "tsx examples/bonding-curve/pool-discovery.ts",
+    "demo:bonding:pool-analysis": "tsx examples/bonding-curve/pool-analysis.ts",
+    "demo:bonding:price-impact": "tsx examples/bonding-curve/price-impact.ts",
+    "demo:bonding:token-launch": "tsx examples/bonding-curve/token-launch.ts",
+    "demo:bonding:volume-trading": "tsx examples/bonding-curve/volume-trading.ts",
     "demo:liquidity": "tsx examples/liquidity/positions-cli.ts",
     "demo:liquidity:all": "tsx examples/liquidity/orchestrator.ts",
     "demo:liquidity:detailed": "tsx examples/liquidity/detailed.ts",
@@ -55,6 +62,9 @@
     "demo:liquidity:fetch-all": "tsx examples/liquidity/demo-fetch-all-positions.ts",
     "demo:liquidity:positions-with-prices": "tsx examples/liquidity/demo-positions-with-chunked-pricing.ts",
     "demo:cache": "tsx examples/utilities/demo-cache.ts",
+    "demo:utilities:balance": "tsx examples/utilities/balance.ts",
+    "demo:utilities:balances": "tsx examples/utilities/balances.ts",
+    "demo:utilities:price-history": "tsx examples/utilities/price-history.ts",
     "demo:dex": "tsx examples/dex/swap-workflow.ts",
     "demo:dex:pools": "tsx examples/dex/pool-discovery.ts",
     "demo:dex:pricing": "tsx examples/dex/pools-with-pricing.ts",