@hyperweb/telescope 2.1.0 → 2.2.0

package/src/generators/create-mcp-server.ts

@@ -1,1774 +0,0 @@
-import { TelescopeBuilder } from '../builder';
-import { Bundler } from '../bundler';
-import { writeFileSync, mkdirSync, cpSync, existsSync } from 'fs';
-import { join, dirname, basename } from 'path';
-
-export const plugin = (
-  builder: TelescopeBuilder,
-  bundler: Bundler
-) => {
-  // Early return if MCP server is not enabled
-  if (!builder.options.mcpServer?.enabled) {
-    return;
-  }
-
-  // Use the output directory name instead of bundle base
-  const outputDirName = basename(builder.outPath);
-  const packageName = outputDirName || bundler.bundle.base;
-  const parentDir = dirname(builder.outPath);
-  const mcpServerPath = join(parentDir, `${packageName}-mcp`);
-
-  // Ensure MCP server directory exists
-  mkdirSync(mcpServerPath, { recursive: true });
-  mkdirSync(join(mcpServerPath, 'src'), { recursive: true });
-  mkdirSync(join(mcpServerPath, 'src', 'prompts'), { recursive: true });
-  mkdirSync(join(mcpServerPath, 'src', `${packageName}-examples`), { recursive: true });
-
-  // Generate package.json for MCP server
-  const packageJson = generateMcpPackageJson(packageName);
-  writeFileSync(
-    join(mcpServerPath, 'package.json'),
-    JSON.stringify(packageJson, null, 2)
-  );
-
-  // Generate main MCP server file
-  const indexContent = `#!/usr/bin/env node
-
-import { readFileSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { z } from 'zod';
-
-// Get package.json version
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const packageJson = JSON.parse(readFileSync(resolve(__dirname, '../package.json'), 'utf8'));
-const VERSION = packageJson.version;
-
-async function main() {
-  const server = new McpServer({
-    name: '${packageName} MCP Server',
-    version: VERSION,
-  });
-
-  // Add prompts for AI agents
-  server.prompt(
-    'codegen-usage',
-    'Guide for using telescope generated code',
-    async () => {
-      const promptPath = resolve(__dirname, 'prompts/codegen-usage.md');
-      const content = readFileSync(promptPath, 'utf-8');
-      return {
-        messages: [{
-          role: 'user',
-          content: {
-            type: 'text',
-            text: content
-          }
-        }]
-      };
-    }
-  );
-
-  server.prompt(
-    'agent-guidelines', 
-    'Guidelines for MCP agents using ${packageName}',
-    async () => {
-      const promptPath = resolve(__dirname, 'prompts/agent-guidelines.md');
-      const content = readFileSync(promptPath, 'utf-8');
-      return {
-        messages: [{
-          role: 'user',
-          content: {
-            type: 'text',  
-            text: content
-          }
-        }]
-      };
-    }
-  );
-
-  // Register blockchain function generator tool
-  server.tool(
-    'use-${packageName}',
-    'Analyzes requests and provides step-by-step implementation guidance for custom blockchain functions using telescope examples as reference',
-    {
-      task: z.string().describe('The blockchain task to implement (e.g., "get balance", "check staking rewards", "query validators")').optional(),
-      chainName: z.string().describe('The blockchain name (e.g., cosmos, osmosis, injective)').optional(),
-      functionType: z.enum(['query', 'transaction', 'react-hook', 'utility']).describe('Type of function to create').optional(),
-      customRequirements: z.string().describe('Any specific requirements or modifications needed').optional()
-    },
-    async (args) => {
-      try {
-        const { task = 'get account balance', chainName = 'cosmos', functionType = 'query', customRequirements } = args;
-        
-        // Read available examples
-        const examplesPath = resolve(__dirname, '${packageName}-examples');
-        let availableExamples: string[] = [];
-        
-        try {
-          const fs = await import('fs');
-          availableExamples = fs.readdirSync(examplesPath)
-            .filter(file => file.endsWith('.ts'))
-            .map(file => file.replace('.ts', ''));
-        } catch (error) {
-          // If examples directory doesn't exist, provide default list
-          availableExamples = [
-            'config-example', 'useBalance', 'useBalanceFunc', 'getBalance',
-            'useAssets', 'useStakingData', 'useValidators', 'useVoting',
-            'useVotingData', 'useContractInfo', 'useQueryContract',
-            'useCodeDetails', 'useMyContracts', 'useGrants', 'useSendData',
-            'useTotalAssets', 'useBalanceReact'
-          ];
-        }
-        
-        const examplesList = availableExamples.map(example => \`- **\${example}.ts**: Reference implementation\`).join('\\n');
-        
-        const relevantExamples = getRelevantExamples(task, availableExamples)
-          .map(example => \`- **\${example}**: \${getExampleDescription(example)}\`)
-          .join('\\n');
-
-        const codeBlockStart = '\`\`\`';
-        const codeBlockEnd = '\`\`\`';
-        
-        const response = [
-          '# Blockchain Function Generator',
-          '',
-          \`## Task: \${task}\`,
-          \`## Chain: \${chainName}\`,
-          \`## Function Type: \${functionType}\`,
-          customRequirements ? \`## Custom Requirements: \${customRequirements}\` : '',
-          '',
-          '## Instructions for Implementation',
-          '',
-          '### Step 1: Review Available Examples',
-          \`The following example files are available in \\\`src/${packageName}-examples/\\\`:\`,
-          '',
-          examplesList,
-          '',
-          '### Step 2: Identify Relevant Examples',
-          \`Based on your task "\${task}", you should primarily reference:\`,
-          '',
-          relevantExamples,
-          '',
-          '### Step 3: Implementation Pattern',
-          '',
-          \`**For Query Functions (\${functionType === 'query' ? 'SELECTED' : 'Available'}):**\`,
-          \`\${codeBlockStart}typescript\`,
-          "import { getBalance } from '${packageName}/cosmos/bank/v1beta1/query.rpc.func';",
-          '',
-          'export const customQueryFunction = async (params: QueryParams) => {',
-          \`  const rpcEndpoint = 'https://\${chainName}-rpc.quickapi.com:443';\`,
-          '  ',
-          '  try {',
-          '    const result = await getBalance(rpcEndpoint, params);',
-          '    return {',
-          '      success: true,',
-          '      data: result,',
-          '    };',
-          '  } catch (error) {',
-          '    return {',
-          '      success: false,',
-          '      error: (error as Error).message,',
-          '    };',
-          '  }',
-          '};',
-          codeBlockEnd,
-          '',
-          \`**For React Hooks (\${functionType === 'react-hook' ? 'SELECTED' : 'Available'}):**\`,
-          \`\${codeBlockStart}typescript\`,
-          "import { useGetBalance } from '${packageName}/cosmos/bank/v1beta1/query.rpc.react';",
-          "import { defaultContext } from '@tanstack/react-query';",
-          '',
-          'export const useCustomHook = (params: HookParams) => {',
-          \`  const rpcEndpoint = 'https://\${chainName}-rpc.quickapi.com:443';\`,
-          '  ',
-          '  return useGetBalance({',
-          '    request: params,',
-          '    options: {',
-          '      enabled: !!params.address,',
-          '      context: defaultContext,',
-          '    },',
-          '    clientResolver: rpcEndpoint,',
-          '  });',
-          '};',
-          codeBlockEnd,
-          '',
-          '### Step 4: Configuration Setup',
-          'Always include proper chain configuration. Reference \`config-example.ts\`:',
-          '',
-          \`\${codeBlockStart}typescript\`,
-          'import { assetLists, chains } from "@chain-registry/v2";',
-          '',
-          \`export const targetChainName = '\${chainName}';\`,
-          \`export const rpcEndpoint = 'https://\${chainName}-rpc.quickapi.com:443';\`,
-          'export const chain = chains.find((chain) => chain.chainName === targetChainName);',
-          'export const assetList = assetLists.find((assetList) => assetList.chainName === targetChainName);',
-          codeBlockEnd,
-          '',
-          '### Step 5: Error Handling & Best Practices',
-          '- Always wrap async calls in try-catch blocks',
-          '- Validate input parameters before making requests',
-          '- Handle network timeouts and connection errors',
-          '- Convert base units to human-readable amounts (uatom → ATOM)',
-          '- Include proper TypeScript types',
-          '',
-          '### Step 6: Testing Your Function',
-          \`\${codeBlockStart}typescript\`,
-          '// Example usage',
-          'const result = await customQueryFunction({',
-          "  address: 'cosmos1...',",
-          "  denom: 'uatom'",
-          '});',
-          '',
-          'if (result.success) {',
-          "  console.log('Result:', result.data);",
-          '} else {',
-          "  console.error('Error:', result.error);",
-          '}',
-          codeBlockEnd,
-          '',
-          '## Additional Resources',
-          '',
-          \`- **Full codebase reference**: \\\`src/${packageName}/\\\` directory contains all generated types and functions\`,
-          \`- **Configuration examples**: \\\`src/${packageName}-examples/config-example.ts\\\`\`,
-          '- **Chain registry data**: \`src/prompts/chains.json\`',
-          '- **Usage guidelines**: Use the \`codegen-usage\` and \`agent-guidelines\` prompts for detailed instructions',
-          '',
-          '## Next Steps',
-          '',
-          '1. Review the suggested example files above',
-          '2. Copy and modify the relevant pattern for your use case',
-          '3. Test your implementation with proper error handling',
-          '4. Ensure proper TypeScript types are used',
-          '',
-          \`The examples in \\\`${packageName}-examples/\\\` are production-ready patterns that you can adapt for any blockchain task.\`
-        ].filter(line => line !== '').join('\\n');
-
-        return {
-          content: [{
-            type: "text",
-            text: response
-          }]
-        };
-        
-      } catch (error) {
-        return {
-          content: [{
-            type: "text", 
-            text: \`Error generating blockchain function guidance: \${(error as Error).message}\`
-          }]
-        };
-      }
-    }
-  );
-
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.log('${packageName} MCP server started on stdio');
-}
-
-// Helper functions for example recommendations
-function getRelevantExamples(task: string, availableExamples: string[]): string[] {
-  const taskLower = task.toLowerCase();
-  const relevantExamples: string[] = [];
-  
-  // Balance-related tasks
-  if (taskLower.includes('balance')) {
-    relevantExamples.push('useBalance', 'useBalanceFunc', 'getBalance');
-    if (taskLower.includes('react')) {
-      relevantExamples.push('useBalanceReact');
-    }
-  }
-  
-  // Staking-related tasks  
-  if (taskLower.includes('staking') || taskLower.includes('delegate') || taskLower.includes('validator')) {
-    relevantExamples.push('useStakingData', 'useValidators');
-  }
-  
-  // Governance/voting tasks
-  if (taskLower.includes('voting') || taskLower.includes('proposal') || taskLower.includes('governance')) {
-    relevantExamples.push('useVoting', 'useVotingData');
-  }
-  
-  // Assets/portfolio tasks
-  if (taskLower.includes('asset') || taskLower.includes('portfolio') || taskLower.includes('total')) {
-    relevantExamples.push('useAssets', 'useTotalAssets');
-  }
-  
-  // Contract-related tasks
-  if (taskLower.includes('contract') || taskLower.includes('cosmwasm')) {
-    relevantExamples.push('useContractInfo', 'useQueryContract', 'useCodeDetails', 'useMyContracts');
-  }
-  
-  // Transaction/sending tasks
-  if (taskLower.includes('send') || taskLower.includes('transaction') || taskLower.includes('transfer')) {
-    relevantExamples.push('useSendData', 'getBalance');
-  }
-  
-  // Authorization tasks
-  if (taskLower.includes('grant') || taskLower.includes('authorization') || taskLower.includes('authz')) {
-    relevantExamples.push('useGrants');
-  }
-  
-  // Always include config as it's fundamental
-  relevantExamples.unshift('config-example');
-  
-  // Remove duplicates and ensure examples exist
-  return [...new Set(relevantExamples)].filter(example => 
-    availableExamples.includes(example)
-  );
-}
-
-function getExampleDescription(example: string): string {
-  const descriptions: Record<string, string> = {
-    'config-example': 'Chain configuration and RPC endpoints setup',
-    'useBalance': 'React hook for querying account balance',
-    'useBalanceFunc': 'Direct function for balance queries',
-    'useBalanceReact': 'React hook with BigNumber for balance queries',
-    'getBalance': 'Basic balance query with transaction examples',
-    'useAssets': 'Query all token balances for an account',
-    'useStakingData': 'Comprehensive staking information (delegations, rewards, validators)',
-    'useValidators': 'Query active validators with sorting',
-    'useVoting': 'Active governance proposals in voting period',
-    'useVotingData': 'All governance proposals with categorization',
-    'useContractInfo': 'Smart contract information queries',
-    'useQueryContract': 'Execute smart contract queries',
-    'useCodeDetails': 'Contract code information and metadata',
-    'useMyContracts': 'Contracts created by specific address',
-    'useGrants': 'Authorization grants (granter/grantee)',
-    'useSendData': 'Prepare transaction data for token transfers',
-    'useTotalAssets': 'Portfolio summary with total asset calculations'
-  };
-  
-  return descriptions[example] || 'Blockchain utility function';
-}
-
-main().catch((error) => {
-  console.error('Fatal error in main()', error);
-  process.exit(1);
-});
-`;
-
-  writeFileSync(
-    join(mcpServerPath, 'src', 'index.ts'),
-    indexContent
-  );
-
-
-
-  // Generate TypeScript configuration
-  const tsConfig = generateTsConfig(packageName);
-  writeFileSync(
-    join(mcpServerPath, 'tsconfig.json'),
-    JSON.stringify(tsConfig, null, 2)
-  );
-
-  // Generate README
-  const readme = generateReadme(packageName);
-  writeFileSync(
-    join(mcpServerPath, 'README.md'),
-    readme
-  );
-
-  // Generate comprehensive prompts and guidelines
-  generateComprehensivePrompts(mcpServerPath, packageName);
-
-  // Generate telescope examples
-  generateTelescopeExamples(mcpServerPath, packageName);
-
-  // Copy entire telescope generated codebase for AI reference (excluded from build)
-  copyTelescopeCodebase(builder, mcpServerPath, packageName);
-};
-
-function generateMcpPackageJson(packageName: string) {
-
-  return {
-    name: `${packageName}-mcp`,
-    version: "0.1.0",
-    description: `MCP server for ${packageName} blockchain interactions`,
-    main: "dist/index.js",
-    type: "module",
-    bin: {
-      [`${packageName}-mcp-server`]: "./dist/index.js"
-    },
-    scripts: {
-      build: "rimraf dist && tsc",
-      clean: "rimraf dist",
-      test: "vitest",
-      inspector: "npm run build && npm exec @modelcontextprotocol/inspector node dist/index.js",
-      format: "biome check --write",
-      lint: "biome check"
-    },
-    dependencies: {
-      "@modelcontextprotocol/sdk": "^1.7.0",
-      "zod": "^3.24.2"
-    },
-    devDependencies: {
-      "@biomejs/biome": "1.9.4",
-      "@types/node": "^22.13.10",
-      "rimraf": "^6.0.1",
-      "typescript": "^5.8.2",
-      "vitest": "^3.1.1"
-    },
-    files: ["dist"],
-    publishConfig: {
-      access: "public"
-    }
-  };
-}
-
-
-function generateTsConfig(packageName: string) {
-  return {
-    compilerOptions: {
-      target: "ES2022",
-      module: "ESNext",
-      moduleResolution: "node",
-      outDir: "./dist",
-      rootDir: "./src",
-      strict: true,
-      esModuleInterop: true,
-      skipLibCheck: true,
-      forceConsistentCasingInFileNames: true,
-      declaration: true,
-      declarationMap: true,
-      sourceMap: true,
-      allowSyntheticDefaultImports: true,
-      resolveJsonModule: true
-    },
-    include: ["src/**/*"],
-    exclude: ["node_modules", "dist", `src/${packageName}/**/*`, `src/${packageName}-examples/**/*`]
-  };
-}
-
-function generateReadme(packageName: string) {
-
-  return `# ${packageName.charAt(0).toUpperCase() + packageName.slice(1)} MCP Server
-
-This MCP server provides AI agents with the \`use-${packageName}\` tool to create custom blockchain functions using telescope examples as reference.
-
-## Installation
-
-\`\`\`bash
-cd ${packageName}-mcp
-npm install
-npm run build
-\`\`\`
-
-## Usage with AI Agents
-
-Add this configuration to your AI agent's MCP settings:
-
-\`\`\`json
-{
-  "mcpServers": {
-    "${packageName}-mcp-server": {
-      "command": "node",
-      "args": ["/path/to/${packageName}-mcp/dist/index.js"]
-    }
-  }
-}
-\`\`\`
-
-## Available Features
-
-This MCP server provides:
-
-- **Function Generator Tool**: Single tool (\`use-${packageName}\`) that analyzes requests and provides step-by-step implementation guidance
-- **Telescope Codebase Reference**: Complete telescope-generated code in \`src/${packageName}/\` as primary reference
-- **Production Examples**: Reference implementations in \`src/${packageName}-examples/\` showing real-world patterns
-- **AI Guidance**: Contextual prompts to help agents understand blockchain development patterns
-
-## How It Works
-
-The function generator tool:
-
-1. **Analyzes your request** (task, chain, function type, custom requirements)
-2. **Finds relevant examples** from \`${packageName}-examples/\` directory
-3. **Provides implementation patterns** using \`${packageName}/\` codebase as primary reference
-4. **Shows proper imports** and configuration with error handling
-
-## Development
-
-\`\`\`bash
-npm run build      # Build the server
-npm run inspector  # Run MCP inspector for testing
-npm run clean      # Clean dist directory
-\`\`\`
-
-## Extending Examples
-
-You can enhance the AI agent's knowledge by adding more examples to the \`${packageName}-examples/\` directory. The function generator automatically scans this directory, so new examples are immediately available for reference.
-
-## Directory Structure
-
-\`\`\`
-${packageName}-mcp/
-├── src/
-│   ├── ${packageName}/     # 📚 Telescope generated code (primary reference, excluded from build)
-│   │   ├── cosmos/         # Full cosmos SDK modules 
-│   │   │   ├── bank/       # Balance queries, transfers
-│   │   │   ├── staking/    # Validator operations
-│   │   │   └── ...         # Other cosmos modules
-│   │   ├── osmosis/        # Osmosis DEX functionality
-│   │   ├── ibc/            # Inter-blockchain communication
-│   │   └── index.ts        # Main exports
-│   ├── ${packageName}-examples/ # 📖 Production examples (excluded from build)
-│   │   ├── config-example.ts      # Chain configuration setup
-│   │   ├── useBalance.ts          # Balance query React hooks
-│   │   ├── useBalanceFunc.ts      # Direct balance functions
-│   │   ├── getBalance.ts          # Balance queries with examples
-│   │   ├── useAssets.ts           # Multi-token balance queries
-│   │   ├── useStakingData.ts      # Staking and delegation info
-│   │   ├── useValidators.ts       # Validator queries
-│   │   ├── useVoting.ts           # Governance proposals
-│   │   ├── useContractInfo.ts     # Smart contract queries
-│   │   ├── useMyContracts.ts      # User's contract list
-│   │   ├── useGrants.ts           # Authorization grants
-│   │   └── useSendData.ts         # Transaction preparation
-│   ├── prompts/            # 🤖 Agent instruction files
-│   │   ├── codegen-usage.md       # Implementation guide for agents
-│   │   ├── agent-guidelines.md    # Best practices for agents
-│   │   └── chains.json            # Chain registry data
-│   └── index.ts            # MCP server with function generator tool
-├── dist/                   # Compiled JavaScript (excludes ${packageName}/ and ${packageName}-examples/)
-└── package.json
-\`\`\`
-
-**Key Points:**
-- \`src/${packageName}/\` contains the complete telescope-generated codebase as the **primary reference**
-- \`src/${packageName}-examples/\` contains **production examples** for patterns and logic reference
-- Both directories are excluded from TypeScript build but available for AI agents to read
-- Examples may contain compilation errors - focus on logic and patterns, not direct copying
-
-Generated by [Telescope](https://github.com/hyperweb-io/telescope) 🔭
-`;
-}
-
-function copyTelescopeCodebase(builder: TelescopeBuilder, mcpServerPath: string, packageName: string) {
-  const sourcePath = builder.outPath;
-  const destPath = join(mcpServerPath, 'src', packageName);
-
-  // Copy the entire telescope generated directory
-  if (existsSync(sourcePath)) {
-    // Skip copy if destination already exists (avoids Windows file permission issues)
-    if (existsSync(destPath)) {
-      console.log(`Telescope codebase already exists at ${destPath}, skipping copy to avoid Windows file permission issues`);
-      return;
-    }
-
-    console.log(`Copying telescope codebase from ${sourcePath} to ${destPath}`);
-
-    // Ensure parent directory exists
-    mkdirSync(dirname(destPath), { recursive: true });
-
-    // Copy without removing destination first
-    try {
-      cpSync(sourcePath, destPath, { recursive: true, force: true });
-    } catch (error) {
-      console.warn(`Warning: Could not copy telescope codebase: ${error}`);
-      console.log('MCP server will still function, but AI agents will have limited code references');
-      // Don't throw error - let MCP server generation continue
-    }
-  } else {
-    console.warn(`Source path ${sourcePath} does not exist, skipping telescope codebase copy`);
-  }
-}
-
-// Removed retry logic - no longer needed since we skip copy if destination exists
-
-
-
-function generateComprehensivePrompts(mcpServerPath: string, packageName: string) {
-  // Generate codegen-usage.md with our updated content
-  const codegenUsageContent = `# Codegen Usage Guide
-
-## Overview
-This guide provides instructions for MCP agents on how to use the telescope generated code when implementing the \`use-${packageName}\` tool.
-
-## Understanding the Structure
-
-### Primary Reference: \`src/${packageName}/\` Directory
-This is your **main reference** for understanding the complete telescope-generated codebase. It contains:
-
-- **Complete type definitions** for all blockchain modules
-- **Client implementations** for queries and transactions  
-- **Generated interfaces** from protobuf definitions
-- **All available methods** and their signatures
-
-**Key files to understand**:
-- \`src/${packageName}/index.ts\` - Main exports and available modules
-- \`src/${packageName}/cosmos/\` - Cosmos SDK modules (bank, staking, gov, etc.)
-- \`src/${packageName}/osmosis/\` - Osmosis-specific modules
-- \`src/${packageName}/ibc/\` - Inter-blockchain communication
-- \`src/${packageName}/README.md\` - Comprehensive documentation
-
-### Production Examples: \`src/${packageName}-examples/\` Directory  
-Use these as **implementation patterns** and **logic reference**:
-
-- **Real production code** showing how to use telescope functions
-- **Best practices** for error handling and data processing
-- **Complete workflows** for common blockchain operations
-
-**⚠️ Important**: These examples may contain import/compilation errors since they reference the main codebase. **Focus on the logic and patterns** rather than copying code directly.
-
-## Using the MCP Tool
-
-### Single Tool: \`use-${packageName}\`
-This MCP server provides one tool that generates implementation guidance by:
-
-1. **Analyzing your request** (task, chain, function type)
-2. **Finding relevant examples** from \`${packageName}-examples/\`
-3. **Providing step-by-step guidance** using telescope patterns
-4. **Showing proper imports** and configuration
-
-## Implementation Approach
-
-### Step 1: Understand Telescope Structure
-When implementing a function, first explore \`src/${packageName}/\` to understand:
-
-\`\`\`typescript
-// Example: For balance queries, look at:
-// src/${packageName}/cosmos/bank/v1beta1/query.ts - Type definitions
-// src/${packageName}/cosmos/bank/v1beta1/query.rpc.Query.ts - Query client
-// src/${packageName}/cosmos/bank/v1beta1/query.rpc.func.ts - Direct functions
-// src/${packageName}/cosmos/bank/v1beta1/query.rpc.react.ts - React hooks
-\`\`\`
-
-### Step 2: Reference Production Examples
-Look at \`${packageName}-examples/\` for implementation patterns:
-
-\`\`\`typescript
-// Example: useBalance.ts shows the pattern for:
-// - Proper imports from telescope
-// - Error handling approaches  
-// - Data transformation logic
-// - Integration with React Query
-
-// Focus on UNDERSTANDING the logic:
-// - How RPC endpoints are configured
-// - How parameters are validated
-// - How responses are processed
-// - How errors are handled
-\`\`\`
-
-### Step 3: Generate Your Implementation
-Use the patterns from both directories to create your function:
-
-\`\`\`typescript
-// Your implementation should:
-// 1. Use proper imports from the telescope codebase
-// 2. Follow error handling patterns from examples
-// 3. Include proper TypeScript types
-// 4. Handle edge cases shown in examples
-\`\`\`
-
-## Category of Functions in Telescope
-
-### 1. **query.rpc.func.ts** - Direct Function Calls
-- Server-side operations
-- Node.js scripts  
-- Direct blockchain queries
-
-### 2. **query.rpc.react.ts** - React Hooks
-- Frontend applications
-- Automatic caching and refetching
-- Loading states and error handling
-
-### 3. **tx.rpc.func.ts** - Transaction Functions
-- Broadcasting transactions
-- Message composition
-
-### 4. **tx.rpc.react.ts** - Transaction Hooks
-- Transaction broadcasting in React
-- Transaction state management
-
-## Chain Configuration Pattern
-
-Always reference \`config-example.ts\` for proper setup:
-
-\`\`\`typescript
-import { assetLists, chains } from "@chain-registry/v2";
-
-export const targetChainName = 'cosmos';
-export const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-export const chain = chains.find((chain) => chain.chainName === targetChainName);
-export const assetList = assetLists.find((assetList) => assetList.chainName === targetChainName);
-\`\`\`
-
-## Important Guidelines
-
-### When Using Examples
-- **Study the logic**, don't copy/paste directly
-- **Understand the patterns** for imports and usage
-- **Learn from error handling** approaches
-- **Adapt the structure** to your specific needs
-
-### When Using Telescope Codebase
-- **Browse the generated files** to understand available methods
-- **Check type definitions** for proper parameter structures
-- **Look at client implementations** for usage patterns
-- **Reference documentation** in README.md files
-
-### Best Practices
-1. Always include comprehensive error handling
-2. Validate input parameters before making calls
-3. Convert base units to human-readable amounts when needed
-4. Use proper TypeScript types from telescope
-5. Test your implementations thoroughly
-`;
-
-  writeFileSync(join(mcpServerPath, 'src', 'prompts', 'codegen-usage.md'), codegenUsageContent);
-
-  // Generate agent-guidelines.md
-  const agentGuidelinesContent = `# MCP Agent Guidelines
-
-## Overview
-These guidelines help MCP agents provide helpful, accurate, and safe blockchain interactions using the ${packageName} library.
-
-## General Principles
-
-### 1. Safety First
-- **Never expose private keys or mnemonics**
-- **Always validate addresses before operations**
-- **Warn users about irreversible operations**
-- **Explain risks (slashing, unbonding periods, etc.)**
-
-### 2. User-Friendly Communication
-- **Convert base units to human-readable amounts** (uatom → ATOM)
-- **Use clear, non-technical language when possible**
-- **Provide context for blockchain-specific concepts**
-- **Show approximate USD values when helpful**
-
-### 3. Accuracy and Reliability
-- **Always handle errors gracefully**
-- **Provide accurate information about fees and timing**
-- **Double-check calculations and conversions**
-- **Verify data freshness and warn about stale data**
-
-## Response Patterns
-
-### When User Asks About Balances
-\`\`\`
-✅ Good Response:
-"You have 12.5 ATOM (12,500,000 uatom) in your wallet. This is worth approximately $150 USD at current prices. You also have 0.05 ATOM available to pay for transaction fees."
-
-❌ Poor Response:
-"Balance: 12500000"
-\`\`\`
-
-## Data Formatting Guidelines
-
-### Amounts
-Always convert from base units:
-\`\`\`typescript
-// Good
-const atomAmount = parseInt(balance.amount) / 1_000_000;
-return \`$\{atomAmount} ATOM\`;
-
-// Bad
-return \`$\{balance.amount} uatom\`;
-\`\`\`
-
-### Addresses
-Abbreviate long addresses for readability:
-\`\`\`typescript
-const formatAddress = (addr: string) => {
-  return \`$\{addr.slice(0, 10)}...$\{addr.slice(-4)}\`;
-};
-// cosmos1abc123...xyz9
-\`\`\`
-
-## Security Guidelines
-
-### Address Validation
-\`\`\`typescript
-const validateCosmosAddress = (address: string): boolean => {
-  return address.startsWith('cosmos1') && address.length === 45;
-};
-\`\`\`
-
-### Amount Validation
-\`\`\`typescript
-const validateAmount = (amount: string): boolean => {
-  const num = parseFloat(amount);
-  return !isNaN(num) && num > 0 && num < 1e15; // Reasonable limits
-};
-\`\`\`
-`;
-
-  writeFileSync(join(mcpServerPath, 'src', 'prompts', 'agent-guidelines.md'), agentGuidelinesContent);
-
-  // Copy chains.json from chain-registry (this is a large static file)
-  const chainsJsonContent = `[
-  {
-    "$schema": "../chain.schema.json",
-    "chainName": "cosmos",
-    "status": "live",
-    "networkType": "mainnet",
-    "prettyName": "Cosmos Hub",
-    "chainId": "cosmoshub-4",
-    "bech32Prefix": "cosmos",
-    "daemonName": "gaiad",
-    "nodeHome": "$HOME/.gaia",
-    "slip44": 118,
-    "apis": {
-      "rpc": [
-        {
-          "address": "https://cosmos-rpc.quickapi.com:443"
-        }
-      ],
-      "rest": [
-        {
-          "address": "https://cosmos-rest.quickapi.com:443"
-        }
-      ]
-    }
-  },
-  {
-    "chainName": "osmosis",
-    "status": "live",
-    "networkType": "mainnet",
-    "prettyName": "Osmosis",
-    "chainId": "osmosis-1",
-    "bech32Prefix": "osmo",
-    "daemonName": "osmosisd",
-    "nodeHome": "$HOME/.osmosisd",
-    "slip44": 118,
-    "apis": {
-      "rpc": [
-        {
-          "address": "https://osmosis-rpc.quickapi.com:443"
-        }
-      ],
-      "rest": [
-        {
-          "address": "https://osmosis-rest.quickapi.com:443"
-        }
-      ]
-    }
-  },
-  {
-    "chainName": "injective",
-    "status": "live",
-    "networkType": "mainnet",
-    "prettyName": "Injective",
-    "chainId": "injective-1",
-    "bech32Prefix": "inj",
-    "daemonName": "injectived",
-    "nodeHome": "$HOME/.injectived",
-    "slip44": 60,
-    "apis": {
-      "rpc": [
-        {
-          "address": "https://injective-rpc.quickapi.com:443"
-        }
-      ],
-      "rest": [
-        {
-          "address": "https://injective-rest.quickapi.com:443"
-        }
-      ]
-    }
-  }
-]`;
-
-  writeFileSync(join(mcpServerPath, 'src', 'prompts', 'chains.json'), chainsJsonContent);
-}
-
-function generateTelescopeExamples(mcpServerPath: string, packageName: string) {
-  const exampleFiles = [
-    {
-      name: 'config-example.ts',
-      content: `import { assetLists, chains } from "@chain-registry/v2";
-
-/**
- * Chain configuration example
- * mainnet: 'cosmos'
- * testnet: 'cosmoshub-testnet' 
- * mainnet rpc: 'https://cosmos-rpc.quickapi.com:443'
- * testnet rpc: 'https://rpc.testnet.cosmos.network:443'
- */
-export const targetChainName = 'cosmos';
-export const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-export const chain = chains.find((chain) => chain.chainName === targetChainName);
-export const assetList = assetLists.find((assetList) => assetList.chainName === targetChainName);
-`
-    },
-    {
-      name: 'useBalance.ts',
-      content: `import { useChain } from '@interchain-kit/react';
-import { defaultContext } from '@tanstack/react-query';
-import { useGetBalance } from '${packageName}/cosmos/bank/v1beta1/query.rpc.react';
-
-export const useBalance = (
-  chainName: string,
-  enabled: boolean = true,
-  displayDenom?: string
-) => {
-  const { address, assetList } = useChain(chainName);
-
-  let denom = assetList?.assets[0].base!;
-  for (const asset of assetList?.assets || []) {
-    if (asset.display.toLowerCase() === displayDenom?.toLowerCase()) {
-      denom = asset.base;
-      break;
-    }
-  }
-
-  const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443'; // Use dynamic endpoint
-
-  const isReady = !!address && !!rpcEndpoint;
-
-  const balanceQuery = useGetBalance({
-    request: {
-      denom,
-      address: address || '',
-    },
-    options: {
-      enabled: isReady && enabled,
-      select: ({ balance }) => balance,
-      context: defaultContext,
-    },
-    clientResolver: rpcEndpoint,
-    customizedQueryKey: ['balance', address, denom],
-  });
-
-  return {
-    balance: balanceQuery.data,
-    isLoading: balanceQuery.isFetching,
-  };
-};
-`
-    },
-    {
-      name: 'useBalanceReact.ts',
-      content: `import { useGetBalance } from '${packageName}/cosmos/bank/v1beta1/query.rpc.react';
-import { defaultRpcEndpoint as rpcEndpoint } from '@/config';
-import BigNumber from 'bignumber.js';
-import { defaultAssetList } from '@/config';
-import { defaultContext } from '@tanstack/react-query';
-
-export default function useBalance({ address }: { address: string }) {
-  const coin = defaultAssetList?.assets[0];
-
-  const denom = coin!.base!;
-
-  const COIN_DISPLAY_EXPONENT = coin!.denomUnits.find(
-    (unit) => unit.denom === coin!.display
-  )?.exponent as number;
-
-  const {
-    data: balance,
-    isSuccess: isBalanceLoaded,
-    isLoading: isFetchingBalance,
-    refetch: refetchBalance,
-  } = useGetBalance({
-    request: {
-      address: address || '',
-      denom,
-    },
-    options: {
-      context: defaultContext,
-      enabled: !!address,
-      select: ({ balance }) =>
-        new BigNumber(balance?.amount ?? 0).multipliedBy(
-          10 ** -COIN_DISPLAY_EXPONENT
-        ),
-      staleTime: 0,
-    },
-    clientResolver: rpcEndpoint,
-  });
-
-  return {
-    balance,
-    isBalanceLoaded,
-    isFetchingBalance,
-    refetchBalance,
-  };
-}
-`
-    },
-    {
-      name: 'useBalanceFunc.ts',
-      content: `import { getBalance } from '${packageName}/cosmos/bank/v1beta1/query.rpc.func';
-import { defaultRpcEndpoint } from '@/config';
-
-export const useBalanceFunc = async (address: string, denom: string) => {
-  try {
-    const { balance } = await getBalance(defaultRpcEndpoint, {
-      address,
-      denom,
-    });
-
-    return {
-      balance: balance?.amount || '0',
-      denom: balance?.denom || denom,
-    };
-  } catch (error) {
-    console.error('Error fetching balance:', error);
-    return {
-      balance: '0',
-      denom,
-    };
-  }
-};
-`
-    },
-    {
-      name: 'getBalance.ts',
-      content: `import { getBalance } from '${packageName}/cosmos/bank/v1beta1/query.rpc.func';
-import { send } from '${packageName}/cosmos/bank/v1beta1/tx.rpc.func';
-import { MsgSend } from '${packageName}/cosmos/bank/v1beta1/tx';
-
-const main = async () => {
-  const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-  const denom = 'uatom';
-  const address = 'cosmos1...'; // Your address here
-
-  // Query balance
-  const { balance } = await getBalance(rpcEndpoint, {
-    address,
-    denom,
-  });
-
-  console.log(\`Balance: \${balance?.amount} \${denom}\`);
-
-  // Example: Send transaction (requires signer setup)
-  /*
-  const fee = {
-    amount: [{ denom, amount: '5000' }],
-    gas: '200000',
-  };
-
-  const token = {
-    amount: '1000000',
-    denom,
-  };
-
-  const msg = MsgSend.fromPartial({
-    fromAddress: address,
-    toAddress: 'cosmos1recipient...',
-    amount: [token],
-  });
-
-  // const tx = await send(signer, address, msg, fee, 'Payment');
-  */
-};
-
-main().catch(console.error);
-`
-    },
-    {
-      name: 'useAssets.ts',
-      content: `import { useMemo } from 'react';
-import { useChain } from '@interchain-kit/react';
-import { defaultContext } from '@tanstack/react-query';
-import BigNumber from 'bignumber.js';
-import { useGetAllBalances } from '${packageName}/cosmos/bank/v1beta1/query.rpc.react';
-import { Coin } from '${packageName}/types';
-
-export const useAssets = (chainName: string) => {
-  const { address } = useChain(chainName);
-  const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-
-  const isReady = !!address && !!rpcEndpoint;
-
-  const allBalancesQuery = useGetAllBalances({
-    request: {
-      address: address || '',
-      pagination: {
-        key: new Uint8Array(),
-        offset: 0n,
-        limit: 100n,
-        countTotal: true,
-        reverse: false,
-      },
-      resolveDenom: false,
-    },
-    options: {
-      enabled: isReady,
-      select: ({ balances }) => balances || [],
-      context: defaultContext,
-    },
-    clientResolver: rpcEndpoint,
-    customizedQueryKey: ['allBalances', address],
-  });
-
-  const data = useMemo(() => {
-    if (!allBalancesQuery.data) return;
-
-    const assets = allBalancesQuery.data.map(({ amount, denom }) => ({
-      symbol: denom.toUpperCase(),
-      displayAmount: new BigNumber(amount).dividedBy(1e6).toString(),
-      amount,
-      denom,
-    }));
-
-    return { assets };
-  }, [allBalancesQuery.data]);
-
-  return { 
-    data, 
-    isLoading: allBalancesQuery.isLoading,
-    refetch: allBalancesQuery.refetch 
-  };
-};
-`
-    },
-    {
-      name: 'useStakingData.ts',
-      content: `import { useMemo } from 'react';
-import { useChain } from '@interchain-kit/react';
-import BigNumber from 'bignumber.js';
-import {
-  BondStatus,
-  bondStatusToJSON,
-} from '${packageName}/cosmos/staking/v1beta1/staking';
-import { useGetBalance } from '${packageName}/cosmos/bank/v1beta1/query.rpc.react';
-import {
-  useGetDelegatorValidators,
-  useGetDelegatorDelegations,
-  useGetValidators,
-  useGetParams as useStakingParams,
-  useGetPool,
-} from '${packageName}/cosmos/staking/v1beta1/query.rpc.react';
-import {
-  useGetDelegationTotalRewards,
-  useGetParams as useDistributionParams,
-} from '${packageName}/cosmos/distribution/v1beta1/query.rpc.react';
-import { useGetAnnualProvisions } from '${packageName}/cosmos/mint/v1beta1/query.rpc.react';
-import { defaultContext } from '@tanstack/react-query';
-
-export const useStakingData = (chainName: string) => {
-  const { address, assetList } = useChain(chainName);
-  const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-
-  const coin = assetList?.assets[0];
-  const denom = coin?.base || 'uatom';
-
-  const isDataQueryEnabled = !!address && !!rpcEndpoint;
-
-  const balanceQuery = useGetBalance({
-    request: {
-      address: address || '',
-      denom,
-    },
-    options: {
-      context: defaultContext,
-      enabled: isDataQueryEnabled,
-      select: ({ balance }) => balance?.amount || '0',
-      refetchOnMount: 'always',
-    },
-    clientResolver: rpcEndpoint,
-  });
-
-  const validatorsQuery = useGetValidators({
-    request: {
-      status: bondStatusToJSON(BondStatus.BOND_STATUS_BONDED),
-      pagination: {
-        key: new Uint8Array(),
-        offset: 0n,
-        limit: 200n,
-        countTotal: true,
-        reverse: false,
-      },
-    },
-    options: {
-      context: defaultContext,
-      enabled: isDataQueryEnabled,
-      select: ({ validators }) => {
-        return validators.sort((a, b) =>
-          new BigNumber(b.tokens).minus(a.tokens).toNumber(),
-        );
-      },
-    },
-    clientResolver: rpcEndpoint,
-    customizedQueryKey: ['validators', chainName],
-  });
-
-  const delegationsQuery = useGetDelegatorDelegations({
-    request: {
-      delegatorAddr: address || '',
-      pagination: {
-        key: new Uint8Array(),
-        offset: 0n,
-        limit: 100n,
-        countTotal: true,
-        reverse: false,
-      },
-    },
-    options: {
-      context: defaultContext,
-      enabled: isDataQueryEnabled,
-      select: ({ delegationResponses }) => delegationResponses,
-    },
-    clientResolver: rpcEndpoint,
-  });
-
-  const rewardsQuery = useGetDelegationTotalRewards({
-    request: {
-      delegatorAddress: address || '',
-    },
-    options: {
-      context: defaultContext,
-      enabled: isDataQueryEnabled,
-      select: (data) => data,
-    },
-    clientResolver: rpcEndpoint,
-  });
-
-  const allQueries = {
-    balance: balanceQuery,
-    validators: validatorsQuery,
-    delegations: delegationsQuery,
-    rewards: rewardsQuery,
-  };
-
-  const isLoading = Object.values(allQueries).some(
-    ({ isLoading }) => isLoading,
-  );
-
-  const data = useMemo(() => {
-    if (isLoading) return;
-
-    return {
-      balance: balanceQuery.data,
-      validators: validatorsQuery.data,
-      delegations: delegationsQuery.data,
-      rewards: rewardsQuery.data,
-    };
-  }, [isLoading, balanceQuery.data, validatorsQuery.data, delegationsQuery.data, rewardsQuery.data]);
-
-  const refetch = () => {
-    Object.values(allQueries).forEach((query) => query.refetch());
-  };
-
-  return { data, isLoading, refetch };
-};
-`
-    },
-    {
-      name: 'useValidators.ts',
-      content: `import { useMemo } from 'react';
-import { BondStatus, bondStatusToJSON } from '${packageName}/cosmos/staking/v1beta1/staking';
-import { useGetValidators } from '${packageName}/cosmos/staking/v1beta1/query.rpc.react';
-import { defaultContext } from '@tanstack/react-query';
-import BigNumber from 'bignumber.js';
-
-export const useValidators = (chainName: string) => {
-  const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-
-  const validatorsQuery = useGetValidators({
-    request: {
-      status: bondStatusToJSON(BondStatus.BOND_STATUS_BONDED),
-      pagination: {
-        key: new Uint8Array(),
-        offset: 0n,
-        limit: 200n,
-        countTotal: true,
-        reverse: false,
-      },
-    },
-    options: {
-      context: defaultContext,
-      enabled: !!rpcEndpoint,
-      select: ({ validators }) => {
-        return validators
-          .sort((a, b) => new BigNumber(b.tokens).minus(a.tokens).toNumber())
-          .map((validator) => ({
-            operatorAddress: validator.operatorAddress,
-            moniker: validator.description?.moniker || '',
-            tokens: validator.tokens,
-            delegatorShares: validator.delegatorShares,
-            commission: validator.commission?.commissionRates?.rate || '0',
-            status: validator.status,
-            jailed: validator.jailed,
-          }));
-      },
-    },
-    clientResolver: rpcEndpoint,
-    customizedQueryKey: ['validators', chainName],
-  });
-
-  return {
-    data: validatorsQuery.data,
-    isLoading: validatorsQuery.isLoading,
-    refetch: validatorsQuery.refetch,
-  };
-};
-`
-    },
-    {
-      name: 'useVoting.ts',
-      content: `import { useMemo } from 'react';
-import { useGetProposals } from '${packageName}/cosmos/gov/v1beta1/query.rpc.react';
-import { ProposalStatus, proposalStatusToJSON } from '${packageName}/cosmos/gov/v1beta1/gov';
-import { defaultContext } from '@tanstack/react-query';
-
-export const useVoting = (chainName: string) => {
-  const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-
-  const proposalsQuery = useGetProposals({
-    request: {
-      proposalStatus: proposalStatusToJSON(ProposalStatus.PROPOSAL_STATUS_VOTING_PERIOD),
-      voter: '',
-      depositor: '',
-      pagination: {
-        key: new Uint8Array(),
-        offset: 0n,
-        limit: 50n,
-        countTotal: true,
-        reverse: true,
-      },
-    },
-    options: {
-      context: defaultContext,
-      enabled: !!rpcEndpoint,
-      select: ({ proposals }) => proposals,
-    },
-    clientResolver: rpcEndpoint,
-    customizedQueryKey: ['proposals', chainName],
-  });
-
-  const data = useMemo(() => {
-    if (!proposalsQuery.data) return;
-
-    return {
-      proposals: proposalsQuery.data.map((proposal) => ({
-        proposalId: proposal.proposalId.toString(),
-        title: proposal.content?.title || '',
-        description: proposal.content?.description || '',
-        status: proposal.status,
-        submitTime: proposal.submitTime,
-        votingStartTime: proposal.votingStartTime,
-        votingEndTime: proposal.votingEndTime,
-      })),
-    };
-  }, [proposalsQuery.data]);
-
-  return {
-    data,
-    isLoading: proposalsQuery.isLoading,
-    refetch: proposalsQuery.refetch,
-  };
-};
-`
-    },
-    {
-      name: 'useVotingData.ts',
-      content: `import { useMemo } from 'react';
-import { useChain } from '@interchain-kit/react';
-import {
-  useGetProposals,
-  useGetVote,
-  useGetTallyResult,
-} from '${packageName}/cosmos/gov/v1beta1/query.rpc.react';
-import { ProposalStatus, proposalStatusToJSON } from '${packageName}/cosmos/gov/v1beta1/gov';
-import { defaultContext } from '@tanstack/react-query';
-
-export const useVotingData = (chainName: string) => {
-  const { address } = useChain(chainName);
-  const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-
-  const isEnabled = !!rpcEndpoint;
-
-  const proposalsQuery = useGetProposals({
-    request: {
-      proposalStatus: proposalStatusToJSON(ProposalStatus.PROPOSAL_STATUS_UNSPECIFIED),
-      voter: '',
-      depositor: '',
-      pagination: {
-        key: new Uint8Array(),
-        offset: 0n,
-        limit: 100n,
-        countTotal: true,
-        reverse: true,
-      },
-    },
-    options: {
-      context: defaultContext,
-      enabled: isEnabled,
-      select: ({ proposals }) => proposals,
-    },
-    clientResolver: rpcEndpoint,
-    customizedQueryKey: ['allProposals', chainName],
-  });
-
-  const activeProposals = useMemo(() => {
-    return proposalsQuery.data?.filter(
-      (proposal) => proposal.status === ProposalStatus.PROPOSAL_STATUS_VOTING_PERIOD
-    ) || [];
-  }, [proposalsQuery.data]);
-
-  const data = useMemo(() => {
-    if (!proposalsQuery.data) return;
-
-    const categorized = {
-      active: activeProposals,
-      passed: proposalsQuery.data.filter(
-        (p) => p.status === ProposalStatus.PROPOSAL_STATUS_PASSED
-      ),
-      rejected: proposalsQuery.data.filter(
-        (p) => p.status === ProposalStatus.PROPOSAL_STATUS_REJECTED
-      ),
-      failed: proposalsQuery.data.filter(
-        (p) => p.status === ProposalStatus.PROPOSAL_STATUS_FAILED
-      ),
-    };
-
-    return {
-      proposals: proposalsQuery.data,
-      categorized,
-      activeCount: categorized.active.length,
-    };
-  }, [proposalsQuery.data, activeProposals]);
-
-  return {
-    data,
-    isLoading: proposalsQuery.isLoading,
-    refetch: proposalsQuery.refetch,
-  };
-};
-`
-    },
-    {
-      name: 'useContractInfo.ts',
-      content: `import { defaultContext } from '@tanstack/react-query';
-import { useGetContractInfo } from '${packageName}/cosmwasm/wasm/v1/query.rpc.react';
-
-export const useContractInfo = ({
-  contractAddress,
-  enabled = true,
-}: {
-  contractAddress: string;
-  enabled?: boolean;
-}) => {
-  const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-
-  return useGetContractInfo({
-    request: {
-      address: contractAddress,
-    },
-    options: {
-      enabled: !!contractAddress && !!rpcEndpoint && enabled,
-      context: defaultContext,
-    },
-    clientResolver: rpcEndpoint,
-  });
-};
-`
-    },
-    {
-      name: 'useQueryContract.ts',
-      content: `import { defaultContext } from '@tanstack/react-query';
-import { useGetSmartContractState } from '${packageName}/cosmwasm/wasm/v1/query.rpc.react';
-
-export const useQueryContract = ({
-  contractAddress,
-  queryMsg,
-  enabled = true,
-}: {
-  contractAddress: string;
-  queryMsg: object;
-  enabled?: boolean;
-}) => {
-  const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-
-  return useGetSmartContractState({
-    request: {
-      address: contractAddress,
-      queryData: new TextEncoder().encode(JSON.stringify(queryMsg)),
-    },
-    options: {
-      enabled: !!contractAddress && !!queryMsg && !!rpcEndpoint && enabled,
-      context: defaultContext,
-      select: ({ data }) => {
-        if (data) {
-          return JSON.parse(new TextDecoder().decode(data));
-        }
-        return null;
-      },
-    },
-    clientResolver: rpcEndpoint,
-  });
-};
-`
-    },
-    {
-      name: 'useCodeDetails.ts',
-      content: `import { defaultContext } from '@tanstack/react-query';
-import { useGetCode } from '${packageName}/cosmwasm/wasm/v1/query.rpc.react';
-
-export const useCodeDetails = ({
-  codeId,
-  enabled = true,
-}: {
-  codeId: string | number;
-  enabled?: boolean;
-}) => {
-  const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-
-  return useGetCode({
-    request: {
-      codeId: BigInt(codeId),
-    },
-    options: {
-      enabled: !!codeId && !!rpcEndpoint && enabled,
-      context: defaultContext,
-    },
-    clientResolver: rpcEndpoint,
-  });
-};
-`
-    },
-    {
-      name: 'useMyContracts.ts',
-      content: `import { useMemo } from 'react';
-import { useChain } from '@interchain-kit/react';
-import { useGetContractsByCreator } from '${packageName}/cosmwasm/wasm/v1/query.rpc.react';
-import { defaultContext } from '@tanstack/react-query';
-
-export const useMyContracts = (chainName: string) => {
-  const { address } = useChain(chainName);
-  const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-
-  const contractsQuery = useGetContractsByCreator({
-    request: {
-      creatorAddress: address || '',
-      pagination: {
-        key: new Uint8Array(),
-        offset: 0n,
-        limit: 100n,
-        countTotal: true,
-        reverse: false,
-      },
-    },
-    options: {
-      enabled: !!address && !!rpcEndpoint,
-      context: defaultContext,
-      select: ({ contractAddresses }) => contractAddresses,
-    },
-    clientResolver: rpcEndpoint,
-  });
-
-  const data = useMemo(() => {
-    if (!contractsQuery.data) return;
-
-    return {
-      contracts: contractsQuery.data.map((address) => ({
-        address,
-        label: \`Contract \${address.slice(0, 8)}...\`,
-      })),
-      count: contractsQuery.data.length,
-    };
-  }, [contractsQuery.data]);
-
-  return {
-    data,
-    isLoading: contractsQuery.isLoading,
-    refetch: contractsQuery.refetch,
-  };
-};
-`
-    },
-    {
-      name: 'useGrants.ts',
-      content: `import { useMemo } from 'react';
-import { useChain } from '@interchain-kit/react';
-import { useGetGranterGrants, useGetGranteeGrants } from '${packageName}/cosmos/authz/v1beta1/query.rpc.react';
-import { defaultContext } from '@tanstack/react-query';
-
-export const useGrants = (chainName: string) => {
-  const { address } = useChain(chainName);
-  const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-
-  const granterQuery = useGetGranterGrants({
-    request: {
-      granter: address || '',
-      pagination: {
-        key: new Uint8Array(),
-        offset: 0n,
-        limit: 100n,
-        countTotal: true,
-        reverse: false,
-      },
-    },
-    options: {
-      enabled: !!address && !!rpcEndpoint,
-      context: defaultContext,
-      select: ({ grants }) => grants,
-    },
-    clientResolver: rpcEndpoint,
-  });
-
-  const granteeQuery = useGetGranteeGrants({
-    request: {
-      grantee: address || '',
-      pagination: {
-        key: new Uint8Array(),
-        offset: 0n,
-        limit: 100n,
-        countTotal: true,
-        reverse: false,
-      },
-    },
-    options: {
-      enabled: !!address && !!rpcEndpoint,
-      context: defaultContext,
-      select: ({ grants }) => grants,
-    },
-    clientResolver: rpcEndpoint,
-  });
-
-  const data = useMemo(() => {
-    return {
-      granterGrants: granterQuery.data || [],
-      granteeGrants: granteeQuery.data || [],
-    };
-  }, [granterQuery.data, granteeQuery.data]);
-
-  const isLoading = granterQuery.isLoading || granteeQuery.isLoading;
-
-  return {
-    data,
-    isLoading,
-    refetch: () => {
-      granterQuery.refetch();
-      granteeQuery.refetch();
-    },
-  };
-};
-`
-    },
-    {
-      name: 'useSendData.ts',
-      content: `import { useMemo } from 'react';
-import { useChain } from '@interchain-kit/react';
-import { useGetBalance } from '${packageName}/cosmos/bank/v1beta1/query.rpc.react';
-import { defaultContext } from '@tanstack/react-query';
-import BigNumber from 'bignumber.js';
-
-export const useSendData = (chainName: string) => {
-  const { address, assetList } = useChain(chainName);
-  const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-
-  const coin = assetList?.assets[0];
-  const denom = coin?.base || 'uatom';
-  const exponent = coin?.denomUnits?.find(unit => unit.denom === coin.display)?.exponent || 6;
-
-  const balanceQuery = useGetBalance({
-    request: {
-      address: address || '',
-      denom,
-    },
-    options: {
-      enabled: !!address && !!rpcEndpoint,
-      context: defaultContext,
-      select: ({ balance }) => {
-        const amount = balance?.amount || '0';
-        const displayAmount = new BigNumber(amount).dividedBy(Math.pow(10, exponent));
-        return {
-          amount,
-          displayAmount: displayAmount.toString(),
-          denom: balance?.denom || denom,
-        };
-      },
-    },
-    clientResolver: rpcEndpoint,
-  });
-
-  const data = useMemo(() => {
-    if (!balanceQuery.data) return;
-
-    return {
-      balance: balanceQuery.data,
-      canSend: new BigNumber(balanceQuery.data.amount).isGreaterThan(0),
-      fee: {
-        amount: '5000',
-        displayAmount: new BigNumber('5000').dividedBy(Math.pow(10, exponent)).toString(),
-        denom,
-      },
-    };
-  }, [balanceQuery.data, denom, exponent]);
-
-  return {
-    data,
-    isLoading: balanceQuery.isLoading,
-    refetch: balanceQuery.refetch,
-  };
-};
-`
-    },
-    {
-      name: 'useTotalAssets.ts',
-      content: `import { useMemo } from 'react';
-import { useChain } from '@interchain-kit/react';
-import { useGetAllBalances } from '${packageName}/cosmos/bank/v1beta1/query.rpc.react';
-import { defaultContext } from '@tanstack/react-query';
-import BigNumber from 'bignumber.js';
-
-export const getPagination = (limit: bigint) => ({
-  key: new Uint8Array(),
-  offset: 0n,
-  limit,
-  countTotal: true,
-  reverse: false,
-});
-
-export const useTotalAssets = (chainName: string) => {
-  const { address, assetList } = useChain(chainName);
-  const rpcEndpoint = 'https://cosmos-rpc.quickapi.com:443';
-
-  const allBalancesQuery = useGetAllBalances({
-    request: {
-      address: address || '',
-      pagination: getPagination(100n),
-      resolveDenom: false,
-    },
-    options: {
-      enabled: !!address && !!rpcEndpoint,
-      select: ({ balances }) => balances || [],
-      context: defaultContext,
-    },
-    clientResolver: rpcEndpoint,
-    customizedQueryKey: ['totalAssets', address],
-  });
-
-  const data = useMemo(() => {
-    if (!allBalancesQuery.data) return;
-
-    const totalValue = allBalancesQuery.data.reduce((sum, balance) => {
-      return sum.plus(balance.amount);
-    }, new BigNumber(0));
-
-    return {
-      balances: allBalancesQuery.data,
-      totalCount: allBalancesQuery.data.length,
-      totalValue: totalValue.toString(),
-      nonZeroBalances: allBalancesQuery.data.filter(
-        balance => new BigNumber(balance.amount).isGreaterThan(0)
-      ),
-    };
-  }, [allBalancesQuery.data]);
-
-  return {
-    data,
-    isLoading: allBalancesQuery.isLoading,
-    refetch: allBalancesQuery.refetch,
-  };
-};
-`
-    }
-  ];
-
-  // Write all example files
-  exampleFiles.forEach(({ name, content }) => {
-    writeFileSync(join(mcpServerPath, 'src', `${packageName}-examples`, name), content);
-  });
-}
-