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

package/dist/schemas/common-schemas.js

@@ -10,8 +10,11 @@
  * @see https://modelcontextprotocol.io/docs/concepts/tools
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FLEXIBLE_TOKEN_ID_SCHEMA = exports.TOKEN_CLASS_KEY_SCHEMA = exports.CURRENT_SUPPLY_SCHEMA = exports.CALCULATION_MODE_SCHEMA = exports.SORT_ORDER_SCHEMA = exports.RBC_FEE_SLIPPAGE_SCHEMA = exports.SLIPPAGE_TOLERANCE_SCHEMA = exports.PAGE_SCHEMA = exports.DATE_TIME_SCHEMA = exports.UNIQUE_KEY_SCHEMA = exports.TRANSACTION_ID_SCHEMA = exports.SEARCH_SCHEMA = exports.FULL_NAME_SCHEMA = exports.URL_SCHEMA = exports.INTEGER_AMOUNT_SCHEMA = exports.PRE_BUY_QUANTITY_SCHEMA = exports.DECIMAL_AMOUNT_SCHEMA = exports.ADDRESS_SCHEMA = exports.PRIVATE_KEY_SCHEMA = exports.TOKEN_DESCRIPTION_SCHEMA = exports.TOKEN_SYMBOL_SCHEMA = exports.TOKEN_NAME_SCHEMA = void 0;
+exports.TOKEN_PAIR_WITH_TICKS_SCHEMA = exports.TOKEN_PAIR_SCHEMA = exports.DEX_TOKEN_CLASS_KEY_SCHEMA = exports.REACTION_INPUT_SCHEMA = exports.REACTION_TYPE_SCHEMA = exports.CHAT_CONTENT_SCHEMA = exports.MESSAGE_ID_SCHEMA = exports.POOL_DISCOVERY_SCHEMA = exports.POOL_DISCOVERY_SORT_ORDER_SCHEMA = exports.POOL_DISCOVERY_SORT_BY_SCHEMA = exports.POOL_DISCOVERY_SEARCH_SCHEMA = exports.ACTIVE_USER_TYPE_SCHEMA = exports.BAN_DURATION_SCHEMA = exports.BAN_REASON_SCHEMA = exports.INVITE_SCOPE_SCHEMA = exports.INVITE_STATUS_SCHEMA = exports.INVITE_CODE_SCHEMA = exports.API_KEY_ROLE_SCHEMA = exports.MODERATOR_ROLE_SCHEMA = exports.EXPIRES_AT_SCHEMA = exports.ENTITY_DESCRIPTION_SCHEMA = exports.ENTITY_ID_SCHEMA = exports.FEE_TIER_SCHEMA = exports.DEX_TOKEN_SYMBOL_SCHEMA = exports.FLEXIBLE_TOKEN_ID_SCHEMA = exports.TOKEN_CLASS_KEY_SCHEMA = exports.CURRENT_SUPPLY_SCHEMA = exports.CALCULATION_MODE_SCHEMA = exports.SORT_ORDER_SCHEMA = exports.RBC_FEE_SLIPPAGE_SCHEMA = exports.SLIPPAGE_TOLERANCE_SCHEMA = exports.USER_PORTFOLIO_QUERY_SCHEMA = exports.PAGE_SCHEMA = exports.DATE_TIME_SCHEMA = exports.UNIQUE_KEY_SCHEMA = exports.TRANSACTION_ID_SCHEMA = exports.SEARCH_SCHEMA = exports.FULL_NAME_SCHEMA = exports.URL_SCHEMA = exports.INTEGER_AMOUNT_SCHEMA = exports.PRE_BUY_QUANTITY_SCHEMA = exports.DECIMAL_AMOUNT_SCHEMA = exports.OWNER_ADDRESS_SCHEMA = exports.RECIPIENT_ADDRESS_SCHEMA = exports.OPTIONAL_ADDRESS_SCHEMA = exports.ADDRESS_SCHEMA = exports.PRIVATE_KEY_SCHEMA = exports.TOKEN_DESCRIPTION_SCHEMA = exports.TOKEN_SYMBOL_SCHEMA = exports.TOKEN_NAME_SCHEMA = void 0;
+exports.EMPTY_INPUT_SCHEMA = exports.RTMP_URL_SCHEMA = exports.ADMIN_LIMIT_SCHEMA = exports.WRAP_UNWRAP_PROPERTIES = exports.BATCH_OPERATION_BASE_PROPERTIES = exports.BATCH_TOKEN_UNLOCK_EXTRA_PROPERTIES = exports.BATCH_TOKEN_LOCK_EXTRA_PROPERTIES = exports.BATCH_TOKEN_ITEM_PROPERTIES = exports.FLAG_ACTION_SCHEMA = exports.FLAG_STATUS_SCHEMA = exports.FLAG_REASON_SCHEMA = exports.CONTENT_TYPE_SCHEMA = exports.EXTERNAL_NETWORK_SCHEMA = exports.LIQUIDITY_AMOUNTS_SCHEMA = exports.DEX_POOL_QUOTE_INPUT_SCHEMA = exports.SWAP_QUOTE_INPUT_SCHEMA = void 0;
 exports.createLimitSchema = createLimitSchema;
+exports.createPoolDiscoverySchema = createPoolDiscoverySchema;
+exports.createBatchTokenArraySchema = createBatchTokenArraySchema;
 const zod_to_json_schema_1 = require("zod-to-json-schema");
 const launchpad_sdk_1 = require("@gala-chain/launchpad-sdk");
 const constraints_js_1 = require("../utils/constraints.js");
@@ -98,6 +101,31 @@ exports.PRIVATE_KEY_SCHEMA = toMCPSchema(launchpad_sdk_1.privateKeySchema, 'Opti
  * @example "eth|1234567890abcdef1234567890abcdef12345678"
  */
 exports.ADDRESS_SCHEMA = toMCPSchema(launchpad_sdk_1.flexibleAddressSchema, 'Wallet address');
+/**
+ * Optional wallet address schema - for queries without a required wallet parameter
+ *
+ * @description Optional wallet address (defaults to SDK wallet if not provided)
+ * @example "0x1234567890abcdef1234567890abcdef12345678"
+ * @example "eth|1234567890abcdef1234567890abcdef12345678"
+ * @note If not provided, uses the MCP server's default wallet
+ */
+exports.OPTIONAL_ADDRESS_SCHEMA = toMCPSchema(launchpad_sdk_1.flexibleAddressSchema, 'Wallet address (optional, defaults to SDK wallet)');
+/**
+ * Recipient wallet address schema - for transfer operations
+ *
+ * @description Recipient wallet address for token transfers
+ * @example "0x1234567890abcdef1234567890abcdef12345678"
+ * @example "eth|1234567890abcdef1234567890abcdef12345678"
+ */
+exports.RECIPIENT_ADDRESS_SCHEMA = toMCPSchema(launchpad_sdk_1.flexibleAddressSchema, 'Recipient wallet address');
+/**
+ * Wallet address for position owner lookups
+ *
+ * @description Wallet address to query liquidity positions, holdings, or portfolio for
+ * @example "0x1234567890abcdef1234567890abcdef12345678"
+ * @example "eth|1234567890abcdef1234567890abcdef12345678"
+ */
+exports.OWNER_ADDRESS_SCHEMA = toMCPSchema(launchpad_sdk_1.flexibleAddressSchema, 'Wallet address that owns the position');
 // =============================================================================
 // Amount Schemas (from SDK)
 // =============================================================================
@@ -229,6 +257,42 @@ function createLimitSchema(operationType, defaultLimit = 20) {
     return jsonSchemaLimit;
 }
 // =============================================================================
+// User Portfolio Query Schema (composite)
+// =============================================================================
+/**
+ * User portfolio query input schema properties
+ *
+ * Composite schema for tools that query user holdings with:
+ * - Required address parameter
+ * - Optional tokenName exact filter
+ * - Optional search fuzzy filter
+ * - Standard pagination (page/limit)
+ *
+ * Used by: fetchTokensHeld, fetchTokensCreated
+ *
+ * @description Pre-built properties object for user portfolio query schemas
+ * @usage Spread into tool inputSchema properties: { ...USER_PORTFOLIO_QUERY_SCHEMA }
+ *
+ * @example
+ * ```typescript
+ * inputSchema: {
+ *   type: 'object',
+ *   properties: USER_PORTFOLIO_QUERY_SCHEMA,
+ *   required: ['address'],
+ * }
+ * ```
+ */
+exports.USER_PORTFOLIO_QUERY_SCHEMA = {
+    address: exports.ADDRESS_SCHEMA,
+    page: exports.PAGE_SCHEMA,
+    limit: createLimitSchema('user', 20),
+    tokenName: {
+        ...exports.TOKEN_NAME_SCHEMA,
+        description: 'Optional token name (exact match filter)',
+    },
+    search: exports.SEARCH_SCHEMA,
+};
+// =============================================================================
 // Trading Schemas (manual - not in SDK primitives)
 // =============================================================================
 /**
@@ -377,4 +441,792 @@ exports.FLEXIBLE_TOKEN_ID_SCHEMA = {
         },
     ],
 };
+// =============================================================================
+// DEX Trading Schemas
+// =============================================================================
+//
+// Migration Guide for Schema Consumers:
+// - Import DEX_TOKEN_SYMBOL_SCHEMA and FEE_TIER_SCHEMA directly from common-schemas.ts
+// - Avoid creating local aliases unless needed for legacy compatibility
+// - Remove local aliases in future cleanup PRs
+/**
+ * DEX token symbol schema - for pipe-delimited token identification in DEX trading
+ *
+ * @description Used in DEX swap, liquidity, and pool operations for EXISTING tokens.
+ *              This schema is for READING/TRADING tokens, not creating them.
+ * @format Pipe-delimited: "collection|category|type|additionalKey"
+ * @example "GALA|Unit|none|none", "Token|Unit|BENE|client:xxx"
+ * @note NOT for token creation - use TOKEN_SYMBOL_SCHEMA for creating new tokens
+ * @see TOKEN_SYMBOL_SCHEMA for token creation operations
+ */
+exports.DEX_TOKEN_SYMBOL_SCHEMA = {
+    type: 'string',
+    minLength: 1,
+    maxLength: 100,
+    description: 'Token identifier in pipe-delimited format (e.g., "GALA|Unit|none|none", "Token|Unit|BENE|client:xxx")',
+};
+/**
+ * Fee tier schema - for GalaSwap DEX operations
+ *
+ * @description Represents the fee tier in basis points
+ * @type number
+ * @enum [500, 3000, 10000]
+ * @example 500 (0.05%), 3000 (0.30%), 10000 (1.00%)
+ * @note Standard Uniswap V3-style fee tiers
+ * @throws {ValidationError} If value not in enum (500, 3000, 10000)
+ */
+exports.FEE_TIER_SCHEMA = {
+    type: 'number',
+    enum: [500, 3000, 10000],
+    description: 'Fee tier in basis points: 500 (0.05%), 3000 (0.30%), 10000 (1.00%)',
+};
+// =============================================================================
+// Domain-Specific Schemas (Bans, Moderators, API Keys)
+// =============================================================================
+/**
+ * Generic positive integer ID schema - for invite IDs, API key IDs, etc.
+ *
+ * @description Reusable ID schema for database entities
+ * @type number
+ * @minimum 1
+ * @example 1, 42, 999
+ */
+exports.ENTITY_ID_SCHEMA = {
+    type: 'number',
+    minimum: 1,
+    description: 'Entity ID (positive integer)',
+};
+/**
+ * Generic description schema - for invites, API keys, etc.
+ *
+ * @description Reusable description field with 255 character limit
+ * @type string
+ * @maxLength 255
+ * @example "John - Friday shows", "Production API key"
+ */
+exports.ENTITY_DESCRIPTION_SCHEMA = {
+    type: 'string',
+    maxLength: 255,
+    description: 'Optional description/label (max 255 characters)',
+};
+/**
+ * Generic expiration schema - for invites, API keys, bans, etc.
+ *
+ * @description ISO 8601 date-time for expiration
+ * @type string
+ * @example "2025-12-31T23:59:59Z"
+ */
+exports.EXPIRES_AT_SCHEMA = {
+    type: 'string',
+    description: 'Optional expiration date in ISO 8601 format (e.g., "2025-12-31T23:59:59Z"). If not provided, never expires.',
+};
+/**
+ * Moderator/API key role schema - shared base for role definitions
+ *
+ * @description Role enum used by moderator invites and API keys
+ * @type string
+ * @enum ['MODERATOR', 'TECHNICAL_PRODUCER', 'MANAGER']
+ * @note API keys also have 'OWNER' role; moderator invites do not
+ */
+exports.MODERATOR_ROLE_SCHEMA = {
+    type: 'string',
+    enum: ['MODERATOR', 'TECHNICAL_PRODUCER', 'MANAGER'],
+    description: `Role to grant:
+- MODERATOR: Manage comments, chat messages, ban/unban users
+- TECHNICAL_PRODUCER: Simulcast targets, stream key, stop/start stream
+- MANAGER: All of the above + recordings + stream settings`,
+};
+/**
+ * API key role schema - extends moderator roles with OWNER
+ *
+ * @description Role enum for API keys (includes OWNER)
+ * @type string
+ * @enum ['MODERATOR', 'TECHNICAL_PRODUCER', 'MANAGER', 'OWNER']
+ */
+exports.API_KEY_ROLE_SCHEMA = {
+    type: 'string',
+    enum: ['MODERATOR', 'TECHNICAL_PRODUCER', 'MANAGER', 'OWNER'],
+    description: `API key role determining permissions:
+- MODERATOR: Manage comments, chat messages, ban/unban users
+- TECHNICAL_PRODUCER: Simulcast targets, stream key, stop/start stream
+- MANAGER: Moderator + Technical Producer + recordings + stream settings
+- OWNER: Full access (indistinguishable from normal auth)`,
+};
+/**
+ * Invite code schema - for moderator invite magic links
+ *
+ * @description 64-character hex code from invite URL
+ * @type string
+ * @pattern ^[a-fA-F0-9]{64}$
+ * @example "abc123..." (64 hex characters)
+ */
+exports.INVITE_CODE_SCHEMA = {
+    type: 'string',
+    pattern: '^[a-fA-F0-9]{64}$',
+    description: 'The 64-character hex invite code from the magic link URL',
+};
+/**
+ * Invite status schema - for filtering moderator invites
+ *
+ * @description Status enum for invite filtering
+ * @type string
+ * @enum ['PENDING', 'CLAIMED', 'REVOKED', 'EXPIRED']
+ */
+exports.INVITE_STATUS_SCHEMA = {
+    type: 'string',
+    enum: ['PENDING', 'CLAIMED', 'REVOKED', 'EXPIRED'],
+    description: `Filter invites by status:
+- PENDING: Not yet claimed
+- CLAIMED: Claimed by a moderator
+- REVOKED: Revoked by the owner
+- EXPIRED: Past expiration date`,
+};
+/**
+ * Invite scope schema - for moderator invite scope selection
+ *
+ * @description Scope enum for invite creation
+ * @type string
+ * @enum ['TOKEN', 'ALL_OWNER_TOKENS']
+ */
+exports.INVITE_SCOPE_SCHEMA = {
+    type: 'string',
+    enum: ['TOKEN', 'ALL_OWNER_TOKENS'],
+    description: `Invite scope (default: TOKEN):
+- TOKEN: Access to a specific token only (tokenName required)
+- ALL_OWNER_TOKENS: Blanket access to ALL tokens owned by the inviter (tokenName should be omitted)`,
+};
+/**
+ * Ban reason schema - for user ban operations
+ *
+ * @description Optional ban reason with 500 character limit
+ * @type string
+ * @maxLength 500
+ */
+exports.BAN_REASON_SCHEMA = {
+    type: 'string',
+    maxLength: 500,
+    description: 'Ban reason (optional, max 500 characters)',
+};
+/**
+ * Ban duration schema - for temporary bans
+ *
+ * @description Duration in seconds (60 to 31536000)
+ * @type number
+ * @minimum 60
+ * @maximum 31536000
+ * @note Presets: 3600 (1h), 86400 (1d), 604800 (1w), 2592000 (1mo)
+ */
+exports.BAN_DURATION_SCHEMA = {
+    type: 'number',
+    minimum: 60,
+    maximum: 31536000,
+    description: 'Ban duration in seconds (optional, omit for permanent). Range: 60 (1 min) to 31536000 (1 year). Presets: 3600 (1 hour), 86400 (1 day), 604800 (1 week), 2592000 (1 month)',
+};
+/**
+ * Active user type schema - for getActiveUsers
+ *
+ * @description Type of active users to fetch
+ * @type string
+ * @enum ['viewers', 'chat_participants']
+ */
+exports.ACTIVE_USER_TYPE_SCHEMA = {
+    type: 'string',
+    enum: ['viewers', 'chat_participants'],
+    description: 'Type of active users to fetch (default: viewers)',
+};
+// =============================================================================
+// Pool Discovery Schemas (DEX Pool Filtering & Sorting)
+// =============================================================================
+/**
+ * Pool discovery search schema - used in DEX pool discovery tools
+ *
+ * @description Search filter for token symbols in pool pair
+ * @type string
+ * @minLength 1
+ * @maxLength 100
+ * @example "GALA", "GUSDC", "dragon"
+ * @note Fuzzy match - case-insensitive partial matching
+ */
+exports.POOL_DISCOVERY_SEARCH_SCHEMA = {
+    type: 'string',
+    minLength: 1,
+    maxLength: 100,
+    description: 'Search filter for token symbols in pool pair (e.g., "GALA", "GUSDC"). Note: For trading operations, use full tokenId format with pipe delimiters.',
+};
+/**
+ * Pool discovery sort field schema - used in DEX pool discovery tools
+ *
+ * @description Field to sort results by
+ * @type string
+ * @enum ['tvl', 'volume30d', 'volume1d']
+ * @example "tvl" (total value locked), "volume30d" (30-day volume)
+ * @note Default: 'tvl'
+ */
+exports.POOL_DISCOVERY_SORT_BY_SCHEMA = {
+    type: 'string',
+    enum: ['tvl', 'volume30d', 'volume1d'],
+    description: 'Field to sort results by (default: tvl)',
+};
+/**
+ * Pool discovery sort order schema - used in DEX pool discovery tools
+ *
+ * @description Sort direction
+ * @type string
+ * @enum ['asc', 'desc']
+ * @example "asc" (ascending), "desc" (descending)
+ * @note Default: 'desc'
+ */
+exports.POOL_DISCOVERY_SORT_ORDER_SCHEMA = {
+    type: 'string',
+    enum: ['asc', 'desc'],
+    description: 'Sort order direction (default: desc)',
+};
+/**
+ * Pool discovery schema bundle - all three fields combined for spread usage
+ *
+ * @description Complete pool discovery filtering schema for DEX pool tools
+ * @usage Spread into tool inputSchema properties: { ...POOL_DISCOVERY_SCHEMA, otherField: ... }
+ */
+exports.POOL_DISCOVERY_SCHEMA = {
+    search: exports.POOL_DISCOVERY_SEARCH_SCHEMA,
+    sortBy: exports.POOL_DISCOVERY_SORT_BY_SCHEMA,
+    sortOrder: exports.POOL_DISCOVERY_SORT_ORDER_SCHEMA,
+};
+/**
+ * Factory function to create pool discovery tool inputSchema.
+ *
+ * Generates consistent inputSchema for pool discovery tools with optional
+ * pagination and additional properties.
+ *
+ * @param config - Configuration for the pool discovery tool
+ * @returns Object containing inputSchema definition
+ *
+ * @example
+ * // Paginated tool
+ * const schema = createPoolDiscoverySchema({
+ *   includePagination: true,
+ *   defaultLimit: 10,
+ * });
+ *
+ * @example
+ * // Auto-paginated tool with additional property
+ * const schema = createPoolDiscoverySchema({
+ *   additionalProperties: {
+ *     withPrices: {
+ *       type: 'boolean',
+ *       description: 'Whether to fetch real-time pricing data',
+ *     },
+ *   },
+ * });
+ *
+ * @since 6.10.0
+ */
+function createPoolDiscoverySchema(config = {}) {
+    const { includePagination = false, defaultLimit = 10, additionalProperties = {} } = config;
+    const properties = {
+        ...exports.POOL_DISCOVERY_SCHEMA,
+    };
+    if (includePagination) {
+        properties.page = exports.PAGE_SCHEMA;
+        properties.limit = createLimitSchema('pool', defaultLimit);
+    }
+    // Merge additional properties
+    Object.assign(properties, additionalProperties);
+    return {
+        type: 'object',
+        properties,
+    };
+}
+// =============================================================================
+// Message & Chat Schemas (unified)
+// =============================================================================
+/**
+ * Message ID schema - unified support for both chat and comment formats
+ *
+ * Supports both formats:
+ * - New format: msg-{timestamp13}-{uuid32} (comments, modern)
+ * - Legacy format: chat-{timestamp13}-{uuid-with-dashes} (chat messages)
+ *
+ * @description Unified message identifier schema for content reactions and operations
+ * @type string
+ * @pattern ^(msg-\d{13}-[a-f0-9]{32}|chat-\d{13}-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$
+ * @maxLength 64
+ * @example "msg-1703443200000-a1b2c3d4e5f6789012345678901234ab"
+ * @example "chat-1734445623456-550e8400-e29b-41d4-a716-446655440000"
+ * @note Backwards compatible with both new msg-* and legacy chat-* formats
+ */
+exports.MESSAGE_ID_SCHEMA = {
+    type: 'string',
+    maxLength: 64,
+    pattern: '^(msg-\\d{13}-[a-f0-9]{32}|chat-\\d{13}-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$',
+    description: 'Message ID in format msg-{timestamp}-{uuid} or chat-{timestamp}-{uuid} (supports both modern and legacy formats)',
+};
+/**
+ * Chat content schema - for chat messages
+ *
+ * @description Text content for chat messages with 500 character limit
+ * @type string
+ * @minLength 1
+ * @maxLength 500
+ * @example "Hello, this is a chat message!"
+ * @note Shorter than comments (max 2000 chars) for real-time chat context
+ */
+exports.CHAT_CONTENT_SCHEMA = {
+    type: 'string',
+    minLength: 1,
+    maxLength: 500,
+    description: 'Chat message content (1-500 characters)',
+};
+/**
+ * Content reaction type schema
+ *
+ * @description Type of reaction to add/remove on messages
+ * @type string
+ * @enum ['heart', 'fire', 'laugh', 'wow', 'thumbs_up']
+ * @example "heart", "fire", "laugh", "wow", "thumbs_up"
+ */
+exports.REACTION_TYPE_SCHEMA = {
+    type: 'string',
+    enum: ['heart', 'fire', 'laugh', 'wow', 'thumbs_up'],
+    description: 'Type of reaction: heart, fire, laugh, wow, or thumbs_up',
+};
+/**
+ * Combined reaction input schema - shared by 6 content reaction tools
+ *
+ * Encapsulates the tokenName, messageId, and reactionType required for
+ * adding/removing reactions on pool messages (chat messages and comments).
+ *
+ * @description Unified input schema for all reaction tools
+ * @type object
+ * @properties
+ *   - tokenName: Token identifier (3-20 alphanumeric characters)
+ *   - messageId: Message identifier (msg-* or chat-* format)
+ *   - reactionType: Type of reaction to add/remove
+ * @required ['tokenName', 'messageId', 'reactionType']
+ *
+ * @see addContentReactionTool
+ * @see removeContentReactionTool
+ * @see addReactionToChatMessageTool
+ * @see removeReactionFromChatMessageTool
+ * @see addReactionToCommentTool
+ * @see removeReactionFromCommentTool
+ */
+exports.REACTION_INPUT_SCHEMA = {
+    type: 'object',
+    properties: {
+        tokenName: exports.TOKEN_NAME_SCHEMA,
+        messageId: exports.MESSAGE_ID_SCHEMA,
+        reactionType: exports.REACTION_TYPE_SCHEMA,
+    },
+    required: ['tokenName', 'messageId', 'reactionType'],
+};
+// =============================================================================
+// DEX Token Class Key Schema (for pipe-delimited token identification)
+// =============================================================================
+/**
+ * DEX token class key schema - for full pipe-delimited token identification in DEX operations
+ *
+ * Used in DEX swap, liquidity, and pool operations for identifying tokens.
+ * Unlike TOKEN_CLASS_KEY_SCHEMA (object format), this is a simple string format.
+ *
+ * @description String format for token class key in DEX operations
+ * @format Pipe-delimited: "collection|category|type|additionalKey"
+ * @example "GALA|Unit|none|none", "Token|Unit|SYMBOL|client:xxx"
+ * @note For DEX trading operations, NOT for token creation
+ * @see DEX_TOKEN_SYMBOL_SCHEMA for similar usage in swap operations
+ */
+exports.DEX_TOKEN_CLASS_KEY_SCHEMA = {
+    type: 'string',
+    description: 'Full token class key in pipe-delimited format (e.g., "GALA|Unit|none|none" or "Token|Unit|SYMBOL|client:xxx")',
+};
+// =============================================================================
+// DEX Composite Schemas (Reusable token pair + fee combinations)
+// =============================================================================
+/**
+ * Token pair schema - for operations requiring token0, token1, and fee tier
+ *
+ * Combines token class key identifiers with fee tier for DEX pool operations.
+ * Used in liquidity positions, pool quotes, and swap operations.
+ *
+ * @description Common properties for token pair + fee tier operations
+ * @see addLiquidityByPriceTool, addLiquidityByTicksTool, fetchSwapPositionDirectTool
+ */
+exports.TOKEN_PAIR_SCHEMA = {
+    token0: {
+        ...exports.DEX_TOKEN_SYMBOL_SCHEMA,
+        description: 'First token in pair (e.g., "GALA" or "GALA|Unit|none|none")',
+    },
+    token1: {
+        ...exports.DEX_TOKEN_SYMBOL_SCHEMA,
+        description: 'Second token in pair (e.g., "GUSDC" or "Token|Unit|GUSDC|client:xxx")',
+    },
+    fee: exports.FEE_TIER_SCHEMA,
+};
+/**
+ * Token pair with tick range schema - extends token pair with tick boundaries
+ *
+ * Used in liquidity position operations that require price range specification.
+ *
+ * @description Token pair + tick range for concentrated liquidity operations
+ * @see getLiquidityPositionTool, estimateRemoveLiquidityTool, fetchSwapPositionDirectTool
+ */
+exports.TOKEN_PAIR_WITH_TICKS_SCHEMA = {
+    ...exports.TOKEN_PAIR_SCHEMA,
+    tickLower: {
+        type: 'number',
+        description: 'Lower tick boundary of the position',
+    },
+    tickUpper: {
+        type: 'number',
+        description: 'Upper tick boundary of the position',
+    },
+};
+/**
+ * Swap quote input schema - for swap quote operations
+ *
+ * Standardized input for both exactInput and exactOutput quote tools.
+ * Reduces duplication between getSwapQuoteExactInput and getSwapQuoteExactOutput.
+ *
+ * @description Common properties for swap quote operations
+ * @see getSwapQuoteExactInputTool, getSwapQuoteExactOutputTool
+ */
+exports.SWAP_QUOTE_INPUT_SCHEMA = {
+    fromToken: {
+        ...exports.DEX_TOKEN_SYMBOL_SCHEMA,
+        description: 'Source token symbol (e.g., "GALA")',
+    },
+    toToken: {
+        ...exports.DEX_TOKEN_SYMBOL_SCHEMA,
+        description: 'Destination token symbol (e.g., "GUSDC")',
+    },
+    amount: {
+        ...exports.DECIMAL_AMOUNT_SCHEMA,
+        description: 'Amount for the quote',
+    },
+};
+/**
+ * DEX pool quote input schema - for pool-specific quote operations
+ *
+ * Extends token pair with fromToken, toToken, and amount for DEX pool quotes.
+ * Used in local and external pool quote calculations.
+ *
+ * @description Token pair + swap direction + amount for pool quotes
+ * @see calculateDexPoolQuoteLocalTool, calculateDexPoolQuoteExternalTool
+ */
+exports.DEX_POOL_QUOTE_INPUT_SCHEMA = {
+    token0: {
+        ...exports.DEX_TOKEN_CLASS_KEY_SCHEMA,
+        description: 'First token in pool (e.g., "GALA|Unit|none|none")',
+    },
+    token1: {
+        ...exports.DEX_TOKEN_CLASS_KEY_SCHEMA,
+        description: 'Second token in pool (e.g., "Token|Unit|BENE|client:xxx")',
+    },
+    fee: exports.FEE_TIER_SCHEMA,
+    fromToken: {
+        ...exports.DEX_TOKEN_CLASS_KEY_SCHEMA,
+        description: 'Token to swap FROM',
+    },
+    toToken: {
+        ...exports.DEX_TOKEN_CLASS_KEY_SCHEMA,
+        description: 'Token to swap TO',
+    },
+    amount: {
+        ...exports.DECIMAL_AMOUNT_SCHEMA,
+        description: 'Amount of fromToken to swap',
+    },
+};
+/**
+ * Liquidity amount schema - for add/remove liquidity operations
+ *
+ * Standardized desired and minimum amount properties for liquidity operations.
+ *
+ * @description Amount0/Amount1 desired and minimum for liquidity operations
+ * @see addLiquidityByPriceTool, addLiquidityByTicksTool
+ */
+exports.LIQUIDITY_AMOUNTS_SCHEMA = {
+    amount0Desired: {
+        ...exports.DECIMAL_AMOUNT_SCHEMA,
+        description: 'Desired amount of token0 to provide',
+    },
+    amount1Desired: {
+        ...exports.DECIMAL_AMOUNT_SCHEMA,
+        description: 'Desired amount of token1 to provide',
+    },
+    amount0Min: {
+        ...exports.DECIMAL_AMOUNT_SCHEMA,
+        description: 'Minimum acceptable amount0 (optional, defaults to 0)',
+    },
+    amount1Min: {
+        ...exports.DECIMAL_AMOUNT_SCHEMA,
+        description: 'Minimum acceptable amount1 (optional, defaults to 0)',
+    },
+};
+// =============================================================================
+// Bridge Schemas (Cross-Chain Operations)
+// =============================================================================
+/**
+ * External network schema - for cross-chain bridge operations
+ *
+ * Identifies the target blockchain network for bridging operations.
+ * Currently supports Ethereum and Solana as external networks.
+ *
+ * @description Target external blockchain network for bridging
+ * @type string
+ * @enum ['Ethereum', 'Solana']
+ * @example "Ethereum", "Solana"
+ * @note Used in bridgeIn, bridgeOut, estimateBridgeFee operations
+ */
+exports.EXTERNAL_NETWORK_SCHEMA = {
+    type: 'string',
+    enum: ['Ethereum', 'Solana'],
+    description: 'Target external blockchain network',
+};
+// =============================================================================
+// Content Flag Schemas (Moderation)
+// =============================================================================
+/**
+ * Content type schema - for content flag/moderation operations
+ *
+ * Identifies the type of content being flagged or moderated.
+ * Values are derived from SDK ContentType enum.
+ *
+ * @description Type of content being flagged
+ * @type string
+ * @enum ContentType values from SDK
+ * @example "CHAT_MESSAGE", "COMMENT", "STREAM"
+ */
+exports.CONTENT_TYPE_SCHEMA = {
+    type: 'string',
+    enum: Object.values(launchpad_sdk_1.ContentType),
+    description: 'Type of content being flagged (CHAT_MESSAGE, COMMENT, STREAM)',
+};
+/**
+ * Flag reason schema - for content flag operations
+ *
+ * Required for stream flags, optional for chat/comment flags.
+ * Values are derived from SDK FlagReason enum.
+ *
+ * @description Reason for flagging content
+ * @type string
+ * @enum FlagReason values from SDK
+ * @example "INAPPROPRIATE_CONTENT", "SPAM", "HARASSMENT", "SCAM", "OTHER"
+ */
+exports.FLAG_REASON_SCHEMA = {
+    type: 'string',
+    enum: Object.values(launchpad_sdk_1.FlagReason),
+    description: 'Reason for the flag (INAPPROPRIATE_CONTENT, SPAM, HARASSMENT, SCAM, OTHER)',
+};
+/**
+ * Flag status schema - for filtering and querying flags
+ *
+ * Used to filter flags by their current status.
+ * Values are derived from SDK FlagStatus enum.
+ *
+ * @description Current status of a content flag
+ * @type string
+ * @enum FlagStatus values from SDK
+ * @example "PENDING", "DISMISSED", "ACTIONED"
+ */
+exports.FLAG_STATUS_SCHEMA = {
+    type: 'string',
+    enum: Object.values(launchpad_sdk_1.FlagStatus),
+    description: 'Flag status (PENDING, DISMISSED, ACTIONED)',
+};
+/**
+ * Flag action schema - for taking action on flagged content
+ *
+ * Specifies the action to take when moderating flagged content.
+ * Values are derived from SDK FlagAction enum.
+ *
+ * @description Action to take on flagged content
+ * @type string
+ * @enum FlagAction values from SDK
+ * @example "DELETE_CONTENT", "BAN_USER", "DELETE_AND_BAN"
+ */
+exports.FLAG_ACTION_SCHEMA = {
+    type: 'string',
+    enum: Object.values(launchpad_sdk_1.FlagAction),
+    description: 'Action to take on flagged content (DELETE_CONTENT, BAN_USER, DELETE_AND_BAN)',
+};
+// =============================================================================
+// Batch Operation Schemas (Token Locks, Unlocks, Burns, Transfers)
+// =============================================================================
+/**
+ * Base batch token item schema - core properties for all batch operations
+ *
+ * Contains tokenId OR tokenName for identification, plus amount.
+ * Extended by lock-specific and other operation-specific schemas.
+ *
+ * @description Core properties shared by lock, unlock, burn, and transfer batch items
+ * @see BATCH_TOKEN_LOCK_ITEM_SCHEMA for lock-specific extension
+ */
+exports.BATCH_TOKEN_ITEM_PROPERTIES = {
+    tokenId: {
+        ...exports.FLEXIBLE_TOKEN_ID_SCHEMA,
+        description: 'Token identifier (use this OR tokenName, not both)',
+    },
+    tokenName: {
+        ...exports.TOKEN_NAME_SCHEMA,
+        description: 'Token name for lookup (e.g., "anime", "dragon") - used if tokenId not provided',
+    },
+    amount: {
+        ...exports.INTEGER_AMOUNT_SCHEMA,
+        description: 'Amount of tokens in decimal format',
+    },
+};
+/**
+ * Lock-specific properties for batch token lock items
+ *
+ * @description Additional properties only used in lock operations
+ */
+exports.BATCH_TOKEN_LOCK_EXTRA_PROPERTIES = {
+    lockAuthority: {
+        type: 'string',
+        description: 'Address that can unlock these tokens (defaults to caller if not specified)',
+    },
+    expires: {
+        type: 'number',
+        description: 'Optional expiration timestamp in milliseconds (epoch time). Lock auto-releases after this time.',
+    },
+    name: {
+        type: 'string',
+        description: 'Optional name/identifier for the lock. Can be used to match during unlock.',
+    },
+};
+/**
+ * Unlock-specific properties for batch token unlock items
+ *
+ * @description Additional properties only used in unlock operations
+ */
+exports.BATCH_TOKEN_UNLOCK_EXTRA_PROPERTIES = {
+    name: {
+        type: 'string',
+        description: 'Optional name to match a specific lock (must match the name used during lock)',
+    },
+};
+/**
+ * Creates a batch token array schema for batch operations
+ *
+ * @param itemDescription - Description for the array
+ * @param extraProperties - Additional properties beyond base (tokenId, tokenName, amount)
+ * @returns Schema for the tokens array
+ */
+function createBatchTokenArraySchema(itemDescription, extraProperties = {}) {
+    return {
+        type: 'array',
+        description: itemDescription,
+        items: {
+            type: 'object',
+            properties: {
+                ...exports.BATCH_TOKEN_ITEM_PROPERTIES,
+                ...extraProperties,
+            },
+            required: ['amount'],
+        },
+        minItems: 1,
+    };
+}
+/**
+ * Common batch operation base properties (uniqueKey, privateKey)
+ *
+ * @description Shared by lock, unlock, burn operations
+ */
+exports.BATCH_OPERATION_BASE_PROPERTIES = {
+    uniqueKey: exports.UNIQUE_KEY_SCHEMA,
+    privateKey: exports.PRIVATE_KEY_SCHEMA,
+};
+// =============================================================================
+// Wrap/Unwrap Operation Schemas (Cross-Channel Bridge)
+// =============================================================================
+/**
+ * Common wrap/unwrap operation properties
+ *
+ * Shared input schema properties for wrapToken and unwrapToken operations.
+ * Both operations use the same structure, only differing in SDK method called.
+ *
+ * @description Input properties for wrap/unwrap cross-channel bridge operations
+ * @see wrapTokenTool, unwrapTokenTool
+ */
+exports.WRAP_UNWRAP_PROPERTIES = {
+    tokenId: {
+        ...exports.FLEXIBLE_TOKEN_ID_SCHEMA,
+        description: 'Token identifier (accepts symbol, pipe-delimited string, or TokenClassKey object)',
+    },
+    amount: {
+        ...exports.DECIMAL_AMOUNT_SCHEMA,
+        description: 'Amount to wrap/unwrap (decimal string, e.g., "100.5")',
+    },
+    recipient: {
+        ...exports.ADDRESS_SCHEMA,
+        description: 'Optional recipient address (defaults to sender)',
+    },
+    memo: {
+        type: 'string',
+        description: 'Optional memo for the transaction',
+    },
+};
+// =============================================================================
+// Admin/Moderation Pagination Schemas
+// =============================================================================
+/**
+ * Admin pagination limit schema - for moderator/overseer management tools
+ *
+ * Used by moderator invites, overseer management, and similar admin tools.
+ * Uses a max of 50 to match backend constraints for admin operations.
+ *
+ * @description Results per page for admin operations
+ * @type number
+ * @minimum 1
+ * @maximum 50
+ * @example 10, 20, 50
+ */
+exports.ADMIN_LIMIT_SCHEMA = {
+    type: 'number',
+    minimum: 1,
+    maximum: 50,
+    description: 'Results per page (default: 20, maximum: 50)',
+};
+// =============================================================================
+// Streaming Schemas
+// =============================================================================
+/**
+ * RTMP URL validation pattern
+ * Validates: rtmp://host[:port][/path] or rtmps://host[:port][/path]
+ */
+const RTMP_URL_PATTERN = '^rtmps?://[a-zA-Z0-9.-]+(:[0-9]+)?(/.*)?$';
+/**
+ * RTMP URL schema - for streaming simulcast operations
+ *
+ * Validates RTMP and RTMPS URLs for streaming destinations.
+ * Used in simulcast target configuration.
+ *
+ * @description Valid RTMP or RTMPS streaming URL
+ * @type string
+ * @pattern ^rtmps?://[a-zA-Z0-9.-]+(:[0-9]+)?(/.*)?$
+ * @example "rtmp://a.rtmp.youtube.com/live2", "rtmps://live.twitch.tv/app"
+ */
+exports.RTMP_URL_SCHEMA = {
+    type: 'string',
+    pattern: RTMP_URL_PATTERN,
+    description: 'Valid RTMP URL (rtmp://host[:port][/path] or rtmps://...)',
+};
+// =============================================================================
+// Empty Input Schemas (for tools with no parameters)
+// =============================================================================
+/**
+ * Empty input schema - for tools that require no parameters
+ *
+ * Reusable schema for MCP tools that don't accept any input parameters.
+ * Used by read-only/status/list tools like fetchCurrentDexSeason, getSession, etc.
+ *
+ * @description Standard empty object schema for parameterless tools
+ * @type object
+ * @properties {}
+ * @example Used by: fetchAllDexSeasons, fetchCurrentDexSeason, getSession, logout
+ */
+exports.EMPTY_INPUT_SCHEMA = {
+    type: 'object',
+    properties: {},
+};
 //# sourceMappingURL=common-schemas.js.map