@gala-chain/launchpad-sdk 4.0.4-beta.0 → 4.0.5

package/EXAMPLES.md

@@ -54,8 +54,13 @@ npm run demo:liquidity
 
 # DEX swap workflow
 npm run demo:dex
+
+# Bonding curve trading orchestrator
+npm run demo:bonding:orchestrator
 ```
 
+**Demo Statistics**: 65 comprehensive demos organized into 8 categories covering all SDK features
+
 ---
 
 ## Recommended Learning Path
@@ -77,13 +82,28 @@ npm run demo:authenticated
 
 **Learn:** SDK initialization, configuration, read-only vs full-access modes
 
-### 2. Explore Liquidity Management
+### 2. Understand Bonding Curve Trading
+
+```bash
+# Run all bonding curve demos sequentially
+npm run demo:bonding:orchestrator
+
+# Basic buy/sell operations
+npm run demo:trades
+
+# Token graduation workflow
+npm run demo:bonding:graduation
+```
+
+**Learn:** Pre-graduation token trading, bonding curve mechanics, token launch lifecycle
+
+### 3. Explore Liquidity Management
 
 ```bash
 # Interactive CLI for liquidity positions
 npm run demo:liquidity
 
-# Run all 9 liquidity demos sequentially
+# Run all 12 liquidity demos sequentially
 npm run demo:liquidity:all
 
 # Detailed position lifecycle
@@ -92,7 +112,7 @@ npm run demo:liquidity:detailed
 
 **Learn:** Add liquidity, collect fees, remove positions, APR calculations
 
-### 3. Master DEX Trading
+### 4. Master DEX Trading
 
 ```bash
 # DEX swap workflow (quote → execute → confirm)
@@ -107,7 +127,7 @@ npm run demo:dex:quotes
 
 **Learn:** Token swaps, quote generation, slippage protection, pool discovery
 
-### 4. Understand Fee Management
+### 5. Understand Fee Management
 
 ```bash
 # Basic fee generation and collection
@@ -122,7 +142,7 @@ npm run demo:fees:test
 
 **Learn:** LP fee generation, collection strategies, multi-wallet workflows
 
-### 5. Try Real-Time Features
+### 6. Try Real-Time Features
 
 ```bash
 # Watch for new DEX pool creation
@@ -134,7 +154,7 @@ npm run demo:watch:tokens
 
 **Learn:** WebSocket event monitoring, pool/token discovery
 
-### 6. Explore Advanced Topics
+### 7. Explore Advanced Topics
 
 ```bash
 # Metadata cache performance
