@gala-chain/launchpad-sdk 4.0.5 → 4.0.7-beta.1

package/README.md

@@ -1,6 +1,6 @@
 # Gala Launchpad SDK
 
-**Version: 4.0.4-beta.0 (Beta)**
+**Version: 4.0.5 (Latest Stable) | 4.0.4-beta.1 (Beta)**
 
 A comprehensive TypeScript SDK for the Gala Launchpad Backend API, providing type-safe authentication, trading, and real-time features for DeFi applications.
 
@@ -2138,8 +2138,21 @@ executeSwap(fromToken, toToken, amount, estimatedOutput, feeTier, slippageTolera
 
 // GSwap User Operations
 getSwapUserAssets(walletAddress): Promise<UserAsset[]>
-// Returns: [{ tokenId, symbol, balance, decimals }, ...]
-// Get user token balances across all DEX pools
+// Returns: [{ tokenId, symbol, name, description, image, balance, decimals, verified, compositeKey }, ...]
+// Get user token balances with rich metadata (v4.1.0+)
+
+getAllSwapUserAssets(walletAddress): Promise<UserAsset[]>
+// Returns: All user tokens with rich metadata (auto-paginated)
+// Optimized: Stops fetching when zero-balance tokens encountered
+
+// Token Discovery (no wallet required)
+fetchAvailableDexTokens({ search?, limit?, page? }): Promise<AvailableDexTokensResult>
+// Returns: { tokens: DexToken[], count, page, limit, hasMore }
+// Paginated token discovery with rich metadata
+
+fetchAllAvailableDexTokens({ search? }): Promise<DexToken[]>
+// Returns: All available DEX tokens (auto-paginated)
+// Use for comprehensive token catalogs and listings
 
 getSwapPoolInfo(tokenA, tokenB): Promise<PoolInfo>
 // Returns: { tokenA, tokenB, liquidity, feeTiers, swapCount }
@@ -2196,12 +2209,25 @@ const swapResult = await gswapService.executeSwap({
 console.log(`Swap completed! TX: ${swapResult.transactionId}`);
 console.log(`Received: ${swapResult.outputAmount} GUSDC`);
 
-// Query user assets on DEX
+// Query user assets on DEX (returns rich metadata)
 const assets = await gswapService.getUserAssets('eth|0x...');
 assets.forEach(asset => {
-  console.log(`${asset.symbol}: ${asset.balance}`);
+  console.log(`${asset.symbol} (${asset.name}): ${asset.balance}`);
+  console.log(`  Image: ${asset.image}`);
+  console.log(`  Verified: ${asset.verified}`);
 });
 
+// Discover all available DEX tokens (no wallet required)
+const availableTokens = await sdk.fetchAvailableDexTokens({ limit: 20, page: 1 });
+console.log(`Found ${availableTokens.count} tokens on DEX`);
+availableTokens.tokens.forEach(token => {
+  console.log(`${token.symbol}: ${token.name} - ${token.description}`);
+});
+
+// Get ALL available tokens (auto-paginated)
+const allTokens = await sdk.fetchAllAvailableDexTokens();
+console.log(`Total: ${allTokens.length} tokens available on DEX`);
+
 // Get pool information for token pair
 const poolInfo = await gswapService.getPoolInfo('GALA', 'GUSDC');
 console.log(`Liquidity: ${poolInfo.liquidity}`);