@gala-chain/launchpad-mcp-server 1.4.0 → 1.5.0

package/dist/prompts/utils/workflowTemplates.js

@@ -0,0 +1,315 @@
+"use strict";
+/**
+ * Workflow Template Utilities
+ *
+ * Reusable templates for common workflow patterns in prompts.
+ * Reduces duplication and ensures consistency across slash commands.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTradingWorkflow = createTradingWorkflow;
+exports.formatWorkflowSteps = formatWorkflowSteps;
+exports.createConfirmationStep = createConfirmationStep;
+exports.createVerificationStep = createVerificationStep;
+exports.createPerformanceNote = createPerformanceNote;
+exports.createCostBreakdown = createCostBreakdown;
+exports.createBalanceCheckStep = createBalanceCheckStep;
+exports.createAnalysisWorkflow = createAnalysisWorkflow;
+exports.createPortfolioWorkflow = createPortfolioWorkflow;
+const mcpToolNames_js_1 = require("../../constants/mcpToolNames.js");
+/**
+ * Create a complete trading workflow with all standard steps
+ *
+ * @param config - Trading workflow configuration
+ * @returns Formatted workflow text with numbered steps
+ *
+ * @example
+ * ```typescript
+ * const workflow = createTradingWorkflow({
+ *   operation: 'buy',
+ *   tokenName: 'anime',
+ *   amount: '100',
+ *   amountType: 'gala',
+ *   slippage: '1'
+ * });
+ * ```
+ */
+function createTradingWorkflow(config) {
+    const { operation, tokenName, amount, amountType, slippage = '1' } = config;
+    switch (operation) {
+        case 'buy':
+            return createBuyWorkflow(tokenName, amount, amountType, slippage);
+        case 'sell':
+            return createSellWorkflow(tokenName, amount, slippage);
+        case 'graduate':
+            return createGraduationWorkflow(tokenName, slippage);
+        default:
+            throw new Error(`Unknown operation: ${operation}`);
+    }
+}
+/**
+ * Create buy tokens workflow
+ */
+function createBuyWorkflow(tokenName, amount, amountType, slippage) {
+    const slippageFactor = parseFloat(slippage) / 100;
+    const typeParam = amountType === 'gala' ? 'native' : 'exact';
+    const amountLabel = amountType === 'gala' ? 'GALA to spend' : 'Tokens to buy';
+    return `Help me buy tokens on Gala Launchpad:
+
+Token: ${tokenName}
+${amountLabel}: ${amount}
+Slippage tolerance: ${slippage}%
+
+Please follow this workflow:
+
+1. Calculate buy amount using ${mcpToolNames_js_1.MCP_TOOLS.CALCULATE_BUY_AMOUNT}:
+   - tokenName: "${tokenName}"
+   - amount: "${amount}"
+   - type: "${typeParam}" (${amountType === 'gala' ? 'spending GALA' : 'buying exact tokens'})
+
+2. Show me the breakdown:
+   - Tokens I'll receive
+   - Transaction fee
+   - Gas fee
+   - Reverse bonding curve fee
+   - Total cost
+
+3. Ask for confirmation before executing
+
+4. If I confirm, execute the buy using ${mcpToolNames_js_1.MCP_TOOLS.BUY_TOKENS} with:
+   - expectedAmount from calculation
+   - maxAcceptableReverseBondingCurveFee from calculation
+   - slippageToleranceFactor: ${slippageFactor}
+
+5. After purchase, show transaction ID and verify balance`;
+}
+/**
+ * Create sell tokens workflow
+ */
+function createSellWorkflow(tokenName, amount, slippage) {
+    const slippageFactor = parseFloat(slippage) / 100;
+    return `Help me sell tokens on Gala Launchpad:
+
+Token: ${tokenName}
+Tokens to sell: ${amount}
+Slippage tolerance: ${slippage}%
+
+Please follow this workflow:
+
+1. Check my token balance using ${mcpToolNames_js_1.MCP_TOOLS.FETCH_TOKEN_BALANCE}
+
+2. Calculate sell amount using ${mcpToolNames_js_1.MCP_TOOLS.CALCULATE_SELL_AMOUNT}:
+   - tokenName: "${tokenName}"
+   - amount: "${amount}"
+   - type: "exact" (selling exact token amount)
+
+3. Show me the breakdown:
+   - GALA I'll receive
+   - Transaction fee
+   - Gas fee
+   - Reverse bonding curve fee
+   - Net proceeds
+
+4. Ask for confirmation before executing
+
+5. If I confirm, execute the sell using ${mcpToolNames_js_1.MCP_TOOLS.SELL_TOKENS} with:
+   - expectedAmount from calculation
+   - maxAcceptableReverseBondingCurveFee from calculation
+   - slippageToleranceFactor: ${slippageFactor}
+
+6. After sale, show transaction ID and verify updated balance`;
+}
+/**
+ * Create token graduation workflow
+ */
+function createGraduationWorkflow(tokenName, slippage) {
+    const slippageFactor = parseFloat(slippage) / 100;
+    return `Help me graduate the token "${tokenName}" on Gala Launchpad:
+
+Slippage tolerance: ${slippage}%
+
+Please follow this workflow:
+
+1. Check if token is already graduated using ${mcpToolNames_js_1.MCP_TOOLS.FETCH_POOL_DETAILS}
+   - If saleStatus is "Completed", inform me it's already graduated
+
+2. Fetch optimized pool details using ${mcpToolNames_js_1.MCP_TOOLS.FETCH_POOL_DETAILS_FOR_CALCULATION}
+
+3. Calculate graduation cost using ${mcpToolNames_js_1.MCP_TOOLS.CALCULATE_BUY_AMOUNT_FOR_GRADUATION} with:
+   - calculateAmountMode: "local"
+   - currentSupply from pool details
+
+4. Show me the breakdown:
+   - GALA required to graduate: [amount field - this is GALA cost, NOT token quantity!]
+   - Transaction fee
+   - Gas fee
+   - Total cost
+
+5. Check my GALA balance using ${mcpToolNames_js_1.MCP_TOOLS.FETCH_GALA_BALANCE}
+   - Verify I have enough GALA for graduation
+
+6. Ask for confirmation before executing
+
+7. If I confirm, execute graduation using ${mcpToolNames_js_1.MCP_TOOLS.GRADUATE_TOKEN} with:
+   - tokenName: "${tokenName}"
+   - slippageToleranceFactor: ${slippageFactor}
+   - calculateAmountMode: "local"
+   - currentSupply from pool details (optimization!)
+
+8. After graduation:
+   - Show transaction ID
+   - Verify pool status changed to "Completed"
+   - Get frontend URL using ${mcpToolNames_js_1.MCP_TOOLS.GET_URL_BY_TOKEN_NAME}
+
+IMPORTANT: The "amount" field in graduation calculations is GALA cost, not token quantity!`;
+}
+/**
+ * Format a list of steps with numbers
+ *
+ * @param steps - Array of step descriptions
+ * @returns Formatted steps with numbering
+ *
+ * @example
+ * ```typescript
+ * formatWorkflowSteps([
+ *   'Fetch pool details',
+ *   'Calculate price',
+ *   'Show results'
+ * ]);
+ * // Returns:
+ * // "1. Fetch pool details
+ * // 2. Calculate price
+ * // 3. Show results"
+ * ```
+ */
+function formatWorkflowSteps(steps) {
+    return steps.map((step, index) => `${index + 1}. ${step}`).join('\n\n');
+}
+/**
+ * Create a standard confirmation step for destructive operations
+ *
+ * @param operation - Operation name (e.g., 'buy', 'sell', 'graduate')
+ * @returns Confirmation step text
+ */
+function createConfirmationStep(operation) {
+    return `Ask for confirmation before executing the ${operation} operation`;
+}
+/**
+ * Create a standard verification step after transaction
+ *
+ * @param operation - Operation name
+ * @param verifications - Array of verification checks to perform
+ * @returns Verification step text
+ */
+function createVerificationStep(operation, verifications) {
+    const checks = verifications
+        .map((check, index) => `   ${String.fromCharCode(97 + index)}. ${check}`)
+        .join('\n');
+    return `After ${operation} completes:\n${checks}`;
+}
+/**
+ * Create an optimized performance note for LOCAL calculations
+ *
+ * @returns Performance optimization guidance text
+ */
+function createPerformanceNote() {
+    return `Use the performance optimization pattern from SDK v3.9.0 to minimize network calls.`;
+}
+/**
+ * Create a cost breakdown display template
+ *
+ * @param operation - Operation type for context
+ * @returns Cost breakdown template text
+ */
+function createCostBreakdown(operation) {
+    switch (operation) {
+        case 'buy':
+            return `Show me the breakdown:
+   - Tokens I'll receive
+   - Transaction fee
+   - Gas fee
+   - Reverse bonding curve fee
+   - Total cost`;
+        case 'sell':
+            return `Show me the breakdown:
+   - GALA I'll receive
+   - Transaction fee
+   - Gas fee
+   - Reverse bonding curve fee
+   - Net proceeds`;
+        case 'graduate':
+            return `Show me the breakdown:
+   - GALA required to graduate
+   - Transaction fee
+   - Gas fee
+   - Total cost`;
+    }
+}
+/**
+ * Create a balance check step
+ *
+ * @param assetType - Type of asset to check ('GALA' or token name)
+ * @returns Balance check step text
+ */
+function createBalanceCheckStep(assetType) {
+    if (assetType === 'GALA') {
+        return `Check my GALA balance using ${mcpToolNames_js_1.MCP_TOOLS.FETCH_GALA_BALANCE}`;
+    }
+    return `Check my ${assetType} token balance using ${mcpToolNames_js_1.MCP_TOOLS.FETCH_TOKEN_BALANCE}`;
+}
+/**
+ * Create analysis workflow for token evaluation
+ *
+ * @param tokenName - Token to analyze
+ * @returns Complete analysis workflow
+ */
+function createAnalysisWorkflow(tokenName) {
+    return `Analyze the token "${tokenName}" using the Gala Launchpad MCP server:
+
+1. Fetch optimized pool details using ${mcpToolNames_js_1.MCP_TOOLS.FETCH_POOL_DETAILS_FOR_CALCULATION}
+2. Calculate current USD spot price using LOCAL mode with the currentSupply
+3. Calculate graduation cost using LOCAL mode with the currentSupply
+4. Show remaining tokens and pool status (saleStatus)
+5. Calculate pool progress percentage: (currentSupply / maxSupply * 100)
+
+${createPerformanceNote()}
+
+Provide a brief analysis including:
+- Current token price in USD
+- Total GALA required to graduate the pool
+- How close the token is to graduation (percentage)
+- Whether this would be a good time to buy or wait`;
+}
+/**
+ * Create portfolio analysis workflow
+ *
+ * @returns Complete portfolio analysis workflow
+ */
+function createPortfolioWorkflow() {
+    return `Analyze my complete Gala Launchpad portfolio:
+
+1. Get GALA balance using ${mcpToolNames_js_1.MCP_TOOLS.FETCH_GALA_BALANCE}
+
+2. Get all tokens I'm holding using ${mcpToolNames_js_1.MCP_TOOLS.FETCH_TOKENS_HELD}
+   - Use pagination if needed to get all tokens
+
+3. For each token, calculate USD value using optimized pattern:
+   a. Fetch pool details once: ${mcpToolNames_js_1.MCP_TOOLS.FETCH_POOL_DETAILS_FOR_CALCULATION}
+   b. Calculate spot price: ${mcpToolNames_js_1.MCP_TOOLS.FETCH_LAUNCHPAD_TOKEN_SPOT_PRICE} with LOCAL mode
+   c. Multiply token balance by spot price for USD value
+
+4. Calculate GALA USD value using ${mcpToolNames_js_1.MCP_TOOLS.FETCH_GALA_SPOT_PRICE}
+
+5. Present a comprehensive portfolio summary:
+   - GALA balance and USD value
+   - Each token holding with:
+     * Token name
+     * Balance
+     * USD spot price
+     * Total USD value
+   - Total portfolio value in USD
+   - Top 3 holdings by value
+   - Number of different tokens held
+
+${createPerformanceNote()}`;
+}
+//# sourceMappingURL=workflowTemplates.js.map