@@ -315,9 +335,9 @@ console.log(`Position closed!`);
 console.log(`Withdrawn: ${result.amount0Withdrawn} GALA + ${result.amount1Withdrawn} GUSDC`);
 ```
 
-**Liquidity Demos (9 total):**
+**Liquidity Demos (12 total):**
 - `npm run demo:liquidity` - Interactive CLI
-- `npm run demo:liquidity:all` - Run all 9 demos (orchestrator)
+- `npm run demo:liquidity:all` - Run all 12 demos (orchestrator)
 - `npm run demo:liquidity:detailed` - Complete lifecycle
 - `npm run demo:liquidity:ticks` - Advanced tick positions
 - `npm run demo:liquidity:portfolio` - Multi-position management
@@ -325,6 +345,9 @@ console.log(`Withdrawn: ${result.amount0Withdrawn} GALA + ${result.amount1Withdr
 - `npm run demo:liquidity:errors` - Error handling
 - `npm run demo:liquidity:fetch-all` - Pagination example
 - `npm run demo:liquidity:positions-with-prices` - Price enrichment
+- `npm run demo:liquidity:removal` - Position removal workflow
+- `npm run demo:liquidity:fee-collection` - Fee collection strategies
+- `npm run demo:liquidity:price-range` - Price range optimization
 
 **Orchestrator Usage:**
 
@@ -403,19 +426,28 @@ const result = await sdk.sell({
 console.log(`✓ Sale completed: ${result.transactionId}`);
 ```
 
-**Bonding Curve Demos:**
+**Bonding Curve Demos (8 total):**
+- `npm run demo:bonding:orchestrator` - Run all 8 bonding curve demos (orchestrator)
 - `npm run demo:trades` - Basic buy/sell operations
+- `npm run demo:bonding:graduation` - Token graduation workflow and simulation
+- `npm run demo:bonding:pool-discovery` - Pool filtering and discovery
+- `npm run demo:bonding:price-impact` - Price impact analysis and calculations
+- `npm run demo:bonding:token-launch` - Token launch lifecycle demonstration
+- `npm run demo:bonding:volume-trading` - High-volume trading simulation
+- `npm run demo:bonding:pool-analysis` - Deep pool analytics and metrics
+
+**Orchestrator Usage:**
+
+```bash
+# Run all bonding curve demos
+npm run demo:bonding:orchestrator
+
+# Skip specific demos
+npm run demo:bonding:orchestrator -- --skip=graduation,volume-trading
 
-**Coming Soon (Bonding Curve Orchestrator):**
-8 additional bonding curve demos planned:
-- Pool discovery and filtering
-- Price calculation methods
-- Graduation simulation
-- Multi-token analysis
-- Fee structure exploration
-- Slippage testing scenarios
-- Liquidity depth analysis
-- Graduation timing optimization
+# Run only specific demos
+npm run demo:bonding:orchestrator -- --only=pool-discovery,price-impact
+```
 
 ---
 
@@ -492,13 +524,15 @@ pools.pools.forEach(pool => {
 });
 ```
 
-**DEX Demos (6 total):**
+**DEX Demos (8 total):**
 - `npm run demo:dex` - Swap workflow (quote → execute → confirm)
 - `npm run demo:dex:pools` - Pool discovery and metrics
 - `npm run demo:dex:pricing` - Pool pricing and TVL analysis
 - `npm run demo:dex:quotes` - Quote comparison
 - `npm run demo:dex:roundtrip` - Complete liquidity workflow
 - `npm run demo:roundtrip:swap` - Buy → Sell → Verify
+- `npm run demo:dex:leaderboard` - Seasonal leaderboard queries and XP rankings
+- `npm run demo:dex:volume-summary` - Platform volume metrics and trend analysis
 
 **Symmetry Note:** Both `bonding-curve/` and `dex/` categories have pool discovery demos for consistent learning patterns.
 
@@ -828,11 +862,26 @@ console.timeEnd('Batch Calculations');
 **Utility Demos (5 total):**
 - `npm run demo:cache` - Metadata cache warming and performance
 - `npm run demo:token-supply` - Token supply metrics from GalaChain
+- `npm run demo:utilities:balances` - Multi-token balance queries
+- `npm run demo:utilities:balance` - Single token balance check
+- `npm run demo:utilities:price-history` - Historical price data (Node.js only)
+
+**Key Features:**
+
+**Multi-Token Balances** (`demo:utilities:balances`):
+- Check balances for multiple tokens in a single wallet
+- Useful for portfolio overview and batch queries
+- Example: Query all token holdings at once
 
-**Additional (not exposed as npm scripts):**
-- `tsx examples/utilities/balances.ts` - Multi-token balance queries
-- `tsx examples/utilities/balance.ts` - Single token balance check
-- `tsx examples/utilities/price-history.ts` - Historical price data (Node.js only)
+**Single Token Balance** (`demo:utilities:balance`):
+- Check balance for a specific token
+- Fast, focused balance query
+- Example: Verify GALA balance before trade
+
+**Price History** (`demo:utilities:price-history`):
+- Fetch historical price data for technical analysis
+- Node.js only (requires file system access)
+- Example: Download price data for charting and trend analysis
 
 ---
 
@@ -908,16 +957,28 @@ See the `examples/` directory for complete working demos organized by category:
 
 ```
 examples/
-├── core/           # 4 demos - SDK fundamentals
-├── liquidity/      # 9 demos - LP position management
-├── bonding-curve/  # 1 demo + 8 planned - Pre-graduation trading
-├── dex/            # 6 demos - DEX trading
-├── fees/           # 5 demos - Fee workflows
-├── monitoring/     # 2 demos - Real-time events
-├── utilities/      # 5 demos - Helper operations
-└── debug/          # 3 tools - Development utilities
-```
-
-**Total:** 36 demos covering all major SDK features
+├── core/              # 5 demos - SDK fundamentals
+├── bonding-curve/     # 8 demos - Pre-graduation trading
+├── liquidity/         # 12 demos - LP position management
+├── dex/               # 8 demos - DEX trading & leaderboard
+├── fees/              # 5 demos - Fee workflows
+├── monitoring/        # 11 demos - Real-time events
+├── swap-monitoring/   # 4 demos - DEX swap watchers
+├── utilities/         # 5 demos - Helper operations
+└── debug/             # 5 tools - Development utilities (not in npm scripts)
+```
+
+**Total:** 65 demos covering all major SDK features
+
+**Category Breakdown:**
+- **Core Operations**: 5 demos covering SDK setup, configuration, and multi-wallet testing
+- **Bonding Curve Trading**: 8 demos for pre-graduation token trading (orchestrator + 7 specialized)
+- **Liquidity Management**: 12 demos for LP positions (orchestrator + 11 specialized)
+- **DEX Trading**: 8 demos for swaps, pools, leaderboard, and volume analytics
+- **Fee Management**: 5 demos for fee generation and collection workflows
+- **Real-Time Monitoring**: 11 demos for pool/token creation watchers
+- **Swap Monitoring**: 4 demos for DEX swap event tracking
+- **Utilities**: 5 demos for balances, cache, supply, and price history
+- **Debug Tools**: 5 development utilities (not exposed as npm scripts)
 
 For migration from old demo structure, see [docs/DEMO_MIGRATION_GUIDE.md](./docs/DEMO_MIGRATION_GUIDE.md).

package/README.md

@@ -1,5 +1,7 @@
 # Gala Launchpad SDK
 
+**Version: 4.0.4-beta.0 (Beta)**
+
 A comprehensive TypeScript SDK for the Gala Launchpad Backend API, providing type-safe authentication, trading, and real-time features for DeFi applications.
 
 > **⚠️ BREAKING CHANGE (v3.33.0+)**: Token format parsing now **ONLY accepts delimited formats** (`GALA|Unit|none|none` or `GALA$Unit$none$none`). Plain token strings (`'GALA'`, `'GUSDC'`) are **permanently rejected** for security. See [Migration Guide](#token-format-migration-v330) below.