HashPilot

Instructions

Implementation Reference

• src/tools/rpc.ts:15-63 (handler)

  The primary handler function that executes any JSON-RPC method on Hedera, handling the core logic including service calls, decoding, error handling, and response formatting.

  export async function rpcCall(args: {
    method: string;
    params?: any[];
    network?: 'mainnet' | 'testnet' | 'previewnet' | 'local';
  }): Promise<ToolResult> {
    try {
      logger.info('Executing generic RPC call', { method: args.method, network: args.network });
  
      const response = await jsonRpcService.callWithDetails(
        args.method,
        args.params || [],
        args.network
      );
  
      // Build output with full details
      const data: any = {
        method: args.method,
        result: response.result, // Raw result from RPC
      };
  
      // Add decoded values if available
      if (response.decoded) {
        data.decoded = response.decoded;
      }
  
      // Add full RPC response
      data.rpc_response = response.raw;
  
      return {
        success: true,
        data,
        metadata: {
          executedVia: 'json_rpc_relay',
          command: `rpc ${args.method}`,
          network: args.network || 'current',
        },
      };
    } catch (error) {
      logger.error('Generic RPC call failed', { error, method: args.method });
      return {
        success: false,
        error: error instanceof Error ? error.message : 'Unknown error occurred',
        metadata: {
          executedVia: 'json_rpc_relay',
          command: `rpc ${args.method}`,
        },
      };
    }
  }

• src/index.ts:223-249 (schema)

  The tool schema definition for 'rpc_call' used in the MCP tool listing (ListToolsRequest), including name, description, and input validation schema.

    {
      name: 'rpc_call',
      description: `Execute ANY JSON-RPC method on Hedera's JSON-RPC Relay.
  
  SUPPORTS: 55+ methods including eth_*, web3_*, net_*, debug_*
  EXAMPLES: eth_blockNumber, eth_getBalance, eth_call, eth_getLogs, eth_sendRawTransaction
  DECODES: Results automatically converted to human-readable format
  
  USE FOR: EVM-compatible operations, blockchain state queries, transaction submission.`,
      inputSchema: {
        type: 'object' as const,
        properties: {
          method: { type: 'string', description: 'RPC method name (e.g., "eth_blockNumber")' },
          params: {
            type: 'array',
            items: {},
            description: 'Method parameters as array',
          },
          network: {
            type: 'string',
            enum: ['mainnet', 'testnet', 'previewnet', 'local'],
            description: 'Target network (default: current)',
          },
        },
        required: ['method'],
      },
    },

• src/index.ts:605-607 (registration)

  The dispatch registration in the main tool execution switch statement that routes 'rpc_call' calls to the rpcCall handler function.

  case 'rpc_call':
    result = await rpcCall(args as any);
    break;

• src/index.ts:48-48 (registration)

  Import statement that brings the rpcCall handler into the main index file for use in tool dispatching.

  import { rpcCall, rpcCallContract, rpcDeployContract, rpcExecuteContract } from './tools/rpc.js';

• src/tools/rpc.ts:252-276 (schema)

  Alternative/internal tool schema definition for 'rpc_call' exported in rpcTools array within the rpc module.

    name: 'rpc_call',
    description:
      'Execute any JSON-RPC method on Hedera. Supports all 55+ methods from OpenRPC spec including eth_*, web3_*, net_*, debug_*. Examples: eth_blockNumber, eth_getBalance, eth_call, eth_sendRawTransaction, eth_getLogs, debug_traceTransaction, etc.',
    inputSchema: {
      type: 'object' as const,
      properties: {
        method: {
          type: 'string',
          description:
            'RPC method name (e.g., "eth_blockNumber", "eth_getBalance", "eth_call", "eth_getLogs")',
        },
        params: {
          type: 'array',
          description: 'Method-specific parameters as array',
          items: {},
        },
        network: {
          type: 'string',
          enum: ['mainnet', 'testnet', 'previewnet', 'local'],
          description: 'Target network (default: current network)',
        },
      },
      required: ['method'],
    },
  },