@gala-chain/launchpad-mcp-server 1.17.5 → 1.17.7

package/CHANGELOG.md

@@ -1,5 +1,77 @@
 # Changelog
 
+## 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

package/README.md

@@ -4,7 +4,7 @@ MCP (Model Context Protocol) server for Gala Launchpad SDK - Enables AI agents t
 
 ## 🚀 Features
 
-- **55 AI-accessible tools** for complete Gala Launchpad integration (includes 4 price history tools)
+- **57 AI-accessible tools** for complete Gala Launchpad integration (includes 4 price history tools, 3 wallet management tools)
 - **14 slash commands** (prompts) for quick access to common workflows
 - **Type-safe** - Full TypeScript support with validated inputs
 - **Production-ready** - Built on [@gala-chain/launchpad-sdk ](https://www.npmjs.com/package/@gala-chain/launchpad-sdk)
@@ -50,7 +50,7 @@ Add to your `claude_desktop_config.json`:
 ```
 
 **Environment Variables:**
-- `PRIVATE_KEY` (required) - Your Ethereum wallet private key
+- `PRIVATE_KEY` (optional) - Your Ethereum wallet private key (omit for read-only mode)
 - `ENVIRONMENT` (optional) - `development` or `production` (default: development)
 - `DEBUG` (optional) - `true` to enable debug logging
 - `TIMEOUT` (optional) - Request timeout in milliseconds (default: 30000)
@@ -62,9 +62,45 @@ Add to your `claude_desktop_config.json`:
 3. **Restart Claude Desktop**
 4. **Use tools**: Ask Claude to interact with Gala Launchpad!
 
-## 🛠️ Available Tools (54 Total)
+## 🔐 Operational Modes
 
-### Pool Management (15 tools)
+The MCP server supports two operational modes with dynamic wallet configuration:
+
+### Full-Access Mode (with PRIVATE_KEY)
+- Execute token trades (buy/sell)
+- Create new tokens
+- Transfer GALA and tokens
+- Update profile information
+- Post comments on token pools
+- All read operations (fetch pools, prices, balances, etc.)
+
+**Setup:**
+```bash
+claude mcp add "galachain-launchpad" -- env PRIVATE_KEY=0x... ENVIRONMENT=development npx -y @gala-chain/launchpad-mcp-server@latest
+```
+
+### Read-Only Mode (without PRIVATE_KEY)
+- Fetch token pools and details
+- Get real-time prices and price history
+- Check balances and portfolio
+- Browse comments on token pools
+- Explore token metadata and distributions
+- **Cannot:** Execute trades, create tokens, transfer funds (operations requiring wallet signatures)
+
+**Setup:**
+```bash
+claude mcp add "galachain-launchpad-readonly" -- env ENVIRONMENT=development npx -y @gala-chain/launchpad-mcp-server@latest
+```
+
+### Dynamic Wallet Configuration
+Use the wallet management tools to upgrade or switch wallets at runtime:
+- `gala_launchpad_has_wallet` - Check current wallet status
+- `gala_launchpad_set_wallet` - Upgrade from read-only to full-access mode
+- `gala_launchpad_get_wallet` - Retrieve wallet information
+
+## 🛠️ Available Tools (57 Total)
+
+### Pool Management (17 tools)
 - `gala_launchpad_fetch_pools` - Fetch token pools with filtering
 - `gala_launchpad_fetch_all_pools` - Fetch all available pools with automatic pagination
 - `gala_launchpad_fetch_pool_details` - Get detailed pool state
@@ -305,6 +341,11 @@ Ask Claude:
 - `gala_launchpad_fetch_profile` - Get user profile
 - `gala_launchpad_update_profile` - Update profile
 
+### Wallet Management (3 tools)
+- `gala_launchpad_has_wallet` - Check if wallet is configured
+- `gala_launchpad_get_wallet` - Get currently configured wallet instance
+- `gala_launchpad_set_wallet` - Configure wallet for signing operations (upgrade from read-only mode)
+
 ### Token Creation (4 tools)
 - `gala_launchpad_launch_token` - Create new token pool
 - `gala_launchpad_upload_token_image` - Upload token image from filesystem
@@ -319,16 +360,13 @@ Ask Claude:
 - `gala_launchpad_transfer_gala` - Transfer GALA tokens
 - `gala_launchpad_transfer_token` - Transfer launchpad tokens
 
-### Utility Tools (9 tools)
+### Utility Tools (6 tools)
 - `gala_launchpad_create_wallet` - Create new GalaChain wallet
 - `gala_launchpad_get_address` - Get user's GalaChain address
 - `gala_launchpad_get_ethereum_address` - Get user's Ethereum address
 - `gala_launchpad_get_config` - Get current SDK configuration
 - `gala_launchpad_get_url_by_token_name` - Generate frontend URL for a token
-- `gala_launchpad_explain_sdk_usage` - Get SDK code examples and usage explanations
-- `gala_launchpad_is_token_graduated` - Check if token completed bonding curve phase
-- `gala_launchpad_get_cache_info` - Get token metadata cache statistics
-- `gala_launchpad_clear_cache` - Clear token metadata cache entries
+- `gala_launchpad_get_version` - Get SDK and MCP server version information
 
 ## 💡 Example Usage
 

package/dist/generated/version.d.ts

@@ -3,5 +3,5 @@
  * This file is generated by scripts/inject-version.ts during build
  * DO NOT EDIT MANUALLY
  */
-export declare const MCP_SERVER_VERSION = "1.17.5";
+export declare const MCP_SERVER_VERSION = "1.17.7";
 //# sourceMappingURL=version.d.ts.map

package/dist/generated/version.js

@@ -6,5 +6,5 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MCP_SERVER_VERSION = void 0;
-exports.MCP_SERVER_VERSION = '1.17.5';
+exports.MCP_SERVER_VERSION = '1.17.7';
 //# sourceMappingURL=version.js.map

package/dist/server.d.ts

@@ -10,6 +10,13 @@ export declare class LaunchpadMCPServer {
     constructor();
     /**
      * Initialize SDK with AgentConfig
+     *
+     * Supports two operational modes:
+     * 1. Full-access mode (PRIVATE_KEY provided): Uses quickSetup() - all operations available
+     * 2. Read-only mode (PRIVATE_KEY not provided): Uses readOnlySetup() - query operations only
+     *
+     * In read-only mode, signing operations (buy, sell, create tokens, etc.) will throw ValidationError
+     * when attempted, but all query operations (fetchPools, fetchBalance, etc.) work normally.
      */
     initialize(): Promise<void>;
     /**

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,GAAG,CAA6B;IACxC,OAAO,CAAC,KAAK,CAAU;;IAyBvB;;OAEG;IACG,UAAU;IAiChB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmDzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiD3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;IACG,KAAK;IAaX;;OAEG;IACH,OAAO;CAQR"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,GAAG,CAA6B;IACxC,OAAO,CAAC,KAAK,CAAU;;IAyBvB;;;;;;;;;OASG;IACG,UAAU;IA8DhB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmDzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiD3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;IACG,KAAK;IAaX;;OAEG;IACH,OAAO;CAQR"}

package/dist/server.js

@@ -35,29 +35,61 @@ class LaunchpadMCPServer {
     }
     /**
      * Initialize SDK with AgentConfig
+     *
+     * Supports two operational modes:
+     * 1. Full-access mode (PRIVATE_KEY provided): Uses quickSetup() - all operations available
+     * 2. Read-only mode (PRIVATE_KEY not provided): Uses readOnlySetup() - query operations only
+     *
+     * In read-only mode, signing operations (buy, sell, create tokens, etc.) will throw ValidationError
+     * when attempted, but all query operations (fetchPools, fetchBalance, etc.) work normally.
      */
     async initialize() {
         try {
             if (this.debug) {
                 console.error('[MCP Server] Initializing SDK...');
             }
-            const { sdk, validation } = await launchpad_sdk_1.AgentConfig.quickSetup({
-                environment: process.env.ENVIRONMENT || 'development',
-                privateKey: process.env.PRIVATE_KEY,
-                timeout: parseInt(process.env.TIMEOUT || '30000', 10),
-                debug: this.debug,
-                autoValidate: false,
-            });
-            this.sdk = sdk;
-            if (this.debug) {
-                console.error('[MCP Server] SDK initialized successfully');
-                if (validation) {
-                    console.error(`[MCP Server] Validation - Ready: ${validation.ready}`);
-                    console.error(`[MCP Server] Validation - Can Trade: ${validation.capabilities.canTrade}`);
+            const hasPrivateKey = Boolean(process.env.PRIVATE_KEY && process.env.PRIVATE_KEY.trim());
+            const environment = process.env.ENVIRONMENT || 'development';
+            const timeout = parseInt(process.env.TIMEOUT || '30000', 10);
+            if (hasPrivateKey) {
+                // Full-access mode: use quickSetup() to enable signing operations
+                if (this.debug) {
+                    console.error('[MCP Server] PRIVATE_KEY detected - initializing in full-access mode');
+                }
+                const { sdk, validation } = await launchpad_sdk_1.AgentConfig.quickSetup({
+                    environment,
+                    privateKey: process.env.PRIVATE_KEY,
+                    timeout,
+                    debug: this.debug,
+                    autoValidate: false,
+                });
+                this.sdk = sdk;
+                if (this.debug) {
+                    console.error('[MCP Server] SDK initialized successfully (full-access mode)');
+                    if (validation) {
+                        console.error(`[MCP Server] Validation - Ready: ${validation.ready}`);
+                        console.error(`[MCP Server] Validation - Can Trade: ${validation.capabilities.canTrade}`);
+                    }
+                }
+                if (validation && !validation.ready) {
+                    console.error('[MCP Server] Warning: SDK not ready', validation.issues);
                 }
             }
-            if (validation && !validation.ready) {
-                console.error('[MCP Server] Warning: SDK not ready', validation.issues);
+            else {
+                // Read-only mode: use readOnlySetup() for query-only operations
+                if (this.debug) {
+                    console.error('[MCP Server] PRIVATE_KEY not provided - initializing in read-only mode');
+                }
+                const { sdk } = await launchpad_sdk_1.AgentConfig.readOnlySetup({
+                    environment,
+                    timeout,
+                    debug: this.debug,
+                });
+                this.sdk = sdk;
+                if (this.debug) {
+                    console.error('[MCP Server] SDK initialized successfully (read-only mode)');
+                    console.error('[MCP Server] Note: Signing operations will fail - wallet required');
+                }
             }
         }
         catch (error) {
@@ -95,7 +127,7 @@ class LaunchpadMCPServer {
                 throw new Error(`Tool not found: ${toolName}`);
             }
             if (!this.sdk) {
-                throw new Error('SDK not initialized. Please ensure PRIVATE_KEY environment variable is set.');
+                throw new Error('SDK not initialized. Failed during startup - check logs for details.');
             }
             try {
                 const result = await tool.handler(this.sdk, args);

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -7,7 +7,7 @@
  * @see src/utils/tool-registry.ts
  */
 /**
- * Enhanced tool registry with validation (54 tools)
+ * Enhanced tool registry with validation (57 tools)
  */
 export declare const registry: import("../utils/tool-registry.js").ToolRegistry;
 /**

package/dist/tools/index.js

@@ -58,9 +58,9 @@ const toolCategories = [
     },
 ];
 /**
- * Enhanced tool registry with validation (54 tools)
+ * Enhanced tool registry with validation (57 tools)
  */
-exports.registry = (0, tool_registry_js_1.createToolRegistry)(toolCategories, 54);
+exports.registry = (0, tool_registry_js_1.createToolRegistry)(toolCategories, 57);
 /**
  * Complete tool array (for backward compatibility)
  */

package/dist/tools/utils/explainSdkUsage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explainSdkUsage.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA6qClD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAqEjC,CAAC"}
+{"version":3,"file":"explainSdkUsage.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA4zClD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAqEjC,CAAC"}

package/dist/tools/utils/explainSdkUsage.js

@@ -909,6 +909,148 @@ async function analyzeTokenDetails() {
 - Object: \`{ collection, category, type, additionalKey }\`
 
 **MCP Tool Equivalent:** \`gala_launchpad_fetch_token_details\`
+`,
+    'spot-prices-smart-routing': `
+## Smart Spot Price Routing with DEX Fallback
+
+The SDK intelligently routes pricing requests between DEX and Launchpad backends based on token graduation status - no need to know which backend a token uses!
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function tokenPricing() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key'
+  });
+
+  // OPTION 1: SMART ROUTING (Recommended) - Automatic backend selection
+  // Use tokenId for ANY token (graduated or ungraduated)
+  // SDK automatically detects and routes to correct backend
+  console.log('=== Smart Routing (Recommended) ===');
+  const smartPrice = await sdk.fetchTokenSpotPrice({
+    tokenId: 'Token|Unit|ANIME|eth:0x...'  // Works for ANY token!
+  });
+  console.log(\`Token price: $\${smartPrice}\`);
+  // ✅ Handles graduated tokens (DEX) automatically
+  // ✅ Handles ungraduated tokens (Launchpad) automatically
+  // ✅ No need to know token status beforehand
+
+  // OPTION 2: EXPLICIT DEX PRICING - Graduated tokens only
+  // Use tokenId directly for DEX tokens
+  console.log('\\n=== Explicit DEX Pricing ===');
+  const dexPrices = await sdk.fetchTokenSpotPrice({
+    tokenId: 'GALA|Unit|none|none'  // Or other DEX token
+  });
+  console.log(\`DEX Token GALA: $\${dexPrices}\`);
+
+  // OPTION 3: EXPLICIT LAUNCHPAD PRICING - Ungraduated tokens
+  // Use tokenName for launchpad bonding curve tokens
+  console.log('\\n=== Explicit Launchpad Pricing ===');
+  const launchpadPrice = await sdk.fetchLaunchpadTokenSpotPrice('anime');
+  console.log(\`Launchpad token anime: $\${launchpadPrice}\`);
+
+  // ADVANCED: Handle both pricing methods with error recovery
+  console.log('\\n=== Fallback Pricing Strategy ===');
+  async function getPriceWithFallback(tokenId: string, tokenName?: string) {
+    try {
+      // Try DEX pricing first
+      return await sdk.fetchTokenSpotPrice({ tokenId });
+    } catch (error) {
+      // If not on DEX, try launchpad pricing
+      if (tokenName) {
+        try {
+          return await sdk.fetchLaunchpadTokenSpotPrice(tokenName);
+        } catch (fallbackError) {
+          throw new Error(\`Could not fetch price for \${tokenName}\`);
+        }
+      }
+      throw error;
+    }
+  }
+
+  const fallbackPrice = await getPriceWithFallback(
+    'Token|Unit|ANIME|eth:0x...',
+    'anime'
+  );
+  console.log(\`Fallback price: $\${fallbackPrice}\`);
+
+  // USECASE: Price comparison and discovery
+  console.log('\\n=== Price Discovery ===');
+  async function comparePrices(tokenName: string) {
+    const launchpadPrice = await sdk.fetchLaunchpadTokenSpotPrice(tokenName);
+
+    // Check if graduated (on DEX)
+    const isGraduated = await sdk.isTokenGraduated(tokenName);
+
+    if (isGraduated) {
+      const dexPrice = await sdk.fetchTokenSpotPrice({
+        tokenId: \`Token|Unit|\${tokenName.toUpperCase()}|eth:0x...\`
+      });
+      console.log(\`Launchpad: $\${launchpadPrice}, DEX: $\${dexPrice}\`);
+      return { launchpadPrice, dexPrice, graduated: true };
+    } else {
+      console.log(\`Launchpad: $\${launchpadPrice} (not on DEX yet)\`);
+      return { launchpadPrice, graduated: false };
+    }
+  }
+
+  const priceComparison = await comparePrices('anime');
+}
+\`\`\`
+
+**Smart Routing Benefits:**
+- ✅ **Seamless Transitions** - Works before and after token graduation
+- ✅ **No Backend Knowledge** - SDK handles routing automatically
+- ✅ **Error Handling** - Automatic fallback if needed
+- ✅ **Single API** - Use same method for all tokens
+
+**When to Use Each Method:**
+
+| Method | Use Case | Token Status |
+|--------|----------|--------------|
+| \`fetchTokenSpotPrice({ tokenId })\` | Smart routing (recommended) | Any (DEX or Launchpad) |
+| \`fetchLaunchpadTokenSpotPrice(name)\` | Launchpad-only pricing | Ungraduated tokens |
+| \`isTokenGraduated(name)\` | Check token status | Any |
+
+**Key Differences:**
+
+**Ungraduated Tokens (Launchpad):**
+- Priced on exponential bonding curve
+- Token name parameter works: \`fetchLaunchpadTokenSpotPrice('anime')\`
+- Price affected by supply/demand
+
+**Graduated Tokens (DEX):**
+- Priced on DEX via order books
+- Token ID format needed: \`Token|Unit|SYMBOL|eth:0x...\`
+- Market-driven pricing
+
+**Graduation Impact:**
+When a token graduates from launchpad to DEX:
+- Bonding curve closes
+- Trading moves to DEX order books
+- Smart routing automatically switches backends
+- Old launchpad queries will fail (use DEX pricing instead)
+
+**Error Handling:**
+\`\`\`typescript
+async function safePriceQuery(tokenId: string) {
+  try {
+    // Always try smart routing first
+    return await sdk.fetchTokenSpotPrice({ tokenId });
+  } catch (error) {
+    if (error.message.includes('not found')) {
+      console.log('Token not available on DEX');
+      // Could try fallback to launchpad pricing here
+    }
+    throw error;
+  }
+}
+\`\`\`
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_fetch_token_spot_price\` - Smart routing
+- \`gala_launchpad_fetch_launchpad_token_spot_price\` - Launchpad-only
+- \`gala_launchpad_is_token_graduated\` - Check graduation status
 `,
     'profile-management': `
 ## User Profile Management with SDK

package/dist/tools/utils/explainSdkUsage.js.map

@@ -1 +1 @@
-{"version":3,"file":"explainSdkUsage.js","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"explainSdkUsage.js","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":"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"}

package/dist/tools/utils/getWallet.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Get Wallet Tool
+ *
+ * Retrieves the wallet instance currently configured in the SDK.
+ * Returns the wallet object if configured, or null if in read-only mode.
+ */
+export declare const getWalletTool: import("../../types/mcp.js").MCPTool;
+//# sourceMappingURL=getWallet.d.ts.map

package/dist/tools/utils/getWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWallet.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/getWallet.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,aAAa,sCAexB,CAAC"}

package/dist/tools/utils/getWallet.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Get Wallet Tool
+ *
+ * Retrieves the wallet instance currently configured in the SDK.
+ * Returns the wallet object if configured, or null if in read-only mode.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWalletTool = void 0;
+const tool_factory_js_1 = require("../../utils/tool-factory.js");
+exports.getWalletTool = (0, tool_factory_js_1.createNoParamTool)({
+    name: 'gala_launchpad_get_wallet',
+    description: 'Get the wallet instance currently configured in the SDK. Returns wallet object if available, or null if in read-only mode.',
+    handler: (sdk) => {
+        const wallet = sdk.getWallet();
+        // Return wallet metadata if available, or null
+        if (wallet && typeof wallet === 'object' && 'address' in wallet) {
+            return {
+                address: wallet.address,
+                hasPrivateKey: 'privateKey' in wallet && Boolean(wallet.privateKey),
+            };
+        }
+        return null;
+    },
+    resultKey: 'wallet',
+});
+//# sourceMappingURL=getWallet.js.map

package/dist/tools/utils/getWallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWallet.js","sourceRoot":"","sources":["../../../src/tools/utils/getWallet.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iEAAgE;AAEnD,QAAA,aAAa,GAAG,IAAA,mCAAiB,EAAC;IAC7C,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,4HAA4H;IACzI,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;QAC/B,+CAA+C;QAC/C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YAChE,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,aAAa,EAAE,YAAY,IAAI,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;aACpE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,SAAS,EAAE,QAAQ;CACpB,CAAC,CAAC"}

package/dist/tools/utils/hasWallet.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Has Wallet Tool
+ *
+ * Checks if the SDK has a wallet configured for signing operations.
+ * Returns true if wallet is available, false for read-only mode.
+ */
+export declare const hasWalletTool: import("../../types/mcp.js").MCPTool;
+//# sourceMappingURL=hasWallet.d.ts.map

package/dist/tools/utils/hasWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasWallet.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/hasWallet.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,aAAa,sCAKxB,CAAC"}

package/dist/tools/utils/hasWallet.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Has Wallet Tool
+ *
+ * Checks if the SDK has a wallet configured for signing operations.
+ * Returns true if wallet is available, false for read-only mode.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasWalletTool = void 0;
+const tool_factory_js_1 = require("../../utils/tool-factory.js");
+exports.hasWalletTool = (0, tool_factory_js_1.createNoParamTool)({
+    name: 'gala_launchpad_has_wallet',
+    description: 'Check if wallet is configured in the SDK. Returns true if wallet is available for signing operations, false if in read-only mode.',
+    handler: (sdk) => sdk.hasWallet(),
+    resultKey: 'hasWallet',
+});
+//# sourceMappingURL=hasWallet.js.map

package/dist/tools/utils/hasWallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasWallet.js","sourceRoot":"","sources":["../../../src/tools/utils/hasWallet.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iEAAgE;AAEnD,QAAA,aAAa,GAAG,IAAA,mCAAiB,EAAC;IAC7C,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,mIAAmI;IAChJ,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE;IACjC,SAAS,EAAE,WAAW;CACvB,CAAC,CAAC"}

package/dist/tools/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,eAAO,MAAM,YAAY,wCAWxB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,eAAO,MAAM,YAAY,wCAcxB,CAAC"}

package/dist/tools/utils/index.js

@@ -14,6 +14,9 @@ const isTokenGraduated_js_1 = require("./isTokenGraduated.js");
 const getCacheInfo_js_1 = require("./getCacheInfo.js");
 const clearCache_js_1 = require("./clearCache.js");
 const getVersion_js_1 = require("./getVersion.js");
+const hasWallet_js_1 = require("./hasWallet.js");
+const getWallet_js_1 = require("./getWallet.js");
+const setWallet_js_1 = require("./setWallet.js");
 exports.utilityTools = [
     createWallet_js_1.createWalletTool,
     getAddress_js_1.getAddressTool,
@@ -25,5 +28,8 @@ exports.utilityTools = [
     getCacheInfo_js_1.getCacheInfoTool,
     clearCache_js_1.clearCacheTool,
     getVersion_js_1.getVersionTool,
+    hasWallet_js_1.hasWalletTool,
+    getWallet_js_1.getWalletTool,
+    setWallet_js_1.setWalletTool,
 ];
 //# sourceMappingURL=index.js.map

package/dist/tools/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uDAAqD;AACrD,mDAAiD;AACjD,mEAAiE;AACjE,iDAA+C;AAC/C,iEAA+D;AAC/D,6DAA2D;AAC3D,+DAA6D;AAC7D,uDAAqD;AACrD,mDAAiD;AACjD,mDAAiD;AAEpC,QAAA,YAAY,GAAG;IAC1B,kCAAgB;IAChB,8BAAc;IACd,8CAAsB;IACtB,4BAAa;IACb,4CAAqB;IACrB,wCAAmB;IACnB,0CAAoB;IACpB,kCAAgB;IAChB,8BAAc;IACd,8BAAc;CACf,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uDAAqD;AACrD,mDAAiD;AACjD,mEAAiE;AACjE,iDAA+C;AAC/C,iEAA+D;AAC/D,6DAA2D;AAC3D,+DAA6D;AAC7D,uDAAqD;AACrD,mDAAiD;AACjD,mDAAiD;AACjD,iDAA+C;AAC/C,iDAA+C;AAC/C,iDAA+C;AAElC,QAAA,YAAY,GAAG;IAC1B,kCAAgB;IAChB,8BAAc;IACd,8CAAsB;IACtB,4BAAa;IACb,4CAAqB;IACrB,wCAAmB;IACnB,0CAAoB;IACpB,kCAAgB;IAChB,8BAAc;IACd,8BAAc;IACd,4BAAa;IACb,4BAAa;IACb,4BAAa;CACd,CAAC"}

package/dist/tools/utils/setWallet.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Set Wallet Tool
+ *
+ * Configures a wallet for signing operations.
+ * Takes a private key string and sets it as the active wallet in the SDK.
+ */
+export declare const setWalletTool: import("../../types/mcp.js").MCPTool;
+//# sourceMappingURL=setWallet.d.ts.map