@gala-chain/launchpad-mcp-server 1.22.4 → 1.23.0

package/src/tools/balance/index.ts

@@ -0,0 +1,174 @@
+/**
+ * Balance & Portfolio Tools
+ */
+
+import type { MCPTool } from '../../types/mcp.js';
+import { formatSuccess, formatBoolean } from '../../utils/response-formatter.js';
+import { withErrorHandling } from '../../utils/error-handler.js';
+import {
+  TOKEN_NAME_SCHEMA,
+  ADDRESS_SCHEMA,
+  PAGE_SCHEMA,
+  createLimitSchema,
+  SEARCH_SCHEMA,
+  FULL_NAME_SCHEMA,
+  PRIVATE_KEY_SCHEMA,
+} from '../../schemas/common-schemas.js';
+import { applyOperationPaginationDefaults } from '../../utils/default-values.js';
+
+// 1. Fetch GALA Balance
+export const fetchGalaBalanceTool: MCPTool = {
+  name: 'gala_launchpad_fetch_gala_balance',
+  description: 'Get GALA balance for a wallet',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      address: {
+        ...ADDRESS_SCHEMA,
+        description: 'Wallet address (optional, defaults to SDK wallet)',
+      },
+    },
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.fetchGalaBalance(args.address);
+    return formatSuccess(result);
+  }),
+};
+
+// 2. Fetch Token Balance (Optimized Single-Token Lookup)
+export const fetchTokenBalanceTool: MCPTool = {
+  name: 'gala_launchpad_fetch_token_balance',
+  description: 'Get token balance for a specific token. Automatically routes to the correct backend: GalaChain for standard tokens (GALA, GUSDC) or launchpad backend for launchpad tokens (anime, etc.).',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      address: ADDRESS_SCHEMA,
+    },
+    required: ['tokenName', 'address'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    // SDK now handles routing: tokenId → GalaChain, tokenName → launchpad backend
+    const result = await sdk.fetchTokenBalance({
+      tokenName: args.tokenName,
+      address: args.address
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 3. Fetch Tokens Held (with Filtering Support)
+export const fetchTokensHeldTool: MCPTool = {
+  name: 'gala_launchpad_fetch_tokens_held',
+  description: 'Get tokens held by a wallet with optional filtering. Supports exact match (tokenName) and fuzzy search (search) for efficient backend filtering.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      address: ADDRESS_SCHEMA,
+      page: PAGE_SCHEMA,
+      limit: createLimitSchema('user', 20),
+      tokenName: {
+        ...TOKEN_NAME_SCHEMA,
+        description: 'Optional token name (exact match filter)',
+      },
+      search: SEARCH_SCHEMA,
+    },
+    required: ['address'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const pagination = applyOperationPaginationDefaults(args, 'user');
+    const result = await sdk.fetchTokensHeld({
+      ...pagination,
+      tokenName: args.tokenName,
+      search: args.search,
+      address: args.address,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 4. Fetch Tokens Created (with Filtering Support)
+export const fetchTokensCreatedTool: MCPTool = {
+  name: 'gala_launchpad_fetch_tokens_created',
+  description: 'Get tokens created by a wallet with optional filtering. Supports exact match (tokenName) and fuzzy search (search) for efficient backend filtering.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      address: ADDRESS_SCHEMA,
+      page: PAGE_SCHEMA,
+      limit: createLimitSchema('user', 20),
+      tokenName: {
+        ...TOKEN_NAME_SCHEMA,
+        description: 'Optional token name (exact match filter)',
+      },
+      search: SEARCH_SCHEMA,
+    },
+    required: ['address'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const pagination = applyOperationPaginationDefaults(args, 'user');
+    const result = await sdk.fetchTokensCreated({
+      ...pagination,
+      tokenName: args.tokenName,
+      search: args.search,
+      address: args.address,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 5. Fetch Profile
+export const fetchProfileTool: MCPTool = {
+  name: 'gala_launchpad_fetch_profile',
+  description: 'Get user profile data',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      address: {
+        ...ADDRESS_SCHEMA,
+        description: 'Wallet address (optional, defaults to SDK wallet)',
+      },
+    },
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.fetchProfile(args.address);
+    return formatSuccess(result);
+  }),
+};
+
+// 6. Update Profile
+export const updateProfileTool: MCPTool = {
+  name: 'gala_launchpad_update_profile',
+  description: 'Update user profile',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      fullName: FULL_NAME_SCHEMA,
+      profileImage: {
+        type: 'string',
+        description: 'Profile image URL or empty string',
+      },
+      address: ADDRESS_SCHEMA,
+      privateKey: PRIVATE_KEY_SCHEMA,
+    },
+    required: ['fullName', 'profileImage', 'address'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    await sdk.updateProfile({
+      fullName: args.fullName,
+      profileImage: args.profileImage,
+      address: args.address,
+      privateKey: args.privateKey,
+    });
+    return formatBoolean(true, 'Profile updated successfully');
+  }),
+};
+
+export const balanceTools: MCPTool[] = [
+  fetchGalaBalanceTool,
+  fetchTokenBalanceTool,
+  fetchTokensHeldTool,
+  fetchTokensCreatedTool,
+  fetchProfileTool,
+  updateProfileTool,
+];

package/src/tools/creation/index.ts

@@ -0,0 +1,182 @@
+/**
+ * Token Creation Tools
+ */
+
+import type { MCPTool } from '../../types/mcp.js';
+import { formatSuccess } from '../../utils/response-formatter.js';
+import { withErrorHandling } from '../../utils/error-handler.js';
+import { createNoParamTool } from '../../utils/tool-factory.js';
+import {
+  TOKEN_NAME_SCHEMA,
+  TOKEN_SYMBOL_SCHEMA,
+  TOKEN_DESCRIPTION_SCHEMA,
+  PRE_BUY_QUANTITY_SCHEMA,
+  URL_SCHEMA,
+  PRIVATE_KEY_SCHEMA,
+  ADDRESS_SCHEMA,
+} from '../../schemas/common-schemas.js';
+
+// 1. Launch Token
+export const launchTokenTool: MCPTool = {
+  name: 'gala_launchpad_launch_token',
+  description: `Create a new token on the launchpad.
+
+WORKFLOW:
+1. checkTokenName() → Verify name is available
+2. checkTokenSymbol() → Verify symbol is available
+3. launchToken() → Create token with validated name/symbol
+4. getUrlByTokenName() → Get frontend URL for the new token
+
+REQUIREMENT: At least one social URL (websiteUrl, twitterUrl, or telegramUrl) is required.
+
+RETURNS: Transaction details including token name, symbol, creator address, and transaction ID`,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      tokenSymbol: TOKEN_SYMBOL_SCHEMA,
+      tokenDescription: TOKEN_DESCRIPTION_SCHEMA,
+      tokenImage: {
+        ...URL_SCHEMA,
+        description: 'Token image URL',
+      },
+      preBuyQuantity: PRE_BUY_QUANTITY_SCHEMA,
+      websiteUrl: {
+        ...URL_SCHEMA,
+        description: 'Website URL (optional)',
+      },
+      telegramUrl: {
+        ...URL_SCHEMA,
+        description: 'Telegram channel URL (optional)',
+      },
+      twitterUrl: {
+        ...URL_SCHEMA,
+        description: 'Twitter profile URL (optional)',
+      },
+      tokenCategory: {
+        type: 'string',
+        description: 'Token category (defaults to "Unit")',
+      },
+      tokenCollection: {
+        type: 'string',
+        description: 'Token collection (defaults to "Token")',
+      },
+      reverseBondingCurveConfiguration: {
+        type: 'object',
+        properties: {
+          minFeePortion: {
+            type: 'string',
+            description: 'Minimum fee portion',
+          },
+          maxFeePortion: {
+            type: 'string',
+            description: 'Maximum fee portion',
+          },
+        },
+        description: 'Reverse bonding curve configuration (optional, uses defaults)',
+      },
+      privateKey: PRIVATE_KEY_SCHEMA,
+    },
+    required: [
+      'tokenName',
+      'tokenSymbol',
+      'tokenDescription',
+      'tokenImage',
+    ],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.launchToken(args);
+    return formatSuccess(result);
+  }),
+};
+
+// 2. Upload Token Image
+export const uploadTokenImageTool: MCPTool = {
+  name: 'gala_launchpad_upload_token_image',
+  description: 'Upload token image from filesystem (Node.js only)',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: {
+        ...TOKEN_NAME_SCHEMA,
+        description: 'Token name (2-20 lowercase alphanumeric)',
+      },
+      imagePath: {
+        type: 'string',
+        description: 'Absolute file path to image file',
+      },
+      privateKey: PRIVATE_KEY_SCHEMA,
+    },
+    required: ['tokenName', 'imagePath'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const fs = await import('fs/promises');
+    const fileBuffer = await fs.readFile(args.imagePath);
+
+    const result = await sdk.uploadTokenImage({
+      tokenName: args.tokenName,
+      options: {
+        file: fileBuffer,
+        tokenName: args.tokenName,
+      },
+      privateKey: args.privateKey,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 3. Upload Profile Image
+export const uploadProfileImageTool: MCPTool = {
+  name: 'gala_launchpad_upload_profile_image',
+  description: 'Upload profile image from filesystem (Node.js only)',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      imagePath: {
+        type: 'string',
+        description: 'Absolute file path to image file',
+      },
+      address: {
+        ...ADDRESS_SCHEMA,
+        description: 'Optional wallet address (defaults to authenticated user)',
+      },
+      privateKey: PRIVATE_KEY_SCHEMA,
+    },
+    required: ['imagePath'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const fs = await import('fs/promises');
+    const fileBuffer = await fs.readFile(args.imagePath);
+
+    const imageUrl = await sdk.uploadProfileImage({
+      file: fileBuffer,
+      address: args.address,
+      privateKey: args.privateKey,
+    });
+
+    // If no imageUrl returned but upload succeeded, provide helpful message
+    if (!imageUrl) {
+      return formatSuccess({
+        success: true,
+        message: 'Profile image uploaded successfully (image stored with wallet address)',
+      });
+    }
+
+    return formatSuccess({ success: true, imageUrl });
+  }),
+};
+
+// 4. Fetch Launch Token Fee (45% code reduction via factory pattern)
+export const fetchLaunchTokenFeeTool = createNoParamTool({
+  name: 'gala_launchpad_fetch_launch_token_fee',
+  description: 'Fetch the current GALA fee required to launch a new token on the launchpad. Returns a number (e.g., 0.001). This is a dynamic value that may change. Check this before launching a token to ensure sufficient balance.',
+  handler: (sdk) => sdk.fetchLaunchTokenFee(),
+  resultKey: 'feeAmount',
+});
+
+export const creationTools: MCPTool[] = [
+  launchTokenTool,
+  uploadTokenImageTool,
+  uploadProfileImageTool,
+  fetchLaunchTokenFeeTool,
+];

package/src/tools/dex/index.ts

@@ -0,0 +1,226 @@
+/**
+ * DEX/GalaSwap Trading Operations Tools
+ *
+ * Tools for trading on GalaSwap DEX after tokens graduate from bonding curves.
+ * These tools provide quote generation, swap execution, liquidity management, and asset management.
+ */
+
+import type { MCPTool } from '../../types/mcp.js';
+import { liquidityPositionTools } from './liquidity-positions.js';
+import { formatSuccess } from '../../utils/response-formatter.js';
+import { withErrorHandling } from '../../utils/error-handler.js';
+import {
+  DECIMAL_AMOUNT_SCHEMA,
+  ADDRESS_SCHEMA,
+} from '../../schemas/common-schemas.js';
+
+// Token symbol for DEX trading
+const TOKEN_SYMBOL_SCHEMA = {
+  type: 'string',
+  minLength: 1,
+  maxLength: 20,
+  description: 'Token symbol (e.g., "GALA", "GUSDC")',
+};
+
+// Fee tier for GalaSwap (in basis points)
+const FEE_TIER_SCHEMA = {
+  type: 'number',
+  enum: [500, 3000, 10000],
+  description: 'Fee tier in basis points: 500 (0.05%), 3000 (0.30%), 10000 (1.00%)',
+};
+
+// Slippage tolerance
+const SLIPPAGE_TOLERANCE_SCHEMA = {
+  type: 'number',
+  minimum: 0,
+  maximum: 1,
+  description: 'Slippage tolerance as decimal (e.g., 0.01 for 1%)',
+};
+
+// 1. Get Swap Quote (Exact Input)
+export const getSwapQuoteExactInputTool: MCPTool = {
+  name: 'gala_launchpad_get_swap_quote_exact_input',
+  description:
+    'Get swap quote for exact input amount - specify how much you want to spend',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      fromToken: TOKEN_SYMBOL_SCHEMA,
+      toToken: TOKEN_SYMBOL_SCHEMA,
+      amount: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'Amount of source token to spend',
+      },
+    },
+    required: ['fromToken', 'toToken', 'amount'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const quote = await sdk.getSwapQuoteExactInput(args.fromToken, args.toToken, args.amount);
+    return formatSuccess({
+      fromToken: quote.fromToken,
+      toToken: quote.toToken,
+      inputAmount: quote.inputAmount,
+      estimatedOutput: quote.estimatedOutput,
+      feeTier: quote.feeTier,
+      priceImpact: quote.priceImpact,
+      executionPrice: quote.executionPrice,
+      message: `Spending ${quote.inputAmount} ${quote.fromToken}, receiving ~${quote.estimatedOutput} ${quote.toToken}`,
+    });
+  }),
+};
+
+// 2. Get Swap Quote (Exact Output)
+export const getSwapQuoteExactOutputTool: MCPTool = {
+  name: 'gala_launchpad_get_swap_quote_exact_output',
+  description:
+    'Get swap quote for exact output amount - specify how much you want to receive',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      fromToken: TOKEN_SYMBOL_SCHEMA,
+      toToken: TOKEN_SYMBOL_SCHEMA,
+      amount: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'Desired amount of destination token to receive',
+      },
+    },
+    required: ['fromToken', 'toToken', 'amount'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const quote = await sdk.getSwapQuoteExactOutput(args.fromToken, args.toToken, args.amount);
+    return formatSuccess({
+      fromToken: quote.fromToken,
+      toToken: quote.toToken,
+      inputAmount: quote.inputAmount,
+      estimatedOutput: quote.estimatedOutput,
+      feeTier: quote.feeTier,
+      priceImpact: quote.priceImpact,
+      executionPrice: quote.executionPrice,
+      message: `Spending ~${quote.inputAmount} ${quote.fromToken}, receiving ${quote.estimatedOutput} ${quote.toToken}`,
+    });
+  }),
+};
+
+// 3. Execute Swap
+export const executeSwapTool: MCPTool = {
+  name: 'gala_launchpad_execute_swap',
+  description:
+    'Execute a token swap on GalaSwap DEX with slippage protection. Get a quote first using getSwapQuote tools.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      fromToken: TOKEN_SYMBOL_SCHEMA,
+      toToken: TOKEN_SYMBOL_SCHEMA,
+      inputAmount: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'Amount of source token to spend',
+      },
+      estimatedOutput: {
+        ...DECIMAL_AMOUNT_SCHEMA,
+        description: 'Expected output amount from quote (for slippage calculation)',
+      },
+      feeTier: FEE_TIER_SCHEMA,
+      slippageTolerance: {
+        ...SLIPPAGE_TOLERANCE_SCHEMA,
+        default: 0.01,
+      },
+    },
+    required: ['fromToken', 'toToken', 'inputAmount', 'estimatedOutput', 'feeTier'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    // Validate wallet before execution by trying to get address
+    try {
+      sdk.getAddress();
+    } catch {
+      throw new Error('Wallet not configured - required for swap execution');
+    }
+
+    const result = await sdk.executeSwap(
+      args.fromToken,
+      args.toToken,
+      args.inputAmount,
+      args.estimatedOutput,
+      args.feeTier,
+      args.slippageTolerance || 0.01
+    );
+
+    return formatSuccess({
+      transactionId: result.transactionId,
+      status: result.status,
+      fromToken: result.fromToken,
+      toToken: result.toToken,
+      inputAmount: result.inputAmount,
+      outputAmount: result.outputAmount,
+      feeTier: result.feeTier,
+      slippageTolerance: result.slippageTolerance,
+      timestamp: result.timestamp.toISOString(),
+      message: `Swap completed! Sent ${result.inputAmount} ${result.fromToken}, received ${result.outputAmount} ${result.toToken}`,
+    });
+  }),
+};
+
+// 4. Get User Assets
+export const getSwapUserAssetsTool: MCPTool = {
+  name: 'gala_launchpad_get_swap_user_assets',
+  description: 'Get all token assets and balances for a wallet address',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      walletAddress: {
+        ...ADDRESS_SCHEMA,
+        description: 'Wallet address to query (e.g., "0x1234..." or "eth|1234...")',
+      },
+    },
+    required: ['walletAddress'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const assets = await sdk.getSwapUserAssets(args.walletAddress);
+    return formatSuccess({
+      walletAddress: args.walletAddress,
+      assetCount: assets.length,
+      assets: assets.map((asset) => ({
+        symbol: asset.symbol,
+        balance: asset.balance,
+        decimals: asset.decimals,
+      })),
+      message: `${assets.length} assets found for wallet ${args.walletAddress}`,
+    });
+  }),
+};
+
+// 5. Get Pool Info
+export const getSwapPoolInfoTool: MCPTool = {
+  name: 'gala_launchpad_get_swap_pool_info',
+  description:
+    'Get liquidity and fee tier information for a token pair on GalaSwap DEX',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenA: TOKEN_SYMBOL_SCHEMA,
+      tokenB: TOKEN_SYMBOL_SCHEMA,
+    },
+    required: ['tokenA', 'tokenB'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const poolInfo = await sdk.getSwapPoolInfo(args.tokenA, args.tokenB);
+    return formatSuccess({
+      tokenA: poolInfo.tokenA,
+      tokenB: poolInfo.tokenB,
+      liquidity: poolInfo.liquidity,
+      feeTiers: poolInfo.feeTiers,
+      feeTiersFormatted: poolInfo.feeTiers.map((tier) => `${tier / 100}%`),
+      swapCount: poolInfo.swapCount,
+      message: `Pool ${args.tokenA}/${args.tokenB} has ${poolInfo.liquidity} liquidity with ${poolInfo.feeTiers.length} fee tiers`,
+    });
+  }),
+};
+
+// Export all DEX tools (5 swap tools + 8 liquidity position tools = 13 tools)
+export const dexTools: MCPTool[] = [
+  getSwapQuoteExactInputTool,
+  getSwapQuoteExactOutputTool,
+  executeSwapTool,
+  getSwapUserAssetsTool,
+  getSwapPoolInfoTool,
+  ...liquidityPositionTools,
+];