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

package/CHANGELOG.md

@@ -1,2161 +0,0 @@
-# Changelog
-
-## 1.25.0
-
-### Minor Changes
-
-- Add event watcher tools for real-time pool and token discovery:
-
-  **New MCP Tools:**
-  - `gala_launchpad_on_dex_pool_creation` - Watch for new DEX pool creation with filtering
-    - Parameters: minTVL (optional), tokens (optional), intervalMs (optional), durationSeconds
-      (optional)
-    - Returns: poolsDetected count, durationSeconds, and array of detected pools
-  - `gala_launchpad_on_launchpad_token_creation` - Watch for new launchpad token creation with
-    filtering
-    - Parameters: creatorAddress (optional), intervalMs (optional), durationSeconds (optional)
-    - Returns: tokensDetected count, durationSeconds, and array of detected tokens
-
-  **Updates:**
-  - Tool registry updated from 74 to 76 tools
-  - Pool tools category increased from 17 to 19 tools
-  - Updated SDK dependency to @gala-chain/launchpad-sdk@^3.29.0
-
-  🧠 Generated with [Claude Code](https://claude.com/claude-code)
-
-  Co-Authored-By: Claude <noreply@anthropic.com>
-
-### Patch Changes
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.29.0
-
-## 1.24.1
-
-### Patch Changes
-
-- fix: Update tool registry validation count from 72 to 74
-  - Fixed hard-coded tool count validation that was preventing v1.24.0 from starting
-  - Updated from 72 tools to 74 tools to account for 2 new DEX pool discovery tools
-  - Updated registry documentation to reflect correct tool distribution
-
-## 1.24.0
-
-### Minor Changes
-
-- feat: Add DEX Pool Discovery MCP tools and prompts
-  - 2 new MCP tools: `gala_launchpad_fetch_dex_pools`, `gala_launchpad_fetch_all_dex_pools`
-  - 2 new slash commands: `/fetch-dex-pools`, `/fetch-all-dex-pools`
-  - Full support for GalaSwap liquidity pool exploration via MCP
-  - Integration with new SDK v3.28.0 DEX Pool Discovery feature
-  - Complete test coverage with 586 tests passing
-
-## 1.23.0
-
-### Minor Changes
-
-- 2bab95b: feat: Add 50 new slash commands to achieve complete 1:1 MCP tool-to-command mapping
-
-  Complete implementation of user requirement: "every MCP tool should have a corresponding slash
-  command."
-
-  ## Changes
-
-  ### New Slash Commands (50 total)
-
-  **Pool Management (15 commands):**
-  - fetch-pools, fetch-all-pools, fetch-pool-details, fetch-pool-details-for-calculation
-  - fetch-token-details, fetch-token-distribution, fetch-token-badges, fetch-volume-data
-  - fetch-gala-spot-price, fetch-token-spot-price, fetch-launchpad-token-spot-price
-  - fetch-price-history, fetch-all-price-history
-  - check-token-name, check-token-symbol, resolve-vault-address, resolve-token-class-key
-
-  **Trading Calculations (11 commands):**
-  - calculate-buy-amount, calculate-sell-amount, fetch-trades, calculate-initial-buy
-  - get-bundler-transaction-result, calculate-graduation-cost
-  - calculate-buy-amount-local, calculate-buy-amount-external
-  - calculate-sell-amount-local, calculate-sell-amount-external
-  - is-token-graduated
-
-  **Balance & Portfolio (4 commands):**
-  - fetch-gala-balance, fetch-token-balance, fetch-tokens-created, update-profile
-
-  **Creation Utilities (3 commands):**
-  - upload-profile-image, upload-token-image, fetch-launch-token-fee
-
-  **Social & Comments (2 commands):**
-  - post-comment, fetch-comments
-
-  **Token Transfers (2 commands):**
-  - transfer-gala, transfer-token
-
-  **Utility & System (12 commands):**
-  - create-wallet, get-address, get-ethereum-address, get-config
-  - get-url-by-token-name, explain-sdk-usage, get-cache-info, clear-cache
-  - has-wallet, get-wallet, set-wallet, get-environment
-
-  ### Tool Constants
-
-  **Updated `src/constants/mcpToolNames.ts`:**
-  - Added 14 new tool constants to POOL_TOOLS (moved FETCH_TOKEN_DETAILS, FETCH_PRICE_HISTORY,
-    FETCH_ALL_PRICE_HISTORY, and resolved vault/token class key tools)
-  - Expanded UTILITY_TOOLS from 6 to 14 tools (added cache management, wallet management,
-    environment/version tools)
-  - Updated comments to reflect "72 tools across 8 categories"
-
-  ### New Prompt Files
-
-  Created 7 new prompt files with comprehensive handler functions:
-  - `src/prompts/pools.ts` - Pool management commands
-  - `src/prompts/trading-calculations.ts` - Trading calculation commands
-  - `src/prompts/balances.ts` - Balance query commands
-  - `src/prompts/creation-utils.ts` - Creation utility commands
-  - `src/prompts/social.ts` - Social/comments commands
-  - `src/prompts/transfers.ts` - Token transfer commands
-  - `src/prompts/utility-tools.ts` - Utility and system commands
-
-  ### Documentation Updates
-
-  **Updated `packages/mcp-server/README.md`:**
-  - Updated tool count from 70 to 72 across all sections
-  - Updated slash command count from 23 to 72 (was only 18 original commands + 24 new ones = 42
-    documented, now 72 total)
-  - Added comprehensive documentation for all 48 new slash commands organized by category
-  - Added emphasis on "1:1 tool-to-command mapping" - core design philosophy
-  - Complete tool listings now include all utility tools (cache, wallet, environment management)
-
-  ### Architecture Achievement
-
-  The implementation completes the core design goal: **Every MCP tool now has exactly one
-  corresponding slash command**, enabling users to interact with all backend functionality through
-  the familiar slash command interface.
-
-  **Tool-to-Command Mapping:**
-  - 72 MCP tools → 72 slash commands (perfect 1:1 ratio)
-  - 9 tool categories → 9 command category sections in documentation
-  - Consistent naming patterns for easy discovery (tool names match command names)
-
-  ### Code Organization Improvements
-
-  **Updated MCP_TOOLS spread operator order in `src/constants/mcpToolNames.ts`:**
-  - Reordered to place UTILITY_TOOLS before DEX_TOOLS and LIQUIDITY_TOOLS
-  - New order: POOL → TRADING → BALANCE → CREATION → SOCIAL → TRANSFER → UTILITY → DEX → LIQUIDITY
-  - Improves code consistency and follows logical category ordering
-
-  ### Validation Improvements
-
-  Fixed validation function calls in all new prompt files to use correct function signatures:
-  - `validateTokenName(name, fieldName)` - Added fieldName parameter
-  - `validateAddress(address, fieldName)` - Added fieldName parameter
-  - `validateNumericAmount(amount, fieldName)` - Added required fieldName parameter
-  - Improved error messages when validation fails
-
-  ### Test Coverage
-
-  All tests passing:
-  - TypeScript compilation: 0 errors
-  - Jest test suite: 1401 tests across 30 test suites
-  - ESLint: 0 linting issues
-  - Registry tests: Validates all 72 prompts are registered and discoverable
-
-  ## Why This Matters
-
-  User's explicit requirement: _"why would a functionality be worth of a 'tool' that the mcp can
-  use, but not a / command I can use? It just seems like slashes should be mainly for exposing mcp
-  tools for quick consumption"_
-
-  This implementation fulfills that philosophy by ensuring complete parity between available tools
-  and available commands. Users never encounter a capability they can't access from the slash
-  command interface.
-
-## 1.22.4
-
-### Patch Changes
-
-- 096a518: feat: add environment switching tools, prompts, and comprehensive test coverage for MCP
-  server
-
-  **New Tools:**
-  - Added gala_launchpad_get_environment tool to query current environment (production, development,
-    or testing)
-  - Added gala_launchpad_switch_environment tool to dynamically switch environments while preserving
-    wallet configuration
-
-  **New Prompts:**
-  - Added /galachain-launchpad:switch-environment slash command for guided environment switching
-    workflow
-
-  **Enhancements:**
-  - Enhanced gala_launchpad_get_config to include mcpServerEnvironment field showing current
-    environment state
-  - Implemented server-level tool support via new createServerLevelTool factory function
-  - Updated MCP tool handler signature to accept optional server parameter (backward compatible)
-  - Modified LaunchpadMCPServer to track currentEnvironment and currentPrivateKey state
-  - Added switchEnvironment() and getEnvironment() methods to LaunchpadMCPServer class with
-    fail-safe error handling
-
-  **Bug Fixes:**
-  - Fixed version mismatch in server.ts: now uses dynamically injected MCP_SERVER_VERSION instead of
-    hardcoded value
-  - Fixed error handling in switchEnvironment(): now creates new SDK before destroying old one to
-    prevent broken state on failure
-
-  **Tests:**
-  - Added 23 comprehensive server contract tests covering environment switching, state management,
-    error handling, and type safety
-  - Updated prompt registry tests to reflect 24 prompts (was 23)
-  - All 278 MCP server unit tests passing (was 255), total suite 1401+ tests
-
-  **Documentation:**
-  - Updated tool registry documentation: 72 tools total (pools: 17, trading: 13, dex: 13, balance:
-    6, creation: 4, social: 2, transfers: 2, utils: 15)
-  - Updated CLAUDE.md with comprehensive environment switching documentation
-
-## 1.22.3
-
-### Patch Changes
-
-- fix: return raw price impact values with full precision instead of rounding to 2 decimals
-
-  Changed price impact return format from `.toFixed(2)` to `.toString()` to preserve the full
-  precision of GSwap SDK's price impact calculations. This allows consumers to see the actual price
-  impact values without rounding loss.
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.27.3
-
-## 1.22.2
-
-### Patch Changes
-
-- fix: use GSwap SDK's native price impact calculation instead of custom formula
-
-  The custom price impact calculation was inaccurate. The GSwap SDK already provides a correct
-  `priceImpact` field in its quote responses that accounts for the actual exchange rate and pool
-  slippage. We now use that directly instead of computing our own formula.
-
-  This fixes issues where small swaps incorrectly showed 0% impact and large swaps showed incorrect
-  values.
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.27.2
-
-## 1.22.1
-
-### Patch Changes
-
-- Redeploy with latest price impact fix
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.27.1
-
-## 1.22.0
-
-### Minor Changes
-
-- 0a49faf: **GalaSwap Liquidity Position Management (v3.25.0 SDK / v1.20.0 MCP)**
-
-  Comprehensive liquidity position management for concentrated liquidity provision on GalaSwap DEX.
-  Liquidity providers can now earn passive trading fees by providing liquidity within specific price
-  ranges.
-
-  ### 8 New SDK Methods (LaunchpadSDK)
-  1. **getSwapUserLiquidityPositions(ownerAddress, limit?, bookmark?)** - View all open positions
-     for a wallet with pagination support
-  2. **getSwapLiquidityPositionById(ownerAddress, positionId)** - Get specific position by UUID
-  3. **getSwapLiquidityPosition(ownerAddress, position)** - Get position by token pair and tick
-     range
-  4. **addSwapLiquidityByPrice(args)** - Create position using user-friendly price ranges (e.g.,
-     min: 0.95, max: 1.05)
-  5. **addSwapLiquidityByTicks(args)** - Create position using precise tick boundaries (advanced)
-  6. **getSwapEstimateRemoveLiquidity(args)** - Preview amounts and fees before executing removal
-  7. **removeSwapLiquidity(args)** - Close or reduce position with slippage protection
-  8. **collectSwapPositionFees(args)** - Harvest accumulated trading fees without closing position
-
-  ### 8 New MCP Tools
-
-  All SDK methods exposed as MCP tools with full type validation and privateKey override support:
-  - `gala_launchpad_get_user_liquidity_positions` - List positions with pagination
-  - `gala_launchpad_get_liquidity_position_by_id` - Get by position ID
-  - `gala_launchpad_get_liquidity_position` - Get by token pair
-  - `gala_launchpad_add_liquidity_by_price` - Create position (price-based)
-  - `gala_launchpad_add_liquidity_by_ticks` - Create position (tick-based)
-  - `gala_launchpad_estimate_remove_liquidity` - Estimate removal amounts
-  - `gala_launchpad_remove_liquidity` - Execute removal
-  - `gala_launchpad_collect_position_fees` - Collect accumulated fees
-
-  ### 4 New Slash Commands (Prompts)
-
-  Quick-access workflows for Claude Desktop users:
-  - `/galachain-launchpad:my-positions` - View all liquidity positions
-  - `/galachain-launchpad:add-liquidity` - Create new position (guided workflow)
-  - `/galachain-launchpad:remove-liquidity` - Close position (with estimates)
-  - `/galachain-launchpad:collect-fees` - Harvest accumulated fees
-
-  ### Key Features
-
-  **Fee Tiers**: Support for standard GalaSwap fee tiers (500 bps = 0.05%, 3000 bps = 0.30%, 10000
-  bps = 1.00%)
-
-  **Price Range Creation**: User-friendly price range interface (0.95 - 1.05) automatically converts
-  to precise tick boundaries
-
-  **Tick-Based Creation**: Advanced users can create positions using exact tick boundaries for
-  precise capital management
-
-  **Fee Collection**: Harvest passive trading fees without closing position
-
-  **Estimation**: Preview exact amounts and fees before executing any transaction
-
-  **Slippage Protection**: Built-in slippage tolerance for all operations
-
-  **Pagination**: Efficient position listing with bookmark support for large portfolios
-
-  ### Documentation & Examples
-  - **Demo Script**: `packages/sdk/examples/demo-liquidity-positions.ts` - Complete workflow
-    demonstration
-  - **SDK Docs**: `explain_sdk_usage` tool includes `liquidity-positions` topic with runnable
-    examples
-  - **Integration Guide**: CLAUDE.md includes comprehensive LP integration section
-
-  ### Test Coverage
-  - **54 SDK Unit Tests**: Complete test coverage for all 8 methods with edge cases
-  - **39 MCP Tool Tests**: Full validation of all 8 MCP tools and input schemas
-  - **1401 Total Tests**: Full regression test suite passing
-
-  ### Version Updates
-  - SDK: 3.24.2 → 3.25.0 (minor version bump)
-  - MCP Server: 1.19.2 → 1.20.0 (minor version bump)
-
-### Patch Changes
-
-- Updated dependencies [0a49faf]
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.27.0
-
-## 1.19.0
-
-### Minor Changes
-
-- 683396d: **New Slash Commands for Token Creation & Discovery (v1.19.0)**
-
-  Added two powerful new slash commands to the MCP server for guided token workflows:
-
-  ### `/galachain-launchpad:create-token` - Token Creation Workflow
-  - **Purpose**: Guided, step-by-step token creation with validation and image upload
-  - **Arguments**:
-    - `tokenName` (required) - 3-20 alphanumeric characters with hyphens/underscores
-    - `tokenSymbol` (required) - 1-8 uppercase letters only
-    - `description` (required) - Token description
-    - `websiteUrl`, `twitterUrl`, `telegramUrl` (optional) - Social links (at least one required)
-    - `imagePath` (optional) - Path to token image file
-    - `preBuyGala` (optional) - Pre-buy amount in GALA
-  - **Validation**: Token name/symbol availability, URL format validation, required social links
-  - **Workflow Steps**:
-    1. Validate token name and symbol
-    2. Check name/symbol availability
-    3. Upload token image (optional)
-    4. Calculate pre-buy token quantity
-    5. Display launch fee
-    6. Guide through transaction execution
-
-  ### `/galachain-launchpad:discover-tokens` - Token Discovery & Filtering
-  - **Purpose**: Discover and filter tokens with advanced search capabilities
-  - **Arguments**:
-    - `type` (optional) - Filter type: `recent` (default), `popular`, or `near-graduation`
-    - `limit` (optional, default: 10) - Max results (1-50)
-    - `minProgress` (optional) - Minimum graduation progress percentage (0-100)
-    - `maxPrice` (optional) - Maximum USD price filter
-  - **Use Cases**:
-    - Find new tokens: `type=recent limit=20`
-    - Find trending tokens: `type=popular limit=10`
-    - Find near-graduation pools: `type=near-graduation minProgress=85 limit=10`
-    - Find cheap tokens: `maxPrice=1.00 limit=20`
-  - **Workflow Steps**:
-    1. Filter pools by type and criteria
-    2. Calculate graduation progress for each
-    3. Fetch current prices
-    4. Display sortable results with metrics
-    5. Provide links for detailed analysis
-
-  ### Implementation Details
-  - **Total Prompts**: 18 slash commands (4 trading, 5 portfolio, 6 analysis, 2 creation/discovery,
-    1 utility)
-  - **Test Coverage**: Updated all prompt structure and registry tests to validate 18 commands
-  - **Validation**: Comprehensive input validation for all arguments with clear error messages
-  - **Documentation**: Full documentation in README.md and CLAUDE.md with usage examples
-
-  ### Test Results
-  - ✅ 146 unit tests passing
-  - ✅ All prompt structure validations passing
-  - ✅ Backward compatible with existing slash commands
-  - ✅ Build verification complete
-
-  ### What's Included
-  - New prompt definitions with full argument validation
-  - Workflow template generation for both commands
-  - Integration with existing MCP tools
-  - Comprehensive documentation and examples
-
-- 683396d: # v3.23.0: GalaSwap DEX Integration & Documentation
-
-  **🚀 Major Feature Release: Complete GalaSwap DEX Integration**
-
-  ## Features
-
-  ### GalaSwap DEX Trading Integration (v3.23.0+)
-
-  **5 New High-Level SDK Methods for DEX Trading:**
-  - `getSwapQuoteExactInput(fromToken, toToken, amount)` - Get quote for known spending
-  - `getSwapQuoteExactOutput(fromToken, toToken, amount)` - Get quote for known output
-  - `executeSwap(fromToken, toToken, inputAmount, estimatedOutput, feeTier, slippageTolerance)` -
-    Execute swaps with slippage protection
-  - `getSwapUserAssets(walletAddress)` - Query user token balances
-  - `getSwapPoolInfo(tokenA, tokenB)` - Get pool liquidity and fee information
-
-  **Architecture:**
-  - Three-layer design: LaunchpadSDK → GSwapService (wrapper) → @gala-chain/gswap-sdk (core)
-  - Automatic token format conversion (simple: "GALA" ↔ full: "GALA|Unit|none|none")
-  - Real-time WebSocket event monitoring for transaction confirmation
-  - Comprehensive slippage protection (configurable tolerance: 0.0001 to 1.0)
-  - Support for three fee tiers per pool: 500 (0.05%), 3000 (0.30%), 10000 (1.00%)
-
-  ### 5 New MCP Tools
-  - `gala_launchpad_get_swap_quote_exact_input` - Get swap quote with known input
-  - `gala_launchpad_get_swap_quote_exact_output` - Get swap quote with known output
-  - `gala_launchpad_execute_swap` - Execute DEX swap with slippage protection
-  - `gala_launchpad_get_swap_user_assets` - Query wallet token balances
-  - `gala_launchpad_get_swap_pool_info` - Get DEX pool information
-
-  ### 1 New MCP Slash Command
-  - `/galachain-launchpad:dex-swap tokenName=GALA toToken=GUSDC amount=100 slippage=1` - Guided DEX
-    swap workflow
-
-  ### Comprehensive Test Coverage
-  - **gswap-service.test.ts** (45+ test cases) - Full GSwapService integration tests with mocked
-    GSwap SDK
-  - **token-format-converter.test.ts** (67+ test cases) - Bidirectional token format conversion
-    tests
-  - **dex-tools.test.ts** (40+ test cases per tool) - MCP tool configuration and schema validation
-  - **200+ total test cases** covering edge cases, error handling, and real-world scenarios
-
-  ### Complete Documentation
-
-  **API.md (450+ lines):**
-  - Comprehensive API reference for all SDK methods
-  - DEX trading methods with examples
-  - Type definitions and error handling patterns
-  - Complete installation and usage guide
-
-  **CLAUDE.md Updates (250+ lines):**
-  - GalaSwap DEX Trading Methods section with architecture diagram
-  - Complete trading workflow examples
-  - Real-time monitoring via WebSocket
-  - Error handling patterns
-  - Performance characteristics
-
-  **gswap-integration.md (400+ lines):**
-  - Complete DEX integration guide
-  - Architecture overview with three-layer design
-  - 4 usage patterns: simple swap, pool info, portfolio tracking, real-time monitoring
-  - Token format handling and conversion
-  - Slippage protection strategies
-  - Fee tier analysis and optimization
-  - Troubleshooting and advanced topics
-
-  ## Technical Improvements
-
-  ### Token Format Converter Enhancement
-
-  Fixed edge cases revealed by comprehensive tests:
-  - Proper handling of already-formatted tokens (no double-processing)
-  - Object input support with TokenClassKey parsing
-  - Graceful null/undefined input handling
-  - Backward compatibility with old/new token formats
-
-  ### Bundle Size Optimization
-
-  All formats remain well under 50 kB limit:
-  - ESM: 38.79 kB gzipped
-  - CommonJS: 38.89 kB gzipped
-  - UMD: 39.01 kB gzipped
-
-  GSwap SDK marked as external dependency (<1 KB bundle impact)
-
-  ## Breaking Changes
-
-  None - fully backward compatible with v3.22.x
-
-  ## Migration Guide
-
-  No migration needed. New methods are additive:
-
-  ```typescript
-  import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
-
-  const sdk = createLaunchpadSDK({ privateKey: process.env.PRIVATE_KEY });
-
-  // New DEX trading methods available
-  const quote = await sdk.getSwapQuoteExactInput('GALA', 'GUSDC', '100');
-  const result = await sdk.executeSwap(...);
-
-  // All existing bonding curve methods still work
-  await sdk.buyTokens('anime', '100', ...);
-  ```
-
-  ## Dependencies
-  - Added: @gala-chain/gswap-sdk@0.0.7 (marked as external)
-  - No breaking dependency changes
-
-  ## Next Steps
-  - Try the new `/galachain-launchpad:dex-swap` slash command in Claude Desktop
-  - Explore 5 new DEX trading tools in MCP server
-  - Reference API.md for complete method signatures
-  - See gswap-integration.md for integration patterns
-
-### Patch Changes
-
-- Updated dependencies [683396d]
-  - @gala-chain/launchpad-sdk@3.24.0
-
-## 1.18.0
-
-### Minor Changes
-
-- **BREAKING CHANGE:** Default environment changed from `development` to `production`
-
-  All SDK and MCP initialization now defaults to production environment
-  (`lpad-backend-prod1.defi.gala.com`) instead of development. To use development environment,
-  explicitly set `env: 'DEVELOPMENT'` or `ENVIRONMENT=development`.
-
-  Changes include:
-  - SDK `AgentConfig.detectEnvironment()` defaults to 'production'
-  - MCP Server environment defaults to 'production'
-  - All examples and documentation updated to show production as default
-  - All installation instructions updated accordingly
-
-  Users relying on implicit development environment must now explicitly set the environment
-  variable.
-
-### Patch Changes
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.23.0
-
-## 1.17.7
-
-### Patch Changes
-
-- Bump SDK dependency to v3.22.7 which includes the new read-only operations example
-
-## 1.18.0
-
-### Minor Changes
-
-- feat: Implement optional wallet support with 3 new wallet management tools (57 tools across
-  read-only and full-access modes)
-
-  ## Overview
-
-  PRIVATE_KEY environment variable is now optional, enabling two distinct operational modes:
-  - **Read-Only Mode**: Query pools, prices, token details without wallet (40+ tools available)
-  - **Full-Access Mode**: Execute trades, create tokens, sign transactions with wallet (17+
-    additional tools)
-
-  ## New Wallet Management Tools
-  - **`gala_launchpad_has_wallet`** - Check if MCP server wallet is currently configured
-  - **`gala_launchpad_get_wallet`** - Retrieve the configured wallet address (GalaChain and Ethereum
-    formats)
-  - **`gala_launchpad_set_wallet`** - Configure wallet for signing operations dynamically
-
-  ## Installation
-
-  **Full-Access Mode (with wallet):**
-
-  ```bash
-  claude mcp add "galachain-launchpad" -- \
-    env PRIVATE_KEY=<YOUR_KEY> ENVIRONMENT=production \
-    npx -y @gala-chain/launchpad-mcp-server@latest
-  ```
-
-  **Read-Only Mode (no wallet):**
-
-  ```bash
-  claude mcp add "galachain-launchpad" -- \
-    env ENVIRONMENT=production \
-    npx -y @gala-chain/launchpad-mcp-server@latest
-  ```
-
-  ## Key Features
-  - **Optional PRIVATE_KEY**: Omit `PRIVATE_KEY` environment variable for read-only mode
-  - **Progressive Enhancement**: Start with read-only queries, upgrade by setting wallet dynamically
-  - **Smart Tool Availability**: Tools requiring wallet automatically disabled in read-only mode
-  - **Seamless Claude Desktop Integration**: Full compatibility with Claude Desktop MCP server setup
-  - **Type Safety**: Wallet validation matches SDK implementation for consistency
-  - **Backward Compatible**: Existing installations with PRIVATE_KEY continue to work unchanged
-
-  ## Tool Categories (57 Total)
-  - **Pool Management & Pricing** (17 tools) - Fetch pools, details, distributions, badges, prices
-  - **Price History & Analysis** (4 tools) - Historical price data and trends
-  - **Trading Operations** (13 tools) - Buy/sell calculations, token trades, graduation
-  - **Balance & Portfolio** (6 tools) - Token balances, holdings, profiles
-  - **Token Creation & Management** (4 tools) - Launch tokens, upload images, manage metadata
-  - **Wallet Management** (3 tools) - Check, get, set wallet configuration
-  - **Utility & Social** (10 tools) - Comments, transfers, configuration, URL generation
-
-  ## SDK Dependency Update
-  - Updated @gala-chain/launchpad-sdk to 3.23.0
-  - Incorporates 4 new wallet management methods (hasWallet, getWallet, setWallet, validateWallet)
-  - All MCP tools leverage SDK's new optional wallet support
-
-  ## Test Coverage
-  - Unit tests for optional wallet mode detection and tool filtering
-  - Integration tests for read-only mode MCP operations (pool queries, price fetches)
-  - Integration tests for full-access mode with wallet operations (trades, transfers, creation)
-  - Tool availability verification for both operational modes
-
-## 1.17.5
-
-### Patch Changes
-
-- Fix: Remove 7 unnecessary escape characters (\$) in SDK usage examples - $ does not need escaping
-  in template literals when not part of ${} Fix: Remove 3 unused imports in SDK and diagnostic
-  scripts
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.22.5
-
-## 1.17.4
-
-### Patch Changes
-
-- Add intelligent DEX fallback for ungraduated tokens in fetchTokenSpotPrice. When querying spot
-  prices with tokenId format for ungraduated tokens (which return 400/404 from DEX API), the SDK now
-  intelligently extracts the token name from GalaChain metadata and falls back to launchpad pricing.
-  This provides seamless support for both graduated (DEX) and ungraduated (launchpad) tokens via the
-  same tokenId parameter.
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.22.4
-
-## 1.17.3
-
-### Patch Changes
-
-- docs: update changelogs for v3.22.2 and v1.17.2 releases
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.22.3
-
-## 1.17.2
-
-### Patch Changes
-
-- Dependency bump: @gala-chain/launchpad-sdk@3.22.2
-
-  Includes fix for GalaChain FetchTokenClasses endpoint authentication issue. The endpoint is public
-  but rejects authenticated requests. SDK now uses unauthenticated axios for public token metadata
-  queries.
-
-  **Result:**
-  - Token details now fetch correctly for all token types
-  - Launchpad token metadata queries no longer fail with 404 errors
-  - All 1131 SDK tests passing
-
-## 1.17.1
-
-### Patch Changes
-
-- Dependency bump: @gala-chain/launchpad-sdk@3.22.1
-
-  Includes fix for GalaChainService response parsing. The FetchTokenClasses endpoint returns
-  `Data: TokenClass[]` directly, not `Data: { results: TokenClass[] }`.
-
-  **Result:**
-  - Token metadata queries return correct data instead of "Token not found" errors
-  - All 1131 SDK tests passing
-
-## 1.17.0
-
-### Minor Changes
-
-- d5371ff: feat: Implement symbol caching in DexService and TokenMetadataCache for optimized spot
-  price queries
-
-  ## Changes
-  - **TokenMetadataCache Extension**: Added tokenId-based caching methods (getByTokenId,
-    setByTokenId, hasByTokenId) to support caching immutable token symbols from DEX API metadata
-  - **DexService Symbol Caching**: Implemented cache-first pattern in \_fetchDexTokenSpotPrice() to
-    eliminate redundant `/v1/tokens` API calls on repeated spot price queries
-  - **LaunchpadSDK Integration**: Instantiated TokenMetadataCache and wired it through DexService
-    constructor for transparent symbol caching across all spot price operations
-  - **Performance**: First spot price query ~100-300ms (API call + cache), subsequent queries
-    ~50-150ms (cache hit, ~50% faster)
-  - **Backward Compatibility**: Cache is optional (undefined cache parameter continues to work,
-    falling back to fallback symbol from tokenInstance.type)
-
-  ## Implementation Details
-
-  ### Cache Key Format
-
-  Token symbols cached using pipe-delimited format with `token:` prefix to distinguish from
-  tokenName entries:
-  - Example: `token:GUSDC|Unit|none|eth:0x...`
-
-  ### Symbol Immutability
-
-  Symbols are guaranteed immutable based on DEX API contract - cached symbols never change, enabling
-  simple caching without TTL
-
-  ### Error Handling
-
-  Symbol fetch failures gracefully fall back to tokenInstance.type.toUpperCase() without affecting
-  cache or price calculation
-
-  ## Test Coverage
-  - 9 new unit tests for TokenMetadataCache tokenId methods
-  - 8 new integration tests for DexService symbol caching
-  - All 1133 tests passing
-  - Focus on: cache hits/misses, multiple token handling, metadata merging, backward compatibility
-
-### Patch Changes
-
-- Replace DEX API /v1/tokens with GalaChain native FetchTokenClasses API for authoritative token
-  metadata
-
-  **Summary:**
-  - Migrated token details fetching from DEX API to GalaChain native API
-  - Fixes bug where GALA spot price returned symbol "NONE" instead of "GALA"
-  - Removes obsolete dexApiHttp parameter from DexService
-  - Improves token metadata accuracy by using blockchain source of truth
-
-  **Changes:**
-  - Added `fetchTokenClassFromChain()` method to GalaChainService for native token metadata queries
-  - Updated DexService to use GalaChainService instead of DEX API for token details
-  - Wired GalaChainService through LaunchpadSDK to DexService
-  - Updated all tests to use GalaChainService mocks instead of DEX API mocks
-  - Removed unused HttpClient import and type definitions from DexService
-  - Removed unused dexApiHttp parameter from DexService constructor
-
-  **Technical Details:**
-  - GalaChain API endpoint: `/api/asset/token-contract/FetchTokenClasses`
-  - Source of truth: GalaChain native blockchain API (includes all tokens: native and wrapped)
-  - Backward compatibility: All existing APIs remain unchanged
-  - Test coverage: All 1131 tests passing
-
-- Updated dependencies
-- Updated dependencies [d5371ff]
-  - @gala-chain/launchpad-sdk@3.22.0
-
-## 1.16.4
-
-### Patch Changes
-
-- Fetch token symbol metadata from DEX API instead of deriving from type field
-
-  Instead of trusting the type field for token symbols (which doesn't always align with actual token
-  symbols), now properly fetch token metadata from /v1/tokens endpoint to get the correct symbol.
-  Includes graceful fallback to type field if metadata fetch fails.
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.21.4
-
-## 1.16.3
-
-### Patch Changes
-
-- Fix GALA token symbol display in DEX pricing
-
-  When fetching GALA price from DEX Backend API, the symbol was showing as 'NONE' instead of 'GALA'
-  because the type field is 'none'. Added special handling to use the collection name as the symbol
-  for GALA tokens.
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.21.3
-
-## 1.16.2
-
-### Patch Changes
-
-- Fix GALA token ID format for DEX Backend API pricing
-
-  The GALA token ID was using incorrect format `GALA|Unit|Unit|none` when the DEX Backend API
-  expects `GALA|Unit|none|none`. This caused all GALA price queries to fail with 400 "Token Not
-  found" errors. Corrected the type field from 'Unit' to 'none' in both DexService and LaunchpadSDK.
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.21.2
-
-## 1.16.1
-
-### Patch Changes
-
-- Fix MCP tool registry validation to prevent server initialization failure
-
-  The tool registry was validating for 57 tools but only 54 exist, causing the MCP server to fail
-  during startup. Corrected the validation count to match actual tool count.
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.21.1
-
-## 1.16.0
-
-### Minor Changes
-
-- Implement unified smart router for token spot price queries
-
-  **Breaking Changes (v3.21.0 -> v4.0.0):**
-  - `fetchTokenSpotPrice()` signature changed: now accepts `FetchTokenSpotPriceParams` object with
-    `tokenName` or `tokenId` (mutually exclusive), not `string | string[]` for symbols
-  - `fetchLaunchpadTokenSpotPrice()` marked as deprecated - use `fetchTokenSpotPrice({ tokenName })`
-    instead
-
-  **Non-Breaking Changes (v3.21.0):**
-  - New smart router: `fetchTokenSpotPrice({ tokenName? | tokenId? })` automatically routes between
-    launchpad and DEX tokens
-  - New type: `FetchTokenSpotPriceParams` with flexible token identification
-  - Consolidated three separate endpoints into one intelligent router:
-    - `tokenName` → Launchpad tokens with graduation detection (bonding curve or DEX pricing)
-    - `tokenId` → DEX Backend API `/v1/trade/price` (direct pricing)
-  - DexService now validates parameters and routes tokenId to DEX Backend API
-  - LaunchpadSDK handles smart routing logic between tokenName and tokenId cases
-  - Deprecated `fetchTokenSpotPrice()` for symbol array queries
-  - Fixed GALA token ID format:
-    `collection: 'GALA', category: 'Unit', type: 'Unit', additionalKey: 'none'`
-
-  **Migration Guide:**
-
-  ```typescript
-  // OLD (still works in v3.21.0, deprecated)
-  const prices = await sdk.fetchTokenSpotPrice(['GALA', 'SILK']);
-  const launchpadPrice = await sdk.fetchLaunchpadTokenSpotPrice('galadog');
-
-  // NEW (recommended)
-  const galaPrice = await sdk.fetchTokenSpotPrice({ tokenId: 'GALA|Unit|Unit|none' });
-  const launchpadPrice = await sdk.fetchTokenSpotPrice({ tokenName: 'galadog' });
-  const dexPrice = await sdk.fetchTokenSpotPrice({ tokenId: 'Token|Unit|GDOG|eth:...' });
-  ```
-
-  **Testing:**
-  - Added 16 comprehensive tests for smart router pattern
-  - All 1118 SDK tests pass
-  - Backward compatibility verified for deprecated methods
-
-### Patch Changes
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.21.0
-
-## 1.15.1
-
-### Patch Changes
-
-- Fix isGraduated flag calculation to use correct saleStatus value
-
-  **Bug Fix:**
-  - Fixed `GalaChainService` calculation of `isGraduated` flag
-    - Was: `isGraduated = response.Data.saleStatus === 'Completed'` ❌
-    - Now: `isGraduated = response.Data.saleStatus === 'Finished'` ✅
-  - Backend actually returns `saleStatus: "Finished"` for graduated tokens, not `"Completed"`
-  - `DexService` now correctly uses reliable `isGraduated` flag for graduation detection
-
-  **Impact:**
-  - `fetchLaunchpadTokenSpotPrice()` now correctly identifies graduated tokens using `isGraduated`
-  - Tokens with `isGraduated: true` (saleStatus: "Finished") use `/v1/trade/price` DEX endpoint
-  - Ensures accurate spot pricing for graduated launchpad tokens like GALADOG
-  - No breaking changes - behavior corrected to match backend state progression
-
-  **Result:**
-  - GALADOG: `isGraduated: true` (saleStatus: "Finished") → Uses DEX endpoint ✅
-  - Other tokens: `isGraduated: false` (saleStatus: "Ongoing") → Uses bonding curve ✅
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.20.1
-
-## 1.15.0
-
-### Minor Changes
-
-- Add tokenName parameter support to fetchPriceHistory and fetchAllPriceHistory (v3.20.0+)
-
-  **Features:**
-  - New optional `tokenName` parameter enables simple token names (e.g., "demonkpop") with automatic
-    resolution to full tokenId
-  - Mutual exclusivity validation: use exactly one of `tokenName` OR `tokenId` (not both, not
-    neither)
-  - Full backward compatibility with existing tokenId parameter usage (string and object formats)
-  - New helper method `fetchTokenClassKeyByTokenName()` for token name resolution
-  - Enhanced JSDoc with comprehensive examples for all three token identification methods
-
-  **SDK Changes:**
-  - `PriceHistoryService`: Added tokenName parameter support with auto-resolution via
-    TokenResolverService
-  - `LaunchpadSDK`: Wired TokenResolverService to PriceHistoryService for automatic name resolution
-  - Updated type definitions with optional `tokenName?: string` parameter
-  - Added comprehensive validation for mutual exclusivity
-
-  **MCP Server Changes:**
-  - `gala_launchpad_fetch_price_history`: Updated schema to support optional tokenName parameter
-  - `gala_launchpad_fetch_all_price_history`: Updated schema to support optional tokenName parameter
-  - Both tools now accept flexible token identification (tokenName or tokenId, choose one)
-
-  **Documentation:**
-  - Updated SDK README with new usage patterns and examples
-  - Updated CLAUDE.md Price History Patterns section
-  - Added complete section in complete-sdk-demo.ts demonstrating tokenName parameter
-  - Enhanced JSDoc comments for all methods with practical examples
-
-  **Testing:**
-  - Added 33 comprehensive unit tests covering:
-    - Token name to token class key resolution
-    - Mutual exclusivity validation
-    - Error handling for invalid inputs
-    - Integration with both fetchPriceHistory and fetchAllPriceHistory
-    - All test suites passing (1102 total tests)
-
-  **Breaking Changes:** None - fully backward compatible
-
-  **Migration Guide:** Instead of: `sdk.fetchPriceHistory({ tokenId: 'Token|Unit|DKP|eth:...' })`
-  You can now use: `sdk.fetchPriceHistory({ tokenName: 'demonkpop' })`
-
-### Patch Changes
-
-- Fix token format conversion and add DEX spot pricing for graduated launchpad tokens
-
-  **Bug Fixes:**
-  - **CRITICAL**: Fixed PriceHistoryService token format conversion that was losing Ethereum
-    addresses for launchpad tokens
-    - Was converting: `Token|Unit|GDOG|eth:902...` → `GDOG$Unit$none$none` ❌
-    - Now converts: `Token|Unit|GDOG|eth:902...` → `Token$Unit$GDOG$eth:902...` ✅
-    - Impact: All launchpad token price history queries now return data instead of empty results
-    - Affected methods: `fetchPriceHistory()`, `fetchAllPriceHistory()`
-  - Updated test expectations in `price-history-service.test.ts` to validate correct token format
-    - All 1,102 unit tests passing
-
-  **Features:**
-  - New method `DexService.fetchDexTokenSpotPrice(tokenId)` for real-time DEX market prices
-    - Uses `/v1/trade/price` endpoint for accurate graduated token pricing
-    - Supports both pipe-delimited and object token ID formats
-    - Perfect for tokens trading on the DEX post-graduation
-  - Enhanced `fetchLaunchpadTokenSpotPrice()` to intelligently select price source:
-    - Active pool tokens: Uses bonding curve calculation
-    - Graduated tokens: Uses `/v1/trade/price` endpoint for real DEX market prices
-    - Optional `fetchPoolDetails` parameter enables automatic graduation detection
-    - Gracefully falls back to bonding curve if graduation check unavailable
-
-  **SDK Changes:**
-  - `PriceHistoryService.ts`: Fixed token format converter to use `pipeFormatToDollarFormat()`
-    utility
-  - `DexService.ts`: Added `fetchDexTokenSpotPrice()` method with full documentation
-  - `DexService.ts`: Enhanced `fetchLaunchpadTokenSpotPrice()` with graduation detection
-  - Added import of `pipeFormatToDollarFormat` to DexService
-
-  **Test Results:**
-  - All price history service tests passing (33 tests)
-  - All SDK tests passing (1102 total tests)
-  - No regressions detected
-
-  **Breaking Changes:** None - both are enhancements/bug fixes
-
-  **Example Usage (Graduated Token):**
-
-  ```typescript
-  // Graduated token now returns real DEX market price
-  const price = await sdk.fetchLaunchpadTokenSpotPrice(
-    'galadog',
-    calculateBuyAmount,
-    fetchPoolDetails // Optional - enables automatic DEX pricing
-  );
-  // Returns: { symbol: 'GALADOG', price: 0.019110 } (real market price)
-  ```
-
-  **Example Usage (Direct DEX Pricing):**
-
-  ```typescript
-  // Query DEX directly for any trading token
-  const price = await dexService.fetchDexTokenSpotPrice(
-    'Token|Unit|GDOG|eth:902Ef7566c8A8bEe5517FdEC0D7b5d1157942830'
-  );
-  // Returns: { symbol: 'GDOG', price: 0.019110 }
-  ```
-
-- Updated dependencies
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.20.0
-
-## 1.14.3
-
-### Patch Changes
-
-- fix: correct fetchPools tool enum values to match SDK (recent/popular instead of
-  recent/trending/user)
-
-## 1.14.2
-
-### Patch Changes
-
-- feat: enhance MCP SDK usage documentation with 200+ code examples
-  - Add price-history topic with fetchPriceHistory and fetchAllPriceHistory examples
-  - Add token-details topic with token metadata retrieval and validation
-  - Add profile-management topic with user profile workflows
-  - Enhance fetch-pools topic with 9 advanced examples and 11 tool equivalents
-  - Enhance balances topic with additional methods (fetchTokensCreated, fetchProfile)
-  - Expand mcp-to-sdk-mapping with 15+ missing tools across multiple sections
-  - Fix error-handling topic syntax error
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.19.2
-
-## 1.14.0
-
-### Breaking Changes
-
-- **Remove MySQL-dependent MCP tools**
-
-  **BREAKING:** Removed MCP tools that relied on MySQL database. Tool count reduced from 56 to 54.
-
-  **Removed MCP Tools:**
-  - `gala_launchpad_fetch_prices` - Latest token prices (use DEX Backend API in future)
-  - `gala_launchpad_fetch_all_prices` - All latest token prices (use DEX Backend API in future)
-
-  **Environment Variables:**
-  - Removed: `MYSQL_CONNECTION_STRING` (no longer used)
-
-  **Migration Path:**
-  - For historical price data: Use `gala_launchpad_fetch_price_history` (DEX Backend API)
-  - For all historical data: Use `gala_launchpad_fetch_all_price_history` (with auto-pagination)
-  - Latest prices feature: Coming soon to DEX Backend API in future releases
-
-  **Added:**
-  - `gala_launchpad_fetch_all_price_history` - Auto-paginated historical price snapshots
-  - `gala_launchpad_fetch_token_details` - Comprehensive token metadata query
-
-  **Configuration Changes:**
-  - No MySQL configuration needed anymore
-  - DEX Backend API is automatically configured from environment
-
-## 1.13.6
-
-### Patch Changes
-
-- Add fetchTokenDetails() method for comprehensive token metadata queries
-
-  **New Feature:** Implement fetchTokenDetails() method that queries the DEX API platform to
-  retrieve complete token metadata including images, decimals, descriptions, verification status,
-  network information, and trading capabilities.
-
-  **SDK Changes (v3.18.0):**
-  - Add TokenDetails DTO interface with 15+ metadata fields
-  - Implement DexService.fetchTokenDetails(tokenId) with flexible token ID support
-  - Add flat API method to LaunchpadSDK.fetchTokenDetails()
-  - Export TokenDetails type from SDK public API
-  - Comprehensive unit tests (14 tests covering success/error/edge cases)
-
-  **Features:**
-  - Flexible Token ID support: String format ('GUSDC|Unit|none|eth:0x...') or object format
-  - Comprehensive metadata: Returns symbol, name, decimals, image, verification status, network info
-  - DEX API Integration: Queries /v1/tokens endpoint with URL-encoded token class keys
-  - Proper error handling: Validates token existence and format
-  - Performance: Single API request, no pagination required
-
-  **MCP Server Changes (v1.13.6):**
-  - Create gala_launchpad_fetch_token_details MCP tool
-  - Register tool in poolTools with flexible tokenId input schema
-  - Add integration tests for tool handler
-  - Update tool count from 55 to 56 tools
-  - Update documentation in CLAUDE.md with usage examples
-  - Add tool reference to MCP server features list
-
-  **Documentation:**
-  - Add comprehensive pattern documentation to CLAUDE.md
-  - Include usage examples for string and object formats
-  - Document common use cases (token validation, pre-trading checks, network verification)
-  - Add error handling patterns and response structure reference
-  - Update SDK README.md with method signature and return type
-  - Update MCP server version and tool count references
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.18.0
-
-## 1.13.5
-
-### Patch Changes
-
-- Simplify price history response structure with tokenId field
-
-  Replace individual token class fields (collection, category, type, additionalKey) with a single
-  pipe-delimited tokenId field in PriceSnapshot responses.
-
-  Changes:
-  - PriceSnapshot interface now has tokenId: string instead of separate fields
-  - Both fetchPriceHistory and fetchPrices return simplified snapshots
-  - Updated response transformation logic to construct tokenId from API data
-  - Made httpClient optional in PriceHistoryService constructor (only required when using
-    fetchPriceHistory, not for MySQL-only methods)
-
-  Example response change:
-  - Before: { price: '0.166', ..., collection: 'GALA', category: 'Unit', type: 'none',
-    additionalKey: 'none' }
-  - After: { price: '0.166', ..., tokenId: 'GALA|Unit|none|none' }
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.17.0
-
-## 1.13.4
-
-### Patch Changes
-
-- ## Fix: Support Both GalaChain Token Format Variants (v3.16.4)
-
-  Enhanced token format handling to support both GalaChain token ID formats seamlessly.
-
-  GalaChain supports two token ID format variants:
-
-  **Format 1: Standard (collection="Token")**
-
-  ```
-  Token|Unit|BENE|none → GALA$Unit$none$none
-  Token|Unit|SILK|none → SILK$Unit$none$none
-  ```
-
-  **Format 2: Direct (collection=token name)**
-
-  ```
-  GALA|Unit|none|none → GALA$Unit$none$none
-  SILK|Unit|none|none → SILK$Unit$none$none
-  ```
-
-  Both are now handled correctly by detecting which field contains the token name and extracting it
-  appropriately for the DEX Backend API.
-
-  Changes:
-  - Detect token name location based on collection field
-  - Extract from `type` field if collection="Token", otherwise from `collection` field
-  - Build API format consistently: `{TOKEN_NAME}$Unit$none$none`
-  - Both token format variants now work identically
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.16.4
-
-## 1.13.3
-
-### Patch Changes
-
-- ## Fix: Correct Token Format Conversion for Price History (v3.16.3)
-
-  Simplified token format conversion - removed overly strict validation and corrected the format
-  transformation logic.
-
-  The API expects simple pipe-to-dollar conversion:
-  - Input: `GALA|Unit|none|none`
-  - Output: `GALA$Unit$none$none`
-
-  Changed PriceHistoryService to:
-  - Use existing token normalization utilities
-  - Apply simple pipe-to-dollar format conversion
-  - Remove overly strict token format validation that was incorrectly rejecting valid formats
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.16.3
-
-## 1.13.2
-
-### Patch Changes
-
-- ## Enhancement: Token Format Validation for Price History (v3.16.2)
-
-  **Added validation** to ensure correct token ID format for DEX Backend API compatibility.
-
-  The price history API requires tokens to follow GalaChain's standard format where the token name
-  is stored in the `type` field:
-
-  ### Valid Formats
-
-  ✅ String format: `Token|Unit|{TOKEN_NAME}|{additionalKey}`
-
-  ```typescript
-  sdk.fetchPriceHistory({ tokenId: 'Token|Unit|BENE|none' });
-  sdk.fetchPriceHistory({ tokenId: 'Token|Unit|SILK|none' });
-  ```
-
-  ✅ Object format:
-  `{ collection: "Token", category: "Unit", type: "{TOKEN_NAME}", additionalKey: "{key}" }`
-
-  ```typescript
-  sdk.fetchPriceHistory({
-    tokenId: { collection: 'GALA', category: 'Unit', type: 'none', additionalKey: 'none' },
-  });
-  ```
-
-  ### Invalid Formats (Now Rejected)
-
-  ❌ `GALA|Unit|none|none` - Token name in first field instead of third ❌ `Gala|Unit|none|none` -
-  Mixed case, ambiguous format ❌
-  `{ collection: 'GALA', category: 'Unit', type: 'none', additionalKey: 'none' }` - Wrong field
-  mapping
-
-  ### Error Messages
-
-  When invalid format is provided, users now get clear guidance:
-
-  ```
-  Invalid tokenId format for price history. Expected format: "Token|Unit|{TOKEN_NAME}|{additionalKey}"
-  (e.g., "Token|Unit|BENE|none"). Received: "GALA|Unit|none|none".
-  The token name must be in the third field (type), not the first field (collection).
-  ```
-
-  ### Changes
-  - Added comprehensive token format validation in `PriceHistoryService.validateOptions()`
-  - Validates both string and object token ID formats
-  - Provides clear error messages with examples
-  - Prevents silent failures from incorrect token format mapping
-  - Ensures DEX Backend API receives correctly formatted token identifiers
-
-  This prevents subtle bugs where tokens like `GALA|Unit|none|none` would be silently converted to
-  `none$Unit$none$none` (wrong).
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.16.2
-
-## 1.13.1
-
-### Patch Changes
-
-- ## Fix: Price History Token Format Mapping (v3.16.1)
-
-  **Critical Fix:** Corrects token ID format conversion for DEX Backend API.
-
-  The DEX Backend API uses a different token format than GalaChain:
-  - API format: `tokenName$Unit$none$none` (e.g., `GALA$Unit$none$none`)
-  - SDK format: `collection|category|type|additionalKey` (e.g., `Token|Unit|BENE|none`)
-
-  ### Changes
-
-  **PriceHistoryService.ts:**
-  - Fixed token format conversion when calling DEX Backend API
-  - Now correctly maps GalaChain TokenInstanceKey fields to API format
-  - Token name is extracted from the `type` field (where it's stored in GalaChain)
-  - API always receives properly formatted: `{tokenName}$Unit$none$none`
-
-  ### Impact
-  - `fetchPriceHistory()` now returns historical price data correctly
-  - MCP tool `gala_launchpad_fetch_price_history` now works as expected
-  - All 30,000+ price snapshots now accessible for supported tokens
-
-  ### Before
-
-  ```typescript
-  // Input: Token|Unit|BENE|none
-  // Converted to: Token$Unit$GALA$none (WRONG - API expected GALA$Unit$none$none)
-  // Result: Empty response, no historical data
-  ```
-
-  ### After
-
-  ```typescript
-  // Input: Token|Unit|BENE|none
-  // Converted to: GALA$Unit$none$none (CORRECT)
-  // Result: Returns all 30,862 GALA price snapshots
-  ```
-
-  This is a critical fix for price history functionality.
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.16.1
-
-## 1.13.0
-
-### Minor Changes
-
-- ## Price History API Migration (v3.16.0)
-
-  Migrate `fetchPriceHistory` and `fetchAllPriceHistory` methods from MySQL database backend to DEX
-  Backend API for improved performance and real-time data availability.
-
-  ### SDK Changes (@gala-chain/launchpad-sdk)
-  - **New**: Added `tokenFormatConverter` utility (`src/utils/tokenFormatConverter.ts`)
-    - Convert between pipe-delimited (`GUSDC|Unit|none|eth:...`) and dollar-delimited token formats
-    - Convert sort order from SDK format (uppercase) to API format (lowercase)
-  - **Updated**: `environments.ts` - Added separate `dexBackendBaseUrl` configuration for DEX
-    Backend service
-    - Production: `https://dex-backend-prod1.defi.gala.com`
-    - Stage: `https://dex-backend-dev1.defi.gala.com`
-  - **Updated**: `PriceHistoryService` - Migrated to DEX Backend API
-    - `fetchPriceHistory()` now uses `/price-oracle/fetch-price` endpoint
-    - `fetchAllPriceHistory()` uses automatic pagination over API
-    - Automatic token format conversion (pipe → dollar delimited)
-    - Automatic sort order conversion (uppercase → lowercase)
-    - `fetchPrices()` and `fetchAllPrices()` remain MySQL-based for latest price queries
-  - **Updated**: `LaunchpadSDK` - Added `dexBackendHttp` client initialization with
-    `dexBackendBaseUrl`
-  - **Updated**: Type definitions - Added `DexPriceOracleResponse` interface for API response
-    mapping
-  - **Updated**: Tests - Updated to mock HTTP client instead of MySQL connections
-    - Added tests for token format conversion
-    - Added tests for sort order conversion
-    - Added tests for API error handling
-
-  ### MCP Changes (@gala-chain/launchpad-mcp-server)
-  - **Updated**: `fetchPriceHistory` tool description
-    - Reflects new DEX Backend API endpoint usage
-    - Removes MySQL configuration requirements
-    - Adds endpoint reference (`/price-oracle/fetch-price`)
-  - **Updated**: `fetchAllPriceHistory` tool description
-    - Updated for API-based implementation
-    - Reflects automatic pagination handling
-
-  ### Documentation
-  - **Updated**: `CLAUDE.md` - Comprehensive price history patterns documentation
-    - Dual-backend architecture explanation
-    - API vs MySQL comparison
-    - Configuration examples for both methods
-    - Performance characteristics for each approach
-    - Important notes for API-based queries
-
-  ### Backward Compatibility
-
-  ✅ Fully backward compatible - SDK interfaces unchanged ✅ Automatic format conversion handles
-  token format differences ✅ Dual-backend support maintains MySQL for price sheet queries
-
-  ### Performance Improvements
-  - ✅ API-based queries typically <500ms per request
-  - ✅ Real-time data availability
-  - ✅ No database connection overhead
-  - ✅ Improved scalability for high-volume queries
-
-### Patch Changes
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.16.0
-
-## 1.12.4
-
-### Patch Changes
-
-- docs: comprehensive documentation updates for price history methods
-
-  ### SDK Documentation Updates
-  - Added complete documentation for all 4 price history methods in README.md
-    - fetchPriceHistory (paginated)
-    - fetchAllPriceHistory (auto-paginated)
-    - fetchPrices (paginated latest prices)
-    - fetchAllPrices (auto-paginated latest prices)
-  - Added comprehensive examples showing usage patterns, configuration, and workflows
-  - Updated MySQL configuration section with code examples for all 4 methods
-  - Added price history patterns documentation to CLAUDE.md
-  - Added latest token price queries section to CLAUDE.md with detailed examples
-  - Created comprehensive fetch-all-price-history-demo.ts example script
-    - Demonstrates statistical analysis, trend calculation, moving averages
-    - Shows CSV export, time period comparison, and multi-token analysis
-    - Includes volatility calculation and price statistics
-
-  ### MCP Server Documentation Updates
-  - Updated tool count from 52 to 55 in README (includes 4 price history tools)
-  - Added "Price History & Analysis" section documenting 4 price history tools
-  - Updated MCP installation version references (1.12.3, SDK 3.15.3)
-  - Added complete price history tool descriptions with use cases and examples
-
-  ### Agent Documentation Updates
-  - Updated @agent-galachain-launchpad-developer.md
-    - Updated SDK method count: 46 → 50 (includes price history)
-    - Updated MCP tool count: 51 → 55 (includes 4 price history tools)
-    - Updated version references: v3.11.0+ → v3.15.3+
-    - Added "Price History & Analysis" section to Complete Method Reference
-    - Updated service architecture to include PriceHistoryService
-    - Updated support section with latest version information
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.15.4
-
-## 1.12.3
-
-### Patch Changes
-
-- Bump SDK dependency to v3.15.3 with pool connection fix
-
-  Updates @gala-chain/launchpad-sdk from ^3.15.2 to ^3.15.3 to include the fix for fetchPrices pool
-  initialization.
-
-## 1.12.2
-
-### Patch Changes
-
-- Bump SDK dependency to v3.15.2 with fetchPrices fix
-
-  Updates @gala-chain/launchpad-sdk from ^3.15.1 to ^3.15.2 to include the fix for fetchPrices and
-  fetchAllPrices methods.
-
-## 1.12.1
-
-### Patch Changes
-
-- Add comprehensive test coverage and example scripts for fetchPrices and fetchAllPrices methods
-
-  **SDK Changes:**
-  - Added 11 unit tests for fetchPrices and fetchAllPrices validation in
-    price-history-service.test.ts
-  - Added 19 integration tests for fetchPrices and fetchAllPrices functionality in
-    price-history-service.integration.ts
-  - Improved PriceHistoryService test coverage from 31.44% to 51.57% (+20.13 percentage points)
-  - All 1096 tests passing
-
-  **Example Scripts:**
-  - Added examples/validate-fetch-prices.ts: Validates methods without MySQL setup, shows signatures
-    and usage
-  - Added examples/fetch-prices-demo.ts: Full demonstration with 5 use cases (pagination, sorting,
-    auto-pagination, statistics)
-
-  **Test Coverage Details:**
-  - Unit Tests: Parameter validation, error handling, edge cases
-  - Integration Tests: Empty results, latest price selection, multiple tokens, pagination, sorting,
-    large datasets, auto-pagination combining
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.15.1
-
-## 1.12.0
-
-### Minor Changes
-
-- Add fetchPrices() and fetchAllPrices() methods for fetching latest token prices
-
-  Implements methods to fetch the most recent price snapshot for all unique tokens in the database,
-  useful for market overviews and bulk price comparisons.
-
-  Changes:
-  - Added FetchPricesOptions and PricesResult types to priceHistory.dto.ts
-  - Added fetchPrices() method to PriceHistoryService with pagination support
-  - Added fetchAllPrices() convenience method with automatic pagination
-  - Exposed both methods from LaunchpadSDK wrapper class
-  - Created MCP tools: gala_launchpad_fetch_prices and gala_launchpad_fetch_all_prices
-  - Updated tool count from 53 to 55 (pools category now has 18 tools)
-  - Uses window function (ROW_NUMBER) for optimal database query performance
-
-### Patch Changes
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.15.0
-
-## 1.11.0
-
-### Minor Changes
-
-- Add fetchAllPriceHistory convenience method for automatic pagination
-
-  Implements automatic pagination convenience method for price history queries, following the
-  established fetchAllPools pattern for consistency.
-
-  Changes:
-  - Added fetchAllPriceHistory method to LaunchpadSDK wrapper class that handles pagination
-    automatically
-  - Created MCP tool gala_launchpad_fetch_all_price_history with automatic pagination support
-  - Updated tool count from 52 to 53 (pools category now has 16 tools)
-  - Follows established fetchAllPools pattern for API consistency
-
-### Patch Changes
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.14.0
-
-## 1.10.0
-
-### Minor Changes
-
-- b45e5e0: Add: Integrate `fetchPriceHistory` MCP tool for historical token price analysis
-
-  The MCP server now includes a new tool (`gala_launchpad_fetch_price_history`) for querying
-  historical price snapshots from the MySQL database. This enables AI agents to perform historical
-  price analysis, trend identification, and volatility assessment. The tool supports flexible token
-  ID formats, date range filtering, pagination, and sort options.
-
-  **Key Features:**
-  - Flexible token ID support (string and object formats)
-  - Date range filtering with optional start/end dates
-  - Efficient pagination (max 100 items per page)
-  - Ascending/descending sort order control
-  - MySQL connection string configuration via environment variable
-
-  **Configuration:**
-  - Added `MYSQL_CONNECTION_STRING` environment variable support
-  - MySQL connection string passed to SDK via AgentConfig config passthrough
-  - Extended AgentSDKConfig interface for optional SDK configuration merging
-
-  **Updates:**
-  - Updated SDK dependency from @gala-chain/launchpad-sdk@^3.12.8 to
-    @gala-chain/launchpad-sdk@^3.13.0
-  - Total tools: 51 → 52 (pool management tools: 14 → 15)
-
-## 1.8.2
-
-### Patch Changes
-
-- Fix SDK version detection by using build-time version injection instead of runtime file reading.
-  The SDK now generates a version constant during build, ensuring it works in all environments
-  (Node.js, browser, bundled). Additionally, added a `/version` slash command to the MCP server for
-  easy version checking.
-
-  ### Changes:
-  - **SDK**: Implement build-time version injection via `scripts/inject-version.ts`, matching the
-    MCP server pattern
-  - **SDK**: Update `packages/sdk/package.json` to run `build:version` before compilation
-  - **MCP Server**: Add new `utility` prompt category with `/version` command to fetch and display
-    SDK/MCP server versions
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.12.8
-
-## 1.8.1
-
-### Patch Changes
-
-- Fix: Pin MCP to SDK v3.12.7 (latest stable with bug fixes)
-
-  Updated SDK dependency from flexible `*` to pinned `^3.12.7`.
-
-  **Rationale:**
-  - Pinning ensures deliberate, tested updates instead of automatic surprises
-  - Provides stability and prevents accidental breaking changes
-  - v3.12.7 includes critical bug fixes (File polyfill, version detection)
-  - The pin MUST be updated immediately when SDK releases critical fixes
-  - Prevents users from falling behind on essential bug fixes
-
-  **Discipline required:** Every SDK release cycle, update the MCP pin. No lagging behind.
-
-## 1.8.0
-
-### Minor Changes
-
-- Update: Use flexible SDK version constraint instead of pinned version
-
-  Changed SDK dependency from pinned `^3.12.4` to flexible `*` (any version).
-
-  **Rationale:**
-  - Overly restrictive version pinning prevents automatic SDK updates
-  - MCP server should always use the latest stable SDK without requiring manual version bumps
-  - Using `*` allows npm to automatically fetch the latest published SDK version
-  - This ensures bug fixes, security patches, and new features in SDK are immediately available
-  - Reduces maintenance burden of manually updating version constraints after each SDK release
-
-  **Impact:**
-  - MCP server will now automatically use the latest SDK version available on npm
-  - Bug fixes (like the File polyfill fix in v3.12.6 and version detection fix in v3.12.7) are now
-    available immediately
-  - Users get security updates and improvements without waiting for explicit MCP server releases
-
-  This is the correct pattern for stable, production-ready packages where the dependency is actively
-  maintained and semantically versioned.
-
-## 1.7.15
-
-### Patch Changes
-
-- chore: update SDK dependency to v3.12.4 (fixes Node.js File API issue)
-
-  Updates SDK dependency to v3.12.4 which fixes the CommonJS File API ReferenceError in Node.js 18+
-  by using the official web-file-polyfill package.
-
-## 1.7.12
-
-### Patch Changes
-
-- Update to SDK v3.12.3 which fixes CommonJS File API ReferenceError in Node.js 18+
-
-## 1.7.11
-
-### Patch Changes
-
-- Add dynamic version tools and fix CommonJS uuid bundling conflict
-
-  **SDK Changes:**
-  - Added `getVersion()` method to LaunchpadSDK class that returns the SDK version dynamically read
-    from package.json
-  - Created `src/constants/version.ts` with SDK_VERSION constant that reads from package.json at
-    module load
-  - Version is read using require() with proper error handling for different environments
-  - **Fixed CommonJS build**: Updated `rollup.config.mjs` to bundle uuid only in CommonJS format
-    - Conditional externals: uuid excluded from CJS externals but included in ESM/UMD externals
-    - Resolves "ERR_REQUIRE_ESM" error when requiring uuid v13.0.0 (ESM-only package) in CommonJS
-      environments
-    - UMD/ESM bundles remain optimized with uuid external (~34KB)
-    - CJS bundle includes uuid (~44KB) for complete self-contained CommonJS compatibility
-
-  **MCP Server Changes:**
-  - Created version injection script (`scripts/inject-version.ts`) that runs as a prebuild step
-  - Added `build:version` npm script that injects MCP server version into `src/generated/version.ts`
-  - Updated `.gitignore` to exclude auto-generated version file
-  - Created `getVersionTool` MCP tool that returns both SDK and MCP server versions with timestamp
-
-  Both versions are now dynamically read from their respective package.json files, ensuring they
-  always stay in sync without manual version management in code. The CommonJS bundle now
-  self-contains uuid to resolve ESM-only module conflicts in Node.js require() scenarios.
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.12.2
-
-## 1.7.10
-
-### Patch Changes
-
-- Comprehensive documentation for CommonJS support and module formats
-
-  **SDK Updates:**
-  - Document all three module formats (ESM, CommonJS, UMD)
-  - Add module resolution table showing automatic format selection
-  - Clarify when to use each format with concrete examples
-  - Explain package.json exports configuration
-
-  **MCP Server Updates:**
-  - Document CommonJS module format
-  - Explain integration with SDK's multi-format support
-  - Clarify automatic format selection by Node.js
-
-  **Project Configuration (CLAUDE.md):**
-  - Enhanced Build System section with detailed format breakdown
-  - Added comprehensive "Launchpad SDK Module Formats (v3.12.0+)" section
-  - Include size monitoring metrics for all three bundles
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.12.1
-
-## 1.7.9
-
-### Patch Changes
-
-- Fix: Update STAGE environment launchpadFrontendUrl from lpad-frontend-dev1 to lpad-frontend-test1
-  to correct MCP tool URL generation for token frontend links
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.11.8
-
-## 1.7.8
-
-### Patch Changes
-
-- Add token-distribution topic to explainSdkUsage tool
-  - New topic: 'token-distribution' - Analyze token holder distribution and concentration
-  - Includes complete code examples for analyzing holder distribution
-  - Added Gini coefficient calculation example for wealth distribution analysis
-  - Added whale detection and concentration risk analysis patterns
-  - Shows how to identify top holders and calculate ownership percentages
-  - Updated tool description and enum to include new topic
-
-## 1.7.7
-
-### Patch Changes
-
-- Update documentation across all files to reference correct SDK and MCP versions (3.11.7 and 1.7.7)
-- Add comprehensive Token Distribution Patterns section to CLAUDE.md
-- Update explainSdkUsage tool to show v3.11.7
-
-## 1.7.6
-
-### Patch Changes
-
-- Update SDK dependency to v3.11.6 with TypeScript declaration file fixes
-- Fixed TypeScript declaration file output structure by restoring correct tsconfig.json
-  configuration
-
-## 1.7.5
-
-### Patch Changes
-
-- Update SDK dependency to v3.11.4 with complete type safety improvements
-
-## 1.7.4
-
-### Patch Changes
-
-- Fix demo script failures caused by missing tokenName field in poolDetails response.
-
-  **Root Causes:**
-  - GalaChainService response transformation broke property access after Phase 2 type safety changes
-  - fetchPoolDetails didn't include tokenName field that demo code expects
-
-  **Changes:**
-  - Add tokenName field to fetchPoolDetails return value for convenience
-  - Fix GalaChainService response transformation to preserve structure using type assertion patterns
-  - Maintain type safety throughout with proper TypeScript patterns
-
-  **Impact:**
-  - Resolves 9 failing demo scenarios with "Token name is required" validation errors
-  - All calculation methods (calculateBuyAmountLocal, calculateSellAmountLocal, calculateBuyAmount)
-    now work correctly
-  - Demo script runs without validation errors
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.11.3
-
-## 1.7.3
-
-### Patch Changes
-
-- chore: Update SDK dependency to 3.11.2
-
-## 1.7.1 - 2025-10-11
-
-### Fixed
-
-- **Tool registry validation error** - Fixed hardcoded tool count mismatch
-  - Registry was expecting 49 tools but actual count was 50 tools
-  - Added 2 tools from cache feature (getCacheInfo, clearCache) not accounted for in v1.7.0
-  - Updated tool registry validation from 49 to 50
-  - Fixed all documentation to reflect correct tool counts (48→50)
-  - Fixed Pool Management tool count (10→14) to match actual code
-
-### Changed
-
-- Updated package.json description from "48 tools" to "50 tools"
-- Updated MCP README tool counts (48→50 total, 10→14 pool tools)
-- Updated SDK README MCP tool reference (48→50)
-- Updated agent definition file tool counts
-- Added missing 4 pool tools to README list (spot price and resolution tools)
-- Removed duplicate "Pricing & Spot Price" section from README
-- Updated Utility Tools count (3→9) with complete tool list
-
-### Context
-
-v1.7.0 was published with incorrect tool counts due to not accounting for cache management tools
-added in v1.6.0. The registry validation expected 49 tools but 50 were actually registered, causing
-the MCP server to crash on startup with "Tool registry validation failed: Tool count mismatch:
-expected 49, got 50".
-
-## 1.7.0 - 2025-10-11
-
-### Added
-
-- **fetchAllPools tool** - Auto-pagination for complete pool queries
-  - `gala_launchpad_fetch_all_pools` - Fetch all available pools without manual pagination
-  - Automatically fetches all pages concurrently (up to 5 parallel requests)
-  - Supports search filtering and type filters (recent/popular)
-  - Returns complete pool dataset in single response
-  - No page/limit parameters needed - returns ALL matching pools
-
-- **fetchAllPools slash command** - Guided workflow for bulk pool analysis
-  - `galachain-launchpad:fetch-all-pools` - AI-guided complete pool fetching
-  - Provides summary statistics and pool categorization
-  - Suggests next actions based on pool data
-
-### Changed
-
-- Updated SDK dependency from ^3.10.0 to ^3.11.0
-- Tool count increased from 49 to 50 tools (NOTE: v1.6.0 added 2 cache tools, bringing count from 47
-  to 49)
-- Pool Management tools increased from 13 to 14 tools
-- Benefits from SDK v3.11.0 auto-pagination with 5x performance improvement
-
-### Benefits
-
-- ✅ Zero configuration - fetch all pools in one call
-- ✅ 5x performance improvement via concurrent requests
-- ✅ Eliminates manual pagination loops in AI agents
-- ✅ Simplified pool discovery and analysis workflows
-
-## 1.2.20 - 2025-10-02
-
-### Changed
-
-- Updated SDK dependency from ^3.7.5 to ^3.7.6
-- Inherits graduation calculation documentation improvements from SDK v3.7.6
-
-## 1.2.19 - 2025-10-02
-
-### Documentation
-
-- **Critical graduation calculation clarification** - Added comprehensive documentation to prevent
-  misinterpretation of `calculateBuyAmountForGraduation` results
-  - Updated MCP README with "Understanding Graduation Calculations" section
-  - Added amount field reference table showing what each calculation method returns
-  - Clarified that `amount` field represents **GALA cost** (e.g., "1594263.419" = 1.59 million
-    GALA), NOT token quantity
-  - Added real-world examples showing wrong vs correct interpretation
-  - Updated CLAUDE.md with "Token Graduation Patterns" section and complete workflow examples
-  - Emphasized that graduation amounts are typically hundreds of thousands to millions of GALA
-
-### Benefits
-
-- ✅ AI agents will correctly interpret graduation costs as GALA amounts
-- ✅ Prevents confusion between GALA cost and token quantity
-- ✅ Clear reference table for all calculation method return values
-- ✅ Better understanding of bonding curve graduation mechanics
-
-## 1.2.15
-
-### Patch Changes
-
-- Fix memory leaks and enable incremental builds
-  - Fix WebSocket onAny listener cleanup
-  - Fix HTTP interceptor cleanup
-  - Enable incremental TypeScript builds (50% faster rebuilds)
-  - Add comprehensive performance documentation
-
-- Updated dependencies
-  - @gala-chain/launchpad-sdk@3.7.1
-
-All notable changes to the Gala Launchpad MCP Server will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project
-adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [1.2.4] - 2025-10-02
-
-### Changed
-
-- **Internal code quality improvements** - Schema consolidation across all 37 MCP tools
-  - Created centralized `common-schemas.ts` with 15+ reusable schema definitions
-  - Updated all tools to use shared schemas (TOKEN_NAME_SCHEMA, PRIVATE_KEY_SCHEMA, etc.)
-  - Added `createLimitSchema()` function for operation-specific pagination constraints
-  - Eliminated ~50+ inline schema repetitions across 7 tool categories
-  - No breaking changes - 100% backward compatible with all AI agents
-- Updated SDK dependency from ^3.5.1 to ^3.5.2
-
-### Benefits
-
-- ✅ Improved code maintainability and consistency
-- ✅ Single source of truth for all schema definitions
-- ✅ Easier to maintain and update validation rules
-- ✅ All tools tested and working with Claude Desktop
-
-## [1.2.3] - 2025-10-01
-
-### Documentation
-
-- **Enhanced trading workflow documentation** - Critical updates to prevent transaction failures
-  - Added new Gotcha #1: Missing reverseBondingCurveFee Parameter with real-world failure examples
-  - Updated trading workflows (buy & sell) to emphasize BOTH expectedAmount AND
-    reverseBondingCurveFee requirements
-  - Updated tool descriptions for `gala_launchpad_buy_tokens` and `gala_launchpad_sell_tokens`
-  - Changed `maxAcceptableReverseBondingCurveFee` description from "Optional" to "RECOMMENDED"
-  - Added explicit warning: "Omitting this may cause transaction failures"
-  - Renumbered existing gotchas to accommodate new critical gotcha
-  - Fixed type parameter references from 'token' to 'exact' throughout documentation
-
-### Benefits
-
-- ✅ AI agents will now include reverseBondingCurveFee parameter by default
-- ✅ Reduced transaction failures due to missing fee parameter
-- ✅ Clearer workflow examples with complete parameter extraction
-- ✅ Better troubleshooting guidance with real failure examples
-
-### Context
-
-This update addresses a recurring issue where AI agents forgot to pass the `reverseBondingCurveFee`
-parameter, causing "FAILED" transaction statuses. The documentation now treats this parameter as
-critical rather than optional.
-
-## [1.2.2] - 2025-10-01
-
-### Changed
-
-- **Tool parameter standardization** - Renamed `walletAddress` to `address` in 6 MCP tools
-  - Updated tools: `gala_launchpad_fetch_gala_balance`, `gala_launchpad_fetch_token_balance`,
-    `gala_launchpad_fetch_profile`, `gala_launchpad_update_profile`,
-    `gala_launchpad_upload_profile_image`
-  - All tools now accept both `0x...` (Ethereum) and `eth|...` (GalaChain) formats
-  - Address formats automatically normalized by SDK
-  - Error messages updated to reference `address` field
-- Updated SDK dependency from ^3.5.0 to ^3.5.1
-
-### Documentation
-
-- Updated AI-AGENT-PATTERNS.md with new `address` parameter examples
-- Updated validation patterns table with address auto-normalization info
-- Error handler now references `address` instead of `walletAddress`
-
-### Benefits
-
-- ✅ AI agents can use natural `0x...` addresses without manual conversion
-- ✅ Consistent parameter naming across all tools
-- ✅ Better developer experience with automatic format handling
-
-## [1.2.0] - 2025-10-01
-
-### Added
-
-- **Multi-wallet support via privateKey override** - All signing operations now accept optional
-  `privateKey` parameter
-  - Enables AI agents to execute operations from different wallets without restarting the MCP server
-  - Added `privateKey` parameter to 9 MCP tools:
-    - Trading: `gala_launchpad_buy_tokens`, `gala_launchpad_sell_tokens`
-    - Token Creation: `gala_launchpad_launch_token`, `gala_launchpad_upload_token_image`,
-      `gala_launchpad_upload_profile_image`
-    - Transfers: `gala_launchpad_transfer_gala`, `gala_launchpad_transfer_token`
-    - Social & Profile: `gala_launchpad_post_comment`, `gala_launchpad_update_profile`
-  - `privateKey` must be in format: `'0x' + 64 hexadecimal characters`
-  - If provided, operation uses specified wallet instead of default MCP server wallet
-  - Powered by SDK v3.5.0 multi-wallet support
-
-### Changed
-
-- Updated SDK dependency from ^3.3.4 to ^3.5.0
-
-### Benefits
-
-- ✅ Test multi-wallet trading scenarios in AI agents
-- ✅ Build multi-user trading bots with Claude Desktop
-- ✅ Simulate different user behaviors without server restart
-- ✅ Create automated market maker systems
-- ✅ Operate multiple wallets from single MCP server instance
-
-### Documentation
-
-- Added comprehensive multi-wallet section to MCP README
-- Included security considerations for privateKey usage
-- Added multi-wallet trading scenario examples
-
-## [1.1.11] - 2025-10-01
-
-### Changed
-
-- **Disabled auto-validation on startup** - Removed unnecessary GALA balance check when MCP server
-  starts
-  - Changed `autoValidate: false` to prevent startup warnings for wallets with zero balance
-  - SDK still functions perfectly for all read operations (pools, prices, comments, etc.)
-  - Validation only needed when performing transactions (which require GALA anyway)
-  - Eliminates confusing "SDK not ready" warnings on server initialization
-
-### Fixed
-
-- Misleading "Failed to fetch GALA balance: No balance returned" warning on startup
-  - Now only validates balance when actually needed for transactions
-  - Cleaner startup experience for read-only MCP usage
-
-## [1.1.10] - 2025-10-01
-
-### Changed
-
-- Updated SDK dependency from ^3.3.3 to ^3.3.4
-- Benefits from SDK v3.3.4 launchpad token precision fixes (18 decimals preserved)
-
-## [1.1.9] - 2025-09-30
-
-### Added
-
-- **Token Class Key Resolution Tool** - GalaChain utility for direct blockchain operations
-  - `gala_launchpad_resolve_token_class_key` - Convert token name to GalaChain TokenClassKey
-    - Returns complete TokenClassKey structure: `{collection, category, type, additionalKey}`
-    - Essential for direct GalaChain API operations outside SDK abstractions
-    - Complements existing `gala_launchpad_resolve_vault_address` tool
-  - AI agents can now access both utility methods for complete GalaChain integration
-
-### Changed
-
-- Updated SDK dependency from ^3.3.1 to ^3.3.2
-- Tool count increased from 31 to 32 tools
-- Pool tools increased from 11 to 12 tools
-
-### Documentation
-
-- SDK v3.3.2 now exports TokenClassKey types for downstream consumers
-- Both `resolveTokenClassKey()` and `resolveVaultAddress()` are official public SDK APIs
-
-## [1.1.8] - 2025-09-30
-
-### Added
-
-- **Spot Price Tools** - Complete price discovery for tokens (3 new tools)
-  - `gala_launchpad_fetch_token_spot_price` - General DEX tokens (single or array)
-    - Fetch USD spot prices for tokens like GALA, SILK, MUSIC, etc.
-    - Accepts single symbol string or array of symbols
-    - Returns `TokenSpotPrice[]` with `{ symbol: string, price: number }`
-  - `gala_launchpad_fetch_gala_spot_price` - GALA convenience method
-    - Fetch current GALA USD price without parameters
-    - Returns single `TokenSpotPrice` object
-  - `gala_launchpad_fetch_launchpad_token_spot_price` - Launchpad tokens by name
-    - Fetch USD spot price for launchpad tokens (e.g., "dragnrkti", "rocketri")
-    - Returns `TokenSpotPrice` with symbol and price
-  - AI agents can now make price-informed trading decisions
-
-### Changed
-
-- Updated SDK dependency from ^3.3.0 to ^3.3.1
-- Tool count increased from 28 to 31 tools
-- Pool tools increased from 8 to 11 tools
-
-### Fixed
-
-- **fetchPoolDetails response** - Now returns clean data structure
-  - SDK v3.3.1 fix removes Status wrapper from response
-  - MCP now receives `PoolDetailsData` directly instead of `{ Status: 1, Data: {...} }`
-  - Cleaner response format for AI agent consumption
-
-## [1.1.7] - 2025-09-30
-
-### Fixed
-
-- **BREAKING:** Trading type parameter values corrected from 'token' to 'exact'
-  - SDK expects `type: 'native' | 'exact'` but MCP was using `'native' | 'token'`
-  - Affected tools: calculateBuyAmount, calculateSellAmount, buy, sell, calculateInitialBuy
-  - Now imports TRADING_TYPES constant from SDK for single source of truth
-
-- **BREAKING:** Pool type parameter values corrected
-  - SDK supports `type: 'recent' | 'popular'` but MCP was using `'recent' | 'trending' | 'user'`
-  - Removed invalid 'trending' and 'user' options
-  - Now imports POOL_TYPES constant from SDK for single source of truth
-  - Affected tool: fetchPools
-
-### Changed
-
-- Updated SDK dependency from ^3.2.0 to ^3.3.0
-- All type enums now use `Object.values(TRADING_TYPES)` and `Object.values(POOL_TYPES)`
-- Ensures MCP tool schemas always match SDK type definitions
-
-### Benefits
-
-- Type safety via SDK constants import
-- Prevents future type mismatches
-- Auto-completion shows correct values
-- Single source of truth pattern
-
-## [1.1.6] - 2025-09-30
-
-### Fixed
-
-- **postComment tool response** - Fixed MCP response validation error
-  - SDK's `postComment()` returns `Promise<void>` (no data)
-  - Handler was passing `undefined` to `formatSuccess()`
-  - This created invalid MCP response: `{ content: [{ type: 'text', text: undefined }] }`
-  - MCP SDK requires `text` field to be a string, not undefined
-  - Now returns explicit success message:
-    `{ success: true, message: 'Comment posted successfully' }`
-  - Resolves: "Required" validation error on `content[0].text` path
-
-## [1.1.5] - 2025-09-30
-
-### Fixed
-
-- **postComment tool** - Renamed parameter from "content" to "message"
-  - **BREAKING CHANGE:** Parameter renamed to avoid MCP reserved word collision
-  - MCP SDK treats "content" as special parameter requiring content blocks format
-  - New signature: `postComment(tokenName: string, message: string)`
-  - Old signature: `postComment(tokenName: string, content: string)` ❌
-  - Internal: MCP parameter "message" maps to SDK parameter "content"
-
-### Migration
-
-```typescript
-// Before (v1.1.4 and earlier)
-gala_launchpad_post_comment({ tokenName: 'anime', content: 'Great token!' });
-
-// After (v1.1.5+)
-gala_launchpad_post_comment({ tokenName: 'anime', message: 'Great token!' });
-```
-
-## [1.1.4] - 2025-09-30
-
-### Changed
-
-- Version bump for update verification (no code changes)
-
-## [1.1.3] - 2025-09-30
-
-### Fixed
-
-- **postComment tool** - Simplified to use standard MCP tool parameter pattern
-  - Tool parameters should be simple JSON Schema types (string, not content blocks)
-  - Content blocks format is for tool results/prompts/resources, not input parameters
-  - Removed unnecessary content extraction logic from handler
-  - Clean, simple implementation: string parameter → SDK string parameter
-
-## [1.1.2] - 2025-09-30 [DEPRECATED]
-
-### Fixed (Incorrect Approach)
-
-- ~~postComment tool schema - Used overly complex oneOf schema~~ (reverted in 1.1.3)
-
-## [1.1.1] - 2025-09-30
-
-### Fixed
-
-- **postComment tool** - Fixed content format handling for MCP protocol
-  - Now correctly extracts text from MCP content blocks array
-  - Handles both direct string and MCP content blocks format
-  - Fixes "validation error" when posting comments
-- **SDK dependency** - Updated to ^3.2.0 to include getUrlByTokenName method
-  - Fixes "method not found" error on getUrlByTokenName tool
-  - Ensures all 28 MCP tools are functional
-
-### Dependencies
-
-- Updated `@gala-chain/launchpad-sdk` from ^3.1.0 to ^3.2.0
-
-## [1.1.0] - 2025-09-30
-
-### Added
-
-- **AI-AGENT-PATTERNS.md** - Comprehensive AI agent guide with common workflows, gotchas, and best
-  practices
-- **CONSTRAINTS-REFERENCE.md** - Technical reference for SDK-to-MCP constraint mappings
-- **Central constraints utility** (`src/utils/constraints.ts`) - Single source of truth for
-  pagination limits
-- **AI-friendly error messages** - Enhanced error handler with contextual tips for common errors
-- **Workflow documentation** - Added detailed workflow comments to trading and creation tools
-
-### Fixed
-
-- **BREAKING:** Fixed constraint mismatches between MCP tool schemas and SDK validation
-  - `fetchTrades`: Reduced limit from 100 → 20 (matches `TRADE_CONSTRAINTS.PAGINATION.MAX_LIMIT`)
-  - `fetchTokensHeld`: Reduced limit from 100 → 20 (matches `USER_CONSTRAINTS.PAGINATION.MAX_LIMIT`)
-  - `fetchTokensCreated`: Reduced limit from 100 → 20 (matches
-    `USER_CONSTRAINTS.PAGINATION.MAX_LIMIT`)
-  - `fetchComments`: Reduced limit from 100 → 50 (matches
-    `COMMENT_CONSTRAINTS.PAGINATION.MAX_LIMIT`)
-  - `fetchPools`: Verified limit 100 is correct (matches `PAGINATION_CONSTRAINTS.MAX_LIMIT`)
-
-### Improved
-
-- **expectedAmount parameter documentation** - Added critical warnings and workflow examples to
-  prevent confusion
-  - Clarified that `expectedAmount` must be `result.amount` from calculate functions, NOT input
-    amount
-  - Added step-by-step workflow examples with actual values
-  - Included common mistake examples with corrections
-- **Type parameter clarity** - Enhanced 'native' vs 'token' documentation with use-case examples
-  - 'native': For GALA amount (most common)
-  - 'token': For exact token amount
-- **Error handling** - AI agents now receive helpful tips for common errors including:
-  - Limit validation errors (with correct constraint values)
-  - Token name/symbol validation errors (with pattern examples)
-  - Wallet address format errors (with conversion examples)
-  - WebSocket timeout errors (with trading workflow guidance)
-  - Type parameter confusion (with usage examples)
-
-### Documentation
-
-- Enhanced inline comments throughout tool schemas linking to SDK constraint sources
-- Added comprehensive API documentation for AI agents
-- Created quick reference cards for common patterns
-- Documented all constraint mappings with source file line numbers
-
-### Developer Experience
-
-- AI agents can now self-diagnose and fix common errors using enhanced error messages
-- Reduced trial-and-error cycles with upfront workflow documentation
-- Improved discoverability with centralized documentation
-- Better maintainability with single source of truth for constraints
-
-## [1.0.4] - 2025-09-18
-
-### Added
-
-- Initial release with 28 MCP tools for Gala Launchpad
-- Support for trading, balance queries, pool management, and token creation
-- Integration with `@gala-chain/launchpad-sdk` v3.1.0
-
----
-
-**Migration Guide v1.0.4 → v1.1.0:**
-
-⚠️ **Breaking Changes:**
-
-- If your code uses `limit` values > 20 for `fetchTrades`, `fetchTokensHeld`, or
-  `fetchTokensCreated`, reduce to ≤ 20
-- If your code uses `limit` values > 50 for `fetchComments`, reduce to ≤ 50
-- These limits now match the SDK's actual validation constraints
-
-✅ **Recommended Actions:**
-
-1. Update any hardcoded `limit` values to respect new constraints
-2. Review trading workflows to ensure `expectedAmount` uses calculated `result.amount`
-3. Consult `docs/AI-AGENT-PATTERNS.md` for updated best practices
-4. Leverage enhanced error messages for faster debugging
-
-📚 **New Documentation:**
-
-- `docs/AI-AGENT-PATTERNS.md` - AI agent guide
-- `docs/CONSTRAINTS-REFERENCE.md` - Constraint mappings
-- `src/utils/constraints.ts` - Constraint constants