get_solana_balance
Retrieve SOL balance for any Solana address on mainnet or testnet networks using Grove's blockchain data access through Pocket Network.
Instructions
Get SOL balance for a Solana address
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | Solana address | |
| network | No | Network type (defaults to mainnet) |
Implementation Reference
- src/handlers/solana-handlers.ts:288-303 (handler)MCP tool handler case for 'get_solana_balance': parses arguments, delegates to SolanaService.getBalance(), formats result as MCP content response.case 'get_solana_balance': { const address = args?.address as string; const network = (args?.network as 'mainnet' | 'testnet') || 'mainnet'; const result = await solanaService.getBalance(address, network); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], isError: !result.success, }; }
- src/handlers/solana-handlers.ts:58-75 (registration)Tool registration object defining name, description, and input schema for 'get_solana_balance', returned by registerSolanaHandlers.name: 'get_solana_balance', description: 'Get SOL balance for a Solana address', inputSchema: { type: 'object', properties: { address: { type: 'string', description: 'Solana address', }, network: { type: 'string', enum: ['mainnet', 'testnet'], description: 'Network type (defaults to mainnet)', }, }, required: ['address'], }, },
- SolanaService.getBalance(): fetches raw balance via RPC 'getBalance', converts lamports to SOL, returns formatted EndpointResponse.async getBalance( address: string, network: 'mainnet' | 'testnet' = 'mainnet' ): Promise<EndpointResponse> { const service = this.blockchainService.getServiceByBlockchain('solana', network); if (!service) { return { success: false, error: `Solana service not found for ${network}`, }; } const result = await this.blockchainService.callRPCMethod( service.id, 'getBalance', [address] ); if (result.success && result.data?.value !== undefined) { const lamports = result.data.value; const sol = lamports / 1e9; // 1 SOL = 1 billion lamports return { success: true, data: { address, lamports, sol, }, metadata: result.metadata, }; } return result; }