@gala-chain/launchpad-mcp-server 1.0.0

package/.env.example

@@ -0,0 +1,13 @@
+# Gala Launchpad MCP Server Configuration
+
+# Required: Your Ethereum wallet private key (with 0x prefix)
+PRIVATE_KEY=0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
+
+# Optional: Environment (development or production)
+ENVIRONMENT=development
+
+# Optional: Enable debug logging (true or false)
+DEBUG=false
+
+# Optional: Request timeout in milliseconds
+TIMEOUT=30000

package/.eslintrc.json

@@ -0,0 +1,20 @@
+{
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module"
+  },
+  "plugins": ["@typescript-eslint"],
+  "env": {
+    "node": true,
+    "es2022": true
+  },
+  "rules": {
+    "@typescript-eslint/no-explicit-any": "off",
+    "@typescript-eslint/no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }]
+  }
+}

package/README.md

@@ -0,0 +1,178 @@
+# @gala-chain/launchpad-mcp-server
+
+MCP (Model Context Protocol) server for Gala Launchpad SDK - Enables AI agents to interact with Gala Launchpad.
+
+## 🚀 Features
+
+- **27 AI-accessible tools** for complete Gala Launchpad integration
+- **Type-safe** - Full TypeScript support with validated inputs
+- **Production-ready** - Built on [@gala-chain/launchpad-sdk v3.0.2](https://www.npmjs.com/package/@gala-chain/launchpad-sdk)
+- **Easy setup** - Works with Claude Desktop and other MCP clients
+- **Comprehensive** - Pool management, trading, balances, token creation, comments, transfers
+
+## 📦 Installation
+
+```bash
+npm install -g @gala-chain/launchpad-mcp-server
+```
+
+## 🏁 Quick Start
+
+### Claude Desktop Configuration
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "gala-launchpad": {
+      "command": "npx",
+      "args": ["-y", "@gala-chain/launchpad-mcp-server"],
+      "env": {
+        "PRIVATE_KEY": "0x1234567890abcdef...",
+        "ENVIRONMENT": "development"
+      }
+    }
+  }
+}
+```
+
+**Environment Variables:**
+- `PRIVATE_KEY` (required) - Your Ethereum wallet private key
+- `ENVIRONMENT` (optional) - `development` or `production` (default: development)
+- `DEBUG` (optional) - `true` to enable debug logging
+- `TIMEOUT` (optional) - Request timeout in milliseconds (default: 30000)
+
+### Using with Claude Desktop
+
+1. **Install**: `npm install -g @gala-chain/launchpad-mcp-server`
+2. **Configure**: Add server to `claude_desktop_config.json` (see above)
+3. **Restart Claude Desktop**
+4. **Use tools**: Ask Claude to interact with Gala Launchpad!
+
+## 🛠️ Available Tools (27 Total)
+
+### Pool Management (8 tools)
+- `gala_launchpad_fetch_pools` - Fetch token pools with filtering
+- `gala_launchpad_fetch_pool_details` - Get detailed pool state
+- `gala_launchpad_fetch_token_distribution` - Get holder distribution
+- `gala_launchpad_fetch_token_badges` - Get achievement badges
+- `gala_launchpad_fetch_volume_data` - Get OHLCV charting data
+- `gala_launchpad_check_token_name` - Check name availability
+- `gala_launchpad_check_token_symbol` - Check symbol availability
+- `gala_launchpad_resolve_vault_address` - Get GalaChain vault address
+
+### Trading Operations (6 tools)
+- `gala_launchpad_calculate_buy_amount` - Calculate buy amounts
+- `gala_launchpad_calculate_sell_amount` - Calculate sell amounts
+- `gala_launchpad_buy_tokens` - Execute token purchase
+- `gala_launchpad_sell_tokens` - Execute token sale
+- `gala_launchpad_fetch_trades` - Get trade history
+- `gala_launchpad_calculate_initial_buy` - Calculate initial buy
+
+### Balance & Portfolio (6 tools)
+- `gala_launchpad_fetch_gala_balance` - Get GALA balance
+- `gala_launchpad_fetch_token_balance` - Get token balance
+- `gala_launchpad_fetch_tokens_held` - Get portfolio holdings
+- `gala_launchpad_fetch_tokens_created` - Get created tokens
+- `gala_launchpad_fetch_profile` - Get user profile
+- `gala_launchpad_update_profile` - Update profile
+
+### Token Creation (3 tools)
+- `gala_launchpad_launch_token` - Create new token pool
+- `gala_launchpad_upload_token_image` - Upload token image from filesystem
+- `gala_launchpad_upload_profile_image` - Upload profile image from filesystem
+
+### Comments & Social (2 tools)
+- `gala_launchpad_post_comment` - Post comment on token
+- `gala_launchpad_fetch_comments` - Get token comments
+
+### Token Transfers (2 tools)
+- `gala_launchpad_transfer_gala` - Transfer GALA tokens
+- `gala_launchpad_transfer_token` - Transfer launchpad tokens
+
+## 💡 Example Usage
+
+Ask Claude (or your AI assistant):
+
+> "Fetch the 10 most recent token pools on Gala Launchpad"
+
+> "What's my GALA balance?"
+
+> "Calculate how many tokens I'd get if I buy with 100 GALA on dragnrkti"
+
+> "Buy 50 GALA worth of rocketri tokens with 5% slippage"
+
+> "Show me all tokens I'm holding"
+
+## 🔧 Development
+
+### Local Development
+
+```bash
+# Clone repository
+git clone https://gitlab.com/gala-games/defi/launchpad/sdk.git
+cd launchpad-sdk/packages/mcp-server
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run in development mode
+npm run dev
+```
+
+### Testing
+
+```bash
+npm test
+```
+
+## 📚 Documentation
+
+- [MCP Tool Specification](../../packages/sdk/docs/MCP-TOOL-SPECIFICATION.md) - Complete tool reference
+- [AI Agent Guide](../../packages/sdk/docs/AI-AGENT-GUIDE.md) - Integration patterns
+- [SDK Documentation](../sdk/README.md) - Underlying SDK reference
+
+## 🔐 Security
+
+**Important Security Notes:**
+
+1. **Private Keys** - Never commit private keys to version control
+2. **Environment Variables** - Store credentials in `claude_desktop_config.json` securely
+3. **Wallet Safety** - Use separate wallets for development and production
+4. **Amount Limits** - Consider setting up trading limits for automated agents
+
+## 🐛 Troubleshooting
+
+### "SDK not initialized"
+- Ensure `PRIVATE_KEY` is set in environment variables
+- Check that private key format is valid (0x + 64 hex characters)
+
+### "Tool not found"
+- Restart Claude Desktop after configuration changes
+- Verify server is listed in Claude Desktop settings
+
+### "Connection failed"
+- Check DEBUG=true logs for detailed error messages
+- Verify network connectivity to Gala Launchpad backends
+
+## 📄 License
+
+MIT License - see [LICENSE](../../LICENSE) file for details.
+
+## 🤝 Contributing
+
+Contributions welcome! Please read [CONTRIBUTING.md](../../CONTRIBUTING.md) for guidelines.
+
+## 📞 Support
+
+- **Issues**: [GitLab Issues](https://gitlab.com/gala-games/defi/launchpad/sdk/-/issues)
+- **Documentation**: [Full Documentation](../../packages/sdk/docs/)
+- **SDK Package**: [@gala-chain/launchpad-sdk](https://www.npmjs.com/package/@gala-chain/launchpad-sdk)
+
+---
+
+**Built with ❤️ for the Gala ecosystem**

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Gala Launchpad MCP Server Entry Point
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG"}

package/dist/index.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * Gala Launchpad MCP Server Entry Point
+ */
+import { LaunchpadMCPServer } from './server.js';
+async function main() {
+    const server = new LaunchpadMCPServer();
+    try {
+        await server.start();
+    }
+    catch (error) {
+        console.error('[MCP Server] Fatal error:', error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAExC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Gala Launchpad MCP Server
+ *
+ * Provides MCP tools for AI agents to interact with Gala Launchpad
+ */
+export declare class LaunchpadMCPServer {
+    private server;
+    private sdk;
+    private debug;
+    constructor();
+    /**
+     * Initialize SDK with AgentConfig
+     */
+    initialize(): Promise<void>;
+    /**
+     * Setup tool handlers
+     */
+    private setupToolHandlers;
+    /**
+     * Setup error handlers
+     */
+    private setupErrorHandlers;
+    /**
+     * Start the MCP server
+     */
+    start(): Promise<void>;
+    /**
+     * Cleanup resources
+     */
+    cleanup(): void;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

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

package/dist/server.js

@@ -0,0 +1,151 @@
+/**
+ * Gala Launchpad MCP Server
+ *
+ * Provides MCP tools for AI agents to interact with Gala Launchpad
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListToolsRequestSchema, CallToolRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { AgentConfig } from '@gala-chain/launchpad-sdk';
+import { tools } from './tools/index.js';
+export class LaunchpadMCPServer {
+    server;
+    sdk = null;
+    debug;
+    constructor() {
+        this.debug = process.env.DEBUG === 'true';
+        this.server = new Server({
+            name: '@gala-chain/launchpad-mcp-server',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.setupToolHandlers();
+        this.setupErrorHandlers();
+    }
+    /**
+     * Initialize SDK with AgentConfig
+     */
+    async initialize() {
+        try {
+            if (this.debug) {
+                console.error('[MCP Server] Initializing SDK...');
+            }
+            const { sdk, validation } = await AgentConfig.quickSetup({
+                environment: process.env.ENVIRONMENT || 'development',
+                privateKey: process.env.PRIVATE_KEY,
+                timeout: parseInt(process.env.TIMEOUT || '30000', 10),
+                debug: this.debug,
+                autoValidate: true,
+            });
+            this.sdk = sdk;
+            if (this.debug) {
+                console.error('[MCP Server] SDK initialized successfully');
+                if (validation) {
+                    console.error(`[MCP Server] Validation - Ready: ${validation.ready}`);
+                    console.error(`[MCP Server] Validation - Can Trade: ${validation.capabilities.canTrade}`);
+                }
+            }
+            if (validation && !validation.ready) {
+                console.error('[MCP Server] Warning: SDK not ready', validation.issues);
+            }
+        }
+        catch (error) {
+            console.error('[MCP Server] Failed to initialize SDK:', error);
+            throw error;
+        }
+    }
+    /**
+     * Setup tool handlers
+     */
+    setupToolHandlers() {
+        // Register tools/list handler
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            if (this.debug) {
+                console.error(`[MCP Server] Listing ${tools.length} tools`);
+            }
+            return {
+                tools: tools.map((tool) => ({
+                    name: tool.name,
+                    description: tool.description,
+                    inputSchema: tool.inputSchema,
+                })),
+            };
+        });
+        // Register tools/call handler
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const toolName = request.params.name;
+            const args = request.params.arguments || {};
+            if (this.debug) {
+                console.error(`[MCP Server] Executing tool: ${toolName}`);
+                console.error(`[MCP Server] Arguments:`, JSON.stringify(args, null, 2));
+            }
+            const tool = tools.find((t) => t.name === toolName);
+            if (!tool) {
+                throw new Error(`Tool not found: ${toolName}`);
+            }
+            if (!this.sdk) {
+                throw new Error('SDK not initialized. Please ensure PRIVATE_KEY environment variable is set.');
+            }
+            try {
+                const result = await tool.handler(this.sdk, args);
+                if (this.debug) {
+                    console.error(`[MCP Server] Tool execution successful: ${toolName}`);
+                }
+                return result;
+            }
+            catch (error) {
+                console.error(`[MCP Server] Tool execution failed: ${toolName}`, error);
+                throw error;
+            }
+        });
+    }
+    /**
+     * Setup error handlers
+     */
+    setupErrorHandlers() {
+        this.server.onerror = (error) => {
+            console.error('[MCP Server] Protocol error:', error);
+        };
+        process.on('SIGINT', () => {
+            if (this.debug) {
+                console.error('[MCP Server] Received SIGINT, shutting down...');
+            }
+            this.cleanup();
+            process.exit(0);
+        });
+        process.on('SIGTERM', () => {
+            if (this.debug) {
+                console.error('[MCP Server] Received SIGTERM, shutting down...');
+            }
+            this.cleanup();
+            process.exit(0);
+        });
+    }
+    /**
+     * Start the MCP server
+     */
+    async start() {
+        await this.initialize();
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        if (this.debug) {
+            console.error('[MCP Server] Gala Launchpad MCP server running on stdio');
+            console.error(`[MCP Server] Registered ${tools.length} tools`);
+        }
+    }
+    /**
+     * Cleanup resources
+     */
+    cleanup() {
+        if (this.sdk) {
+            this.sdk.cleanup();
+            if (this.debug) {
+                console.error('[MCP Server] SDK cleaned up');
+            }
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

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

@@ -0,0 +1,12 @@
+/**
+ * Balance & Portfolio Tools
+ */
+import type { MCPTool } from '../../types/mcp.js';
+export declare const fetchGalaBalanceTool: MCPTool;
+export declare const fetchTokenBalanceTool: MCPTool;
+export declare const fetchTokensHeldTool: MCPTool;
+export declare const fetchTokensCreatedTool: MCPTool;
+export declare const fetchProfileTool: MCPTool;
+export declare const updateProfileTool: MCPTool;
+export declare const balanceTools: MCPTool[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/balance/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAKlD,eAAO,MAAM,oBAAoB,EAAE,OAiBlC,CAAC;AAGF,eAAO,MAAM,qBAAqB,EAAE,OA0BnC,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,OAgCjC,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OAgCpC,CAAC;AAGF,eAAO,MAAM,gBAAgB,EAAE,OAiB9B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAgC/B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAAO,EAOjC,CAAC"}

package/dist/tools/balance/index.js

@@ -0,0 +1,182 @@
+/**
+ * Balance & Portfolio Tools
+ */
+import { formatSuccess } from '../../utils/response-formatter.js';
+import { withErrorHandling } from '../../utils/error-handler.js';
+// 1. Fetch GALA Balance
+export const fetchGalaBalanceTool = {
+    name: 'gala_launchpad_fetch_gala_balance',
+    description: 'Get GALA balance for a wallet',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            walletAddress: {
+                type: 'string',
+                pattern: '^(0x[a-fA-F0-9]{40}|eth\\|[a-fA-F0-9]{40})$',
+                description: 'Wallet address (optional, defaults to SDK wallet)',
+            },
+        },
+    },
+    handler: withErrorHandling(async (sdk, args) => {
+        const result = await sdk.fetchGalaBalance(args.walletAddress);
+        return formatSuccess(result);
+    }),
+};
+// 2. Fetch Token Balance
+export const fetchTokenBalanceTool = {
+    name: 'gala_launchpad_fetch_token_balance',
+    description: 'Get launchpad token balance',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenName: {
+                type: 'string',
+                pattern: '^[a-z0-9_-]{2,20}$',
+                description: 'Token name',
+            },
+            walletAddress: {
+                type: 'string',
+                pattern: '^(0x[a-fA-F0-9]{40}|eth\\|[a-fA-F0-9]{40})$',
+                description: 'Wallet address',
+            },
+        },
+        required: ['tokenName', 'walletAddress'],
+    },
+    handler: withErrorHandling(async (sdk, args) => {
+        const result = await sdk.fetchTokenBalance({
+            tokenName: args.tokenName,
+            address: args.walletAddress,
+        });
+        return formatSuccess(result);
+    }),
+};
+// 3. Fetch Tokens Held
+export const fetchTokensHeldTool = {
+    name: 'gala_launchpad_fetch_tokens_held',
+    description: 'Get all tokens held by a wallet',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            address: {
+                type: 'string',
+                pattern: '^(0x[a-fA-F0-9]{40}|eth\\|[a-fA-F0-9]{40})$',
+                description: 'Wallet address',
+            },
+            page: {
+                type: 'number',
+                minimum: 1,
+                description: 'Page number (default: 1)',
+            },
+            limit: {
+                type: 'number',
+                minimum: 1,
+                maximum: 100,
+                description: 'Results per page (default: 20)',
+            },
+        },
+        required: ['address'],
+    },
+    handler: withErrorHandling(async (sdk, args) => {
+        const result = await sdk.fetchTokensHeld({
+            page: args.page || 1,
+            limit: args.limit || 20,
+        });
+        return formatSuccess(result);
+    }),
+};
+// 4. Fetch Tokens Created
+export const fetchTokensCreatedTool = {
+    name: 'gala_launchpad_fetch_tokens_created',
+    description: 'Get all tokens created by a wallet',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            address: {
+                type: 'string',
+                pattern: '^(0x[a-fA-F0-9]{40}|eth\\|[a-fA-F0-9]{40})$',
+                description: 'Wallet address',
+            },
+            page: {
+                type: 'number',
+                minimum: 1,
+                description: 'Page number (default: 1)',
+            },
+            limit: {
+                type: 'number',
+                minimum: 1,
+                maximum: 100,
+                description: 'Results per page (default: 20)',
+            },
+        },
+        required: ['address'],
+    },
+    handler: withErrorHandling(async (sdk, args) => {
+        const result = await sdk.fetchTokensCreated({
+            page: args.page || 1,
+            limit: args.limit || 20,
+        });
+        return formatSuccess(result);
+    }),
+};
+// 5. Fetch Profile
+export const fetchProfileTool = {
+    name: 'gala_launchpad_fetch_profile',
+    description: 'Get user profile data',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            walletAddress: {
+                type: 'string',
+                pattern: '^(0x[a-fA-F0-9]{40}|eth\\|[a-fA-F0-9]{40})$',
+                description: 'Wallet address (optional, defaults to SDK wallet)',
+            },
+        },
+    },
+    handler: withErrorHandling(async (sdk, args) => {
+        const result = await sdk.fetchProfile(args.walletAddress);
+        return formatSuccess(result);
+    }),
+};
+// 6. Update Profile
+export const updateProfileTool = {
+    name: 'gala_launchpad_update_profile',
+    description: 'Update user profile',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            fullName: {
+                type: 'string',
+                maxLength: 50,
+                pattern: '^[a-zA-Z\\s]+$',
+                description: 'Full name',
+            },
+            profileImage: {
+                type: 'string',
+                description: 'Profile image URL or empty string',
+            },
+            walletAddress: {
+                type: 'string',
+                pattern: '^(0x[a-fA-F0-9]{40}|eth\\|[a-fA-F0-9]{40})$',
+                description: 'Wallet address',
+            },
+        },
+        required: ['fullName', 'profileImage', 'walletAddress'],
+    },
+    handler: withErrorHandling(async (sdk, args) => {
+        const result = await sdk.updateProfile({
+            fullName: args.fullName,
+            profileImage: args.profileImage,
+            walletAddress: args.walletAddress,
+        });
+        return formatSuccess(result);
+    }),
+};
+export const balanceTools = [
+    fetchGalaBalanceTool,
+    fetchTokenBalanceTool,
+    fetchTokensHeldTool,
+    fetchTokensCreatedTool,
+    fetchProfileTool,
+    updateProfileTool,
+];
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * Token Creation Tools
+ */
+import type { MCPTool } from '../../types/mcp.js';
+export declare const launchTokenTool: MCPTool;
+export declare const uploadTokenImageTool: MCPTool;
+export declare const uploadProfileImageTool: MCPTool;
+export declare const creationTools: MCPTool[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/creation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAKlD,eAAO,MAAM,eAAe,EAAE,OAgF7B,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,OA+BlC,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OA4BpC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OAAO,EAIlC,CAAC"}