package/dist/prompts/utils/workflowTemplates.js.map

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

package/dist/server.js

@@ -20,7 +20,7 @@ class LaunchpadMCPServer {
         this.debug = process.env.DEBUG === 'true';
         this.server = new index_js_1.Server({
             name: '@gala-chain/launchpad-mcp-server',
-            version: '1.4.0',
+            version: '1.5.0',
         }, {
             capabilities: {
                 tools: {},

package/dist/utils/__tests__/validation.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Validation Utilities Tests
+ *
+ * Tests for input validation functions
+ */
+export {};
+//# sourceMappingURL=validation.test.d.ts.map

package/dist/utils/__tests__/validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/validation.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/utils/__tests__/validation.test.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * Validation Utilities Tests
+ *
+ * Tests for input validation functions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const validation_1 = require("../validation");
+describe('Validation Utilities', () => {
+    describe('validateTokenName()', () => {
+        it('should accept valid token names', () => {
+            expect(() => (0, validation_1.validateTokenName)('anime')).not.toThrow();
+            expect(() => (0, validation_1.validateTokenName)('test123')).not.toThrow();
+            expect(() => (0, validation_1.validateTokenName)('my-token')).not.toThrow();
+            expect(() => (0, validation_1.validateTokenName)('my_token')).not.toThrow();
+            expect(() => (0, validation_1.validateTokenName)('TEST-123')).not.toThrow();
+        });
+        it('should reject invalid token names', () => {
+            expect(() => (0, validation_1.validateTokenName)('')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateTokenName)('a')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateTokenName)('verylongtokennamethatexceedstwentycharacters')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateTokenName)('token@#$')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateTokenName)('token with spaces')).toThrow(validation_1.ValidationError);
+        });
+    });
+    describe('validateNumericAmount()', () => {
+        it('should accept valid numeric amounts', () => {
+            expect(() => (0, validation_1.validateNumericAmount)('100', 'amount')).not.toThrow();
+            expect(() => (0, validation_1.validateNumericAmount)('0.5', 'amount')).not.toThrow();
+            expect(() => (0, validation_1.validateNumericAmount)('99999.99', 'amount')).not.toThrow();
+            expect(() => (0, validation_1.validateNumericAmount)(100, 'amount')).not.toThrow();
+        });
+        it('should reject invalid numeric amounts', () => {
+            expect(() => (0, validation_1.validateNumericAmount)('', 'amount')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateNumericAmount)('abc', 'amount')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateNumericAmount)('-5', 'amount')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateNumericAmount)('0', 'amount')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateNumericAmount)(Infinity, 'amount')).toThrow(validation_1.ValidationError);
+        });
+    });
+    describe('validateSlippage()', () => {
+        it('should accept valid slippage values', () => {
+            expect(() => (0, validation_1.validateSlippage)('1')).not.toThrow();
+            expect(() => (0, validation_1.validateSlippage)('0.5')).not.toThrow();
+            expect(() => (0, validation_1.validateSlippage)('50')).not.toThrow();
+            expect(() => (0, validation_1.validateSlippage)('0.01')).not.toThrow();
+            expect(() => (0, validation_1.validateSlippage)('100')).not.toThrow();
+        });
+        it('should reject invalid slippage values', () => {
+            expect(() => (0, validation_1.validateSlippage)('0')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateSlippage)('0.005')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateSlippage)('101')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateSlippage)('-1')).toThrow(validation_1.ValidationError);
+        });
+    });
+    describe('validateAddress()', () => {
+        it('should accept valid addresses', () => {
+            expect(() => (0, validation_1.validateAddress)('eth|0x1234567890abcdef1234567890abcdef12345678')).not.toThrow();
+            expect(() => (0, validation_1.validateAddress)('0x1234567890abcdef1234567890abcdef12345678')).not.toThrow();
+            expect(() => (0, validation_1.validateAddress)('0xABCDEF1234567890abcdef1234567890ABCDEF12')).not.toThrow();
+        });
+        it('should reject invalid addresses', () => {
+            expect(() => (0, validation_1.validateAddress)('')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateAddress)('invalid')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateAddress)('0x123')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateAddress)('eth|123')).toThrow(validation_1.ValidationError);
+        });
+    });
+    describe('validateTokenSymbol()', () => {
+        it('should accept valid symbols', () => {
+            expect(() => (0, validation_1.validateTokenSymbol)('GALA')).not.toThrow();
+            expect(() => (0, validation_1.validateTokenSymbol)('TEST')).not.toThrow();
+            expect(() => (0, validation_1.validateTokenSymbol)('A')).not.toThrow();
+            expect(() => (0, validation_1.validateTokenSymbol)('ABCDEFGH')).not.toThrow();
+        });
+        it('should reject invalid symbols', () => {
+            expect(() => (0, validation_1.validateTokenSymbol)('')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateTokenSymbol)('test')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateTokenSymbol)('TOOLONG123')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateTokenSymbol)('TEST123')).toThrow(validation_1.ValidationError);
+        });
+    });
+    describe('validatePaginationLimit()', () => {
+        it('should accept valid limits', () => {
+            expect(() => (0, validation_1.validatePaginationLimit)('1')).not.toThrow();
+            expect(() => (0, validation_1.validatePaginationLimit)('20')).not.toThrow();
+            expect(() => (0, validation_1.validatePaginationLimit)('100')).not.toThrow();
+            expect(() => (0, validation_1.validatePaginationLimit)(50)).not.toThrow();
+        });
+        it('should reject invalid limits', () => {
+            expect(() => (0, validation_1.validatePaginationLimit)('0')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validatePaginationLimit)('101')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validatePaginationLimit)('-1')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validatePaginationLimit)('abc')).toThrow(validation_1.ValidationError);
+        });
+    });
+    describe('validateTokenList()', () => {
+        it('should accept valid token lists', () => {
+            const result1 = (0, validation_1.validateTokenList)('anime,test,dragon');
+            expect(result1).toEqual(['anime', 'test', 'dragon']);
+            const result2 = (0, validation_1.validateTokenList)('token1');
+            expect(result2).toEqual(['token1']);
+        });
+        it('should reject invalid token lists', () => {
+            expect(() => (0, validation_1.validateTokenList)('')).toThrow(validation_1.ValidationError);
+            expect(() => (0, validation_1.validateTokenList)('token1,invalid@#$')).toThrow(validation_1.ValidationError);
+        });
+    });
+    describe('safeValidate()', () => {
+        it('should return success for valid input', () => {
+            const result = (0, validation_1.safeValidate)(() => (0, validation_1.validateTokenName)('anime'));
+            expect(result.success).toBe(true);
+            expect(result.error).toBeUndefined();
+        });
+        it('should return error for invalid input', () => {
+            const result = (0, validation_1.safeValidate)(() => (0, validation_1.validateTokenName)('invalid@#$'));
+            expect(result.success).toBe(false);
+            expect(result.error).toBeDefined();
+        });
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/utils/__tests__/validation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/validation.test.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAEH,8CAUuB;AAEvB,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,8BAAiB,EAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACvD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,8BAAiB,EAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACzD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,8BAAiB,EAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAC1D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,8BAAiB,EAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAC1D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,8BAAiB,EAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,8BAAiB,EAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YAC7D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,8BAAiB,EAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YAC9D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,8BAAiB,EAAC,8CAA8C,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YACzG,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,8BAAiB,EAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YACrE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,8BAAiB,EAAC,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,kCAAqB,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACnE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,kCAAqB,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACnE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,kCAAqB,EAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACxE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,kCAAqB,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,kCAAqB,EAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YAC3E,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,kCAAqB,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YAC9E,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,kCAAqB,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YAC7E,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,kCAAqB,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YAC5E,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,kCAAqB,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;QACnF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,6BAAgB,EAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAClD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,6BAAgB,EAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACpD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACnD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,6BAAgB,EAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,6BAAgB,EAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,6BAAgB,EAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YAC7D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,6BAAgB,EAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YACjE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,6BAAgB,EAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YAC/D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,4BAAe,EAAC,gDAAgD,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAC9F,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,4BAAe,EAAC,4CAA4C,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAC1F,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,4BAAe,EAAC,4CAA4C,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC5F,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,4BAAe,EAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YAC3D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,4BAAe,EAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YAClE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,4BAAe,EAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YAChE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,4BAAe,EAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACrC,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,gCAAmB,EAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACxD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,gCAAmB,EAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACxD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,gCAAmB,EAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,gCAAmB,EAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,gCAAmB,EAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YAC/D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,gCAAmB,EAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YACnE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,gCAAmB,EAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YACzE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,gCAAmB,EAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACzC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,oCAAuB,EAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACzD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,oCAAuB,EAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAC1D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,oCAAuB,EAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAC3D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,oCAAuB,EAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,oCAAuB,EAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YACpE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,oCAAuB,EAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YACtE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,oCAAuB,EAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YACrE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,oCAAuB,EAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,OAAO,GAAG,IAAA,8BAAiB,EAAC,mBAAmB,CAAC,CAAC;YACvD,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;YAErD,MAAM,OAAO,GAAG,IAAA,8BAAiB,EAAC,QAAQ,CAAC,CAAC;YAC5C,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,8BAAiB,EAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;YAC7D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,8BAAiB,EAAC,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAC,4BAAe,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,MAAM,GAAG,IAAA,yBAAY,EAAC,GAAG,EAAE,CAAC,IAAA,8BAAiB,EAAC,OAAO,CAAC,CAAC,CAAC;YAC9D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,MAAM,GAAG,IAAA,yBAAY,EAAC,GAAG,EAAE,CAAC,IAAA,8BAAiB,EAAC,YAAY,CAAC,CAAC,CAAC;YACnE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Validation Utilities for MCP Prompts
+ *
+ * Input validation functions for slash command arguments.
+ * Prevents malformed inputs and provides clear error messages.
+ */
+/**
+ * Validation error class for better error handling
+ */
+export declare class ValidationError extends Error {
+    field: string;
+    constructor(field: string, message: string);
+}
+/**
+ * Validate token name format
+ *
+ * Token names must be 2-20 characters, alphanumeric with hyphens and underscores.
+ *
+ * @param name - Token name to validate
+ * @param fieldName - Field name for error messages (default: 'tokenName')
+ * @throws {ValidationError} If token name is invalid
+ *
+ * @example
+ * ```typescript
+ * validateTokenName('anime'); // ✅ Valid
+ * validateTokenName('test-123'); // ✅ Valid
+ * validateTokenName('my_token'); // ✅ Valid
+ * validateTokenName('a'); // ❌ Throws: too short
+ * validateTokenName('token@#$'); // ❌ Throws: invalid characters
+ * ```
+ */
+export declare function validateTokenName(name: string, fieldName?: string): void;
+/**
+ * Validate numeric amount
+ *
+ * Amounts must be positive numbers (integers or decimals).
+ *
+ * @param amount - Amount to validate (string or number)
+ * @param fieldName - Field name for error messages
+ * @throws {ValidationError} If amount is invalid
+ *
+ * @example
+ * ```typescript
+ * validateNumericAmount('100', 'galaAmount'); // ✅ Valid
+ * validateNumericAmount('99.5', 'tokenAmount'); // ✅ Valid
+ * validateNumericAmount('-5', 'amount'); // ❌ Throws: negative
+ * validateNumericAmount('abc', 'amount'); // ❌ Throws: not a number
+ * ```
+ */
+export declare function validateNumericAmount(amount: string | number, fieldName: string): void;
+/**
+ * Validate slippage tolerance percentage
+ *
+ * Slippage must be between 0.01% and 100%.
+ *
+ * @param slippage - Slippage percentage to validate
+ * @param fieldName - Field name for error messages (default: 'slippage')
+ * @throws {ValidationError} If slippage is invalid
+ *
+ * @example
+ * ```typescript
+ * validateSlippage('1'); // ✅ Valid (1%)
+ * validateSlippage('0.5'); // ✅ Valid (0.5%)
+ * validateSlippage('50'); // ✅ Valid (50%)
+ * validateSlippage('0'); // ❌ Throws: too low
+ * validateSlippage('150'); // ❌ Throws: too high
+ * ```
+ */
+export declare function validateSlippage(slippage: string | number, fieldName?: string): void;
+/**
+ * Validate wallet address format
+ *
+ * Supports both GalaChain format (eth|0x...) and standard Ethereum format (0x...).
+ *
+ * @param address - Wallet address to validate
+ * @param fieldName - Field name for error messages (default: 'address')
+ * @throws {ValidationError} If address is invalid
+ *
+ * @example
+ * ```typescript
+ * validateAddress('eth|0x1234567890abcdef1234567890abcdef12345678'); // ✅ Valid
+ * validateAddress('0x1234567890abcdef1234567890abcdef12345678'); // ✅ Valid
+ * validateAddress('invalid'); // ❌ Throws: invalid format
+ * ```
+ */
+export declare function validateAddress(address: string, fieldName?: string): void;
+/**
+ * Validate token symbol format
+ *
+ * Symbols must be 1-8 uppercase letters.
+ *
+ * @param symbol - Token symbol to validate
+ * @param fieldName - Field name for error messages (default: 'symbol')
+ * @throws {ValidationError} If symbol is invalid
+ *
+ * @example
+ * ```typescript
+ * validateTokenSymbol('GALA'); // ✅ Valid
+ * validateTokenSymbol('TEST'); // ✅ Valid
+ * validateTokenSymbol('test'); // ❌ Throws: must be uppercase
+ * validateTokenSymbol('TOOLONG123'); // ❌ Throws: too long
+ * ```
+ */
+export declare function validateTokenSymbol(symbol: string, fieldName?: string): void;
+/**
+ * Validate pagination limit
+ *
+ * Limits must be positive integers within reasonable range (1-100).
+ *
+ * @param limit - Pagination limit to validate
+ * @param max - Maximum allowed limit (default: 100)
+ * @param fieldName - Field name for error messages (default: 'limit')
+ * @throws {ValidationError} If limit is invalid
+ *
+ * @example
+ * ```typescript
+ * validatePaginationLimit('20'); // ✅ Valid
+ * validatePaginationLimit('1'); // ✅ Valid
+ * validatePaginationLimit('0'); // ❌ Throws: too low
+ * validatePaginationLimit('150'); // ❌ Throws: too high
+ * ```
+ */
+export declare function validatePaginationLimit(limit: string | number, max?: number, fieldName?: string): void;
+/**
+ * Validate comma-separated token list
+ *
+ * For batch operations that accept multiple token names.
+ *
+ * @param tokens - Comma-separated token names
+ * @param fieldName - Field name for error messages (default: 'tokens')
+ * @throws {ValidationError} If token list is invalid
+ *
+ * @example
+ * ```typescript
+ * validateTokenList('anime,test,dragon'); // ✅ Valid
+ * validateTokenList('token1'); // ✅ Valid (single token)
+ * validateTokenList(''); // ❌ Throws: empty list
+ * validateTokenList('token1,invalid@#$'); // ❌ Throws: invalid token name
+ * ```
+ */
+export declare function validateTokenList(tokens: string, fieldName?: string): string[];
+/**
+ * Safe validation wrapper that doesn't throw
+ *
+ * Useful for non-critical validation where you want to continue with a warning.
+ *
+ * @param validationFn - Validation function to execute
+ * @returns Object with success flag and optional error
+ *
+ * @example
+ * ```typescript
+ * const result = safeValidate(() => validateTokenName('anime'));
+ * if (!result.success) {
+ *   console.warn('Validation warning:', result.error);
+ * }
+ * ```
+ */
+export declare function safeValidate(validationFn: () => void): {
+    success: boolean;
+    error?: string;
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAE/B,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAc,GAAG,IAAI,CAmB7E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,SAAS,EAAE,MAAM,GAChB,IAAI,CAqBN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,SAAS,SAAa,GACrB,IAAI,CAoBN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAY,GAAG,IAAI,CAgB5E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAW,GAAG,IAAI,CAmB9E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,GAAG,SAAM,EACT,SAAS,SAAU,GAClB,IAAI,CAoBN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAW,GAAG,MAAM,EAAE,CA2BhF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,IAAI,GACvB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAUtC"}