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

package/dist/tools/token-ban/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/token-ban/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAclD;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,OA+B1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,OAwB5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,OA2B/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,OAoB7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAoB/B,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,OAAO,EAMlC,CAAC"}

package/dist/tools/token-ban/index.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Token Ban Operations Tools (Overseer Only)
+ *
+ * MCP tools for platform-wide token ban management.
+ * Banned tokens are hidden from all listings and have actions blocked.
+ *
+ * This is different from user bans (ban/ directory):
+ * - Token bans: Platform-wide, affects ALL users viewing/interacting with the token
+ * - User bans: Per-token, only affects specific user on specific token
+ *
+ * All endpoints require either:
+ * - Admin API key (server-to-server)
+ * - JWT with overseer status (authenticated overseer user)
+ *
+ * @since 6.x.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenBanTools = exports.isTokenBannedTool = exports.getTokenBanTool = exports.listTokenBansTool = exports.unbanTokenTool = exports.banTokenTool = void 0;
+const handler_factories_js_1 = require("../handler-factories.js");
+const common_schemas_js_1 = require("../../schemas/common-schemas.js");
+// =============================================================================
+// Token Ban Management Tools
+// =============================================================================
+/**
+ * 1. Ban Token
+ */
+exports.banTokenTool = {
+    name: 'gala_launchpad_ban_token',
+    description: `Ban a token from the platform (overseer only).
+
+When a token is banned:
+- Hidden from ALL pool listings (including creator's profile)
+- Comments blocked on banned tokens
+- Live streaming blocked on banned tokens
+- Chat messages blocked on banned tokens
+- Trading NOT blocked (GalaChain handles trading independently)
+
+Token bans are permanent until explicitly removed by an overseer.
+
+RETURNS: { ban: { id, tokenName, reason, bannedBy, createdAt, updatedAt }, tokenName }
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth with overseer status`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+            reason: {
+                ...common_schemas_js_1.BAN_REASON_SCHEMA,
+                description: 'Ban reason (optional, max 500 characters). E.g., "Fraudulent project", "Scam token", etc.',
+            },
+        },
+        required: ['tokenName'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('banToken', (args) => ({
+        tokenName: args.tokenName,
+        reason: args.reason,
+    })),
+};
+/**
+ * 2. Unban Token
+ */
+exports.unbanTokenTool = {
+    name: 'gala_launchpad_unban_token',
+    description: `Remove a ban from a token (overseer only).
+
+When a token is unbanned:
+- Restored to all pool listings
+- Visible on creator's profile again
+- Comments re-enabled
+- Live streaming re-enabled
+- Chat re-enabled
+
+RETURNS: { removed: true, tokenName }
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth with overseer status`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+        },
+        required: ['tokenName'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('unbanToken', (args) => ({
+        tokenName: args.tokenName,
+    })),
+};
+/**
+ * 3. List Token Bans
+ */
+exports.listTokenBansTool = {
+    name: 'gala_launchpad_list_token_bans',
+    description: `List all banned tokens (overseer only).
+
+Returns a paginated list of all banned tokens with their ban details.
+Supports searching by token name (partial match).
+
+RETURNS: { items: [{ id, tokenName, reason, bannedBy, createdAt, updatedAt }...], meta: { total, page, limit, totalPages } }
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth with overseer status`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            page: common_schemas_js_1.PAGE_SCHEMA,
+            limit: (0, common_schemas_js_1.createLimitSchema)('pool', 20),
+            search: {
+                ...common_schemas_js_1.SEARCH_SCHEMA,
+                description: 'Search by token name (partial match, case-insensitive)',
+            },
+        },
+        required: [],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('listTokenBans', (args) => ({
+        page: args.page,
+        limit: args.limit,
+        search: args.search,
+    })),
+};
+/**
+ * 4. Get Token Ban
+ */
+exports.getTokenBanTool = {
+    name: 'gala_launchpad_get_token_ban',
+    description: `Get ban details for a specific token (overseer only).
+
+Returns whether the token is banned and ban details if applicable.
+Use this for detailed ban information including reason and who banned it.
+
+RETURNS: { banned: boolean, ban?: { id, tokenName, reason, bannedBy, createdAt, updatedAt }, tokenName }
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth with overseer status`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+        },
+        required: ['tokenName'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('getTokenBan', (args) => ({
+        tokenName: args.tokenName,
+    })),
+};
+/**
+ * 5. Is Token Banned
+ */
+exports.isTokenBannedTool = {
+    name: 'gala_launchpad_is_token_banned',
+    description: `Check if a token is banned (overseer only).
+
+Convenience alias for getTokenBan - provided for semantic clarity.
+Use when you just need to check if a token is banned.
+
+RETURNS: { banned: boolean, ban?: { id, tokenName, reason, bannedBy, createdAt, updatedAt }, tokenName }
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth with overseer status`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+        },
+        required: ['tokenName'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('isTokenBanned', (args) => ({
+        tokenName: args.tokenName,
+    })),
+};
+// =============================================================================
+// Export All Tools
+// =============================================================================
+exports.tokenBanTools = [
+    exports.banTokenTool,
+    exports.unbanTokenTool,
+    exports.listTokenBansTool,
+    exports.getTokenBanTool,
+    exports.isTokenBannedTool,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/token-ban/index.js.map

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

package/dist/tools/tool-factory.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Tool Factory Utilities for Event Watchers
+ *
+ * Provides reusable factory functions for creating MCP event watcher tools.
+ * Reduces boilerplate and ensures consistent polling and timeout behavior.
+ *
+ * @example
+ * // Create a DEX pool watcher
+ * const tool = createEventWatcherTool({
+ *   name: 'gala_launchpad_on_dex_pool_creation',
+ *   description: 'Watch for new DEX pool creation events',
+ *   sdkMethodName: 'onDexPoolCreation',
+ *   resultKey: 'poolsDetected',
+ *   filterSchema: {
+ *     minTVL: { type: 'number', description: 'Minimum TVL filter' },
+ *     tokens: { type: 'array', items: { type: 'string' } }
+ *   }
+ * });
+ */
+import type { MCPTool } from '../types/mcp.js';
+/**
+ * Configuration for event watcher tool factory
+ */
+export interface EventWatcherToolConfig {
+    /** Name of the MCP tool */
+    name: string;
+    /** Description of the MCP tool */
+    description: string;
+    /** Name of the SDK method to call (must accept callback and options) */
+    sdkMethodName: string;
+    /** Key in the response object for event count (e.g., 'poolsDetected', 'tokensDetected') */
+    resultKey: string;
+    /** Optional JSON schema for filter properties */
+    filterSchema?: Record<string, unknown>;
+}
+/**
+ * Creates an event watcher MCP tool with polling and timeout support.
+ *
+ * Handles the common pattern of:
+ * 1. Calling an SDK event subscription method with filters
+ * 2. Collecting events in an array during the poll period
+ * 3. Unsubscribing after a configured duration
+ * 4. Returning results with event count and collected events
+ *
+ * @param config - Configuration for the event watcher tool
+ * @returns MCPTool ready to be registered with the MCP server
+ *
+ * @example
+ * // Create a DEX pool watcher
+ * const tool = createEventWatcherTool({
+ *   name: 'gala_launchpad_on_dex_pool_creation',
+ *   description: 'Watch for new DEX pool creation events in real-time',
+ *   sdkMethodName: 'onDexPoolCreation',
+ *   resultKey: 'poolsDetected',
+ *   filterSchema: {
+ *     minTVL: {
+ *       type: 'number',
+ *       description: 'Only notify about pools with TVL >= minTVL (optional)',
+ *     },
+ *     tokens: {
+ *       type: 'array',
+ *       items: { type: 'string' },
+ *       description: 'Only notify about pools containing these token symbols (optional)',
+ *     }
+ *   }
+ * });
+ *
+ * @example
+ * // Create a launchpad token watcher
+ * const tool = createEventWatcherTool({
+ *   name: 'gala_launchpad_on_launchpad_token_creation',
+ *   description: 'Watch for new launchpad token creation events in real-time',
+ *   sdkMethodName: 'onLaunchpadTokenCreation',
+ *   resultKey: 'tokensDetected',
+ *   filterSchema: {
+ *     creatorAddress: {
+ *       type: 'string',
+ *       description: 'Only notify about tokens created by this address (optional)',
+ *     }
+ *   }
+ * });
+ */
+export declare function createEventWatcherTool(config: EventWatcherToolConfig): MCPTool;
+//# sourceMappingURL=tool-factory.d.ts.map

package/dist/tools/tool-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-factory.d.ts","sourceRoot":"","sources":["../../src/tools/tool-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAK/C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IAEb,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IAEpB,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IAEtB,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAC;IAElB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAiF9E"}

package/dist/tools/tool-factory.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * Tool Factory Utilities for Event Watchers
+ *
+ * Provides reusable factory functions for creating MCP event watcher tools.
+ * Reduces boilerplate and ensures consistent polling and timeout behavior.
+ *
+ * @example
+ * // Create a DEX pool watcher
+ * const tool = createEventWatcherTool({
+ *   name: 'gala_launchpad_on_dex_pool_creation',
+ *   description: 'Watch for new DEX pool creation events',
+ *   sdkMethodName: 'onDexPoolCreation',
+ *   resultKey: 'poolsDetected',
+ *   filterSchema: {
+ *     minTVL: { type: 'number', description: 'Minimum TVL filter' },
+ *     tokens: { type: 'array', items: { type: 'string' } }
+ *   }
+ * });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEventWatcherTool = createEventWatcherTool;
+const response_formatter_js_1 = require("../utils/response-formatter.js");
+const error_handler_js_1 = require("../utils/error-handler.js");
+/**
+ * Creates an event watcher MCP tool with polling and timeout support.
+ *
+ * Handles the common pattern of:
+ * 1. Calling an SDK event subscription method with filters
+ * 2. Collecting events in an array during the poll period
+ * 3. Unsubscribing after a configured duration
+ * 4. Returning results with event count and collected events
+ *
+ * @param config - Configuration for the event watcher tool
+ * @returns MCPTool ready to be registered with the MCP server
+ *
+ * @example
+ * // Create a DEX pool watcher
+ * const tool = createEventWatcherTool({
+ *   name: 'gala_launchpad_on_dex_pool_creation',
+ *   description: 'Watch for new DEX pool creation events in real-time',
+ *   sdkMethodName: 'onDexPoolCreation',
+ *   resultKey: 'poolsDetected',
+ *   filterSchema: {
+ *     minTVL: {
+ *       type: 'number',
+ *       description: 'Only notify about pools with TVL >= minTVL (optional)',
+ *     },
+ *     tokens: {
+ *       type: 'array',
+ *       items: { type: 'string' },
+ *       description: 'Only notify about pools containing these token symbols (optional)',
+ *     }
+ *   }
+ * });
+ *
+ * @example
+ * // Create a launchpad token watcher
+ * const tool = createEventWatcherTool({
+ *   name: 'gala_launchpad_on_launchpad_token_creation',
+ *   description: 'Watch for new launchpad token creation events in real-time',
+ *   sdkMethodName: 'onLaunchpadTokenCreation',
+ *   resultKey: 'tokensDetected',
+ *   filterSchema: {
+ *     creatorAddress: {
+ *       type: 'string',
+ *       description: 'Only notify about tokens created by this address (optional)',
+ *     }
+ *   }
+ * });
+ */
+function createEventWatcherTool(config) {
+    const { name, description, sdkMethodName, resultKey, filterSchema = {} } = config;
+    // Build input schema with standard polling/duration fields
+    const inputSchema = {
+        type: 'object',
+        properties: {
+            ...filterSchema,
+            intervalMs: {
+                type: 'number',
+                description: 'Poll interval in milliseconds (default: 30000 / 30 seconds)',
+            },
+            durationSeconds: {
+                type: 'number',
+                description: 'How long to watch for new events in seconds (default: 60)',
+            },
+        },
+    };
+    const handler = (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+        const durationSeconds = args.durationSeconds ?? 60;
+        const durationMs = durationSeconds * 1000;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Event types are internal SDK types
+        const events = [];
+        return new Promise((resolve) => {
+            // Get the SDK method dynamically
+            const sdkMethod = sdk[sdkMethodName];
+            if (!sdkMethod || typeof sdkMethod !== 'function') {
+                throw new Error(`SDK method "${sdkMethodName}" not found`);
+            }
+            // Build filter options by extracting only the filter-related args
+            // Exclude intervalMs and durationSeconds as those are handled by the factory
+            const filterOptions = {};
+            const filterKeys = Object.keys(filterSchema);
+            for (const key of filterKeys) {
+                if (key in args) {
+                    filterOptions[key] = args[key];
+                }
+            }
+            // Add intervalMs if provided
+            if ('intervalMs' in args && args.intervalMs !== undefined) {
+                filterOptions.intervalMs = args.intervalMs;
+            }
+            // Subscribe to events
+            const unsubscribe = sdkMethod.call(sdk, (event) => {
+                events.push(event);
+            }, filterOptions);
+            // Stop watching after duration
+            setTimeout(() => {
+                unsubscribe();
+                resolve((0, response_formatter_js_1.formatSuccess)({
+                    [resultKey]: events.length,
+                    durationSeconds,
+                    events,
+                }));
+            }, durationMs);
+        });
+    });
+    return {
+        name,
+        description,
+        inputSchema,
+        handler,
+    };
+}
+//# sourceMappingURL=tool-factory.js.map

package/dist/tools/tool-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-factory.js","sourceRoot":"","sources":["../../src/tools/tool-factory.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;AA0EH,wDAiFC;AAvJD,0EAA+D;AAC/D,gEAA8D;AAsB9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,SAAgB,sBAAsB,CAAC,MAA8B;IACnE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAElF,2DAA2D;IAC3D,MAAM,WAAW,GAAG;QAClB,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,GAAG,YAAY;YACf,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6DAA6D;aAC3E;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2DAA2D;aACzE;SACF;KACF,CAAC;IAEF,MAAM,OAAO,GAAG,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAiB,EAAE,IAA6B,EAAE,EAAE;QAC3F,MAAM,eAAe,GAAI,IAAI,CAAC,eAAsC,IAAI,EAAE,CAAC;QAC3E,MAAM,UAAU,GAAG,eAAe,GAAG,IAAI,CAAC;QAE1C,oGAAoG;QACpG,MAAM,MAAM,GAAU,EAAE,CAAC;QAEzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,iCAAiC;YACjC,MAAM,SAAS,GACb,GACD,CAAC,aAAa,CAAC,CAAC;YAEjB,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;gBAClD,MAAM,IAAI,KAAK,CAAC,eAAe,aAAa,aAAa,CAAC,CAAC;YAC7D,CAAC;YAED,kEAAkE;YAClE,6EAA6E;YAC7E,MAAM,aAAa,GAA4B,EAAE,CAAC;YAClD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAE7C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;gBAC7B,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;oBAChB,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;YAED,6BAA6B;YAC7B,IAAI,YAAY,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC1D,aAAa,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;YAC7C,CAAC;YAED,sBAAsB;YACtB,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAChC,GAAG,EACH,CAAC,KAAc,EAAE,EAAE;gBACjB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC,EACD,aAAa,CACA,CAAC;YAEhB,+BAA+B;YAC/B,UAAU,CAAC,GAAG,EAAE;gBACd,WAAW,EAAE,CAAC;gBACd,OAAO,CACL,IAAA,qCAAa,EAAC;oBACZ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM;oBAC1B,eAAe;oBACf,MAAM;iBACP,CAAC,CACH,CAAC;YACJ,CAAC,EAAE,UAAU,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,IAAI;QACJ,WAAW;QACX,WAAW;QACX,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/tools/trades/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Trades Query Tools
+ *
+ * MCP tools for querying trade history with tokenName/userAddress filters.
+ *
+ * @since 6.2.0
+ */
+import type { MCPTool } from '../../types/mcp.js';
+/**
+ * Get Trades
+ *
+ * Query trades with flexible filtering by tokenName and/or userAddress.
+ * At least one filter must be provided.
+ */
+export declare const getTradesTool: MCPTool;
+/**
+ * All trades tools (1 total)
+ */
+export declare const tradesTools: MCPTool[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/trades/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA8BlD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,OAmF3B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,EAEhC,CAAC"}

package/dist/tools/trades/index.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * Trades Query Tools
+ *
+ * MCP tools for querying trade history with tokenName/userAddress filters.
+ *
+ * @since 6.2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tradesTools = exports.getTradesTool = void 0;
+const common_schemas_js_1 = require("../../schemas/common-schemas.js");
+const handler_factories_js_1 = require("../handler-factories.js");
+// =============================================================================
+// Trades Tools
+// =============================================================================
+/**
+ * Get Trades
+ *
+ * Query trades with flexible filtering by tokenName and/or userAddress.
+ * At least one filter must be provided.
+ */
+exports.getTradesTool = {
+    name: 'gala_launchpad_get_trades',
+    description: `Query trades with flexible filtering options.
+
+Returns paginated list of trades with metadata.
+At least one of tokenName or userAddress is required.
+
+Filters:
+- tokenName: Filter by token name (e.g., 'anime')
+- userAddress: Filter by user wallet address
+- txnType: Filter by trade direction ('BUY' or 'SELL')
+- startDate/endDate: Filter by date range (ISO 8601)
+- minAmount/maxAmount: Filter by trade amount range
+
+RETURNS: { trades: [{ txnId, txnType, inputAmount, outputAmount, userAddress, tokenName, tokenImage, createdAt }], meta: { totalItems, currentPage, pageSize, totalPages } }
+
+Examples:
+- Get all trades for a token: { tokenName: 'anime' }
+- Get all trades by a user: { userAddress: 'eth|123...' }
+- Get only buy trades: { tokenName: 'anime', txnType: 'BUY' }
+- Get trades in date range: { tokenName: 'anime', startDate: '2024-01-01', endDate: '2024-12-31' }
+- Get large trades: { tokenName: 'anime', minAmount: 1000 }
+
+Public endpoint - no authentication required.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenName: {
+                ...common_schemas_js_1.TOKEN_NAME_SCHEMA,
+                description: 'Token name to filter by (optional if userAddress provided)',
+            },
+            userAddress: {
+                ...common_schemas_js_1.ADDRESS_SCHEMA,
+                description: 'User address to filter by (optional if tokenName provided)',
+            },
+            page: common_schemas_js_1.PAGE_SCHEMA,
+            limit: (0, common_schemas_js_1.createLimitSchema)('trade', 20),
+            txnType: {
+                type: 'string',
+                enum: ['BUY', 'SELL'],
+                description: 'Filter by trade direction (BUY or SELL)',
+            },
+            startDate: {
+                ...common_schemas_js_1.DATE_TIME_SCHEMA,
+                description: 'Filter by date range start (ISO 8601 format, e.g., "2024-01-01")',
+            },
+            endDate: {
+                ...common_schemas_js_1.DATE_TIME_SCHEMA,
+                description: 'Filter by date range end (ISO 8601 format, e.g., "2024-12-31")',
+            },
+            minAmount: {
+                type: 'number',
+                minimum: 0,
+                description: 'Filter by minimum trade amount',
+            },
+            maxAmount: {
+                type: 'number',
+                minimum: 0,
+                description: 'Filter by maximum trade amount',
+            },
+        },
+        required: [],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('getTrades', (args) => {
+        const typedArgs = args;
+        // Validate that at least one filter is provided
+        if (!typedArgs.tokenName && !typedArgs.userAddress) {
+            throw new Error('At least one of tokenName or userAddress is required');
+        }
+        return {
+            tokenName: typedArgs.tokenName,
+            userAddress: typedArgs.userAddress,
+            page: typedArgs.page,
+            limit: typedArgs.limit,
+            txnType: typedArgs.txnType,
+            startDate: typedArgs.startDate,
+            endDate: typedArgs.endDate,
+            minAmount: typedArgs.minAmount,
+            maxAmount: typedArgs.maxAmount,
+        };
+    }),
+};
+// =============================================================================
+// Export
+// =============================================================================
+/**
+ * All trades tools (1 total)
+ */
+exports.tradesTools = [
+    exports.getTradesTool,
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/trades/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAGH,uEAMyC;AACzC,kEAA8D;AAkB9D,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;;;GAKG;AACU,QAAA,aAAa,GAAY;IACpC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;8CAqB+B;IAC5C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,GAAG,qCAAiB;gBACpB,WAAW,EAAE,4DAA4D;aAC1E;YACD,WAAW,EAAE;gBACX,GAAG,kCAAc;gBACjB,WAAW,EAAE,4DAA4D;aAC1E;YACD,IAAI,EAAE,+BAAW;YACjB,KAAK,EAAE,IAAA,qCAAiB,EAAC,OAAO,EAAE,EAAE,CAAC;YACrC,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;gBACrB,WAAW,EAAE,yCAAyC;aACvD;YACD,SAAS,EAAE;gBACT,GAAG,oCAAgB;gBACnB,WAAW,EAAE,kEAAkE;aAChF;YACD,OAAO,EAAE;gBACP,GAAG,oCAAgB;gBACnB,WAAW,EAAE,gEAAgE;aAC9E;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,gCAAgC;aAC9C;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,gCAAgC;aAC9C;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;QACjD,MAAM,SAAS,GAAG,IAAqB,CAAC;QAExC,gDAAgD;QAChD,IAAI,CAAC,SAAS,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO;YACL,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,SAAS,EAAE,SAAS,CAAC,SAAS;SAC/B,CAAC;IACJ,CAAC,CAAC;CACH,CAAC;AAEF,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF;;GAEG;AACU,QAAA,WAAW,GAAc;IACpC,qBAAa;CACd,CAAC"}