getClusterNodes

The getClusterNodes method returns information about all participating validator nodes currently known to the cluster. This method provides a comprehensive snapshot of the network topology, including details about each validator's identity, gossip address, RPC endpoints, and software version.

Validator nodes are the backbone of Solana's network, responsible for processing transactions, producing blocks, and maintaining consensus. This method exposes detailed networking information about each validator, which is essential for monitoring tools, validator management systems, and applications that need to distribute RPC requests across multiple endpoints. The data includes both validators that are actively producing blocks and those that are participating in consensus but may not currently be leaders.

Understanding the cluster composition is valuable for network health monitoring, choosing reliable RPC endpoints, implementing validator selection strategies for staking, and analyzing network decentralization. The method reveals which software versions validators are running, their network addresses, and their unique identifiers within the cluster.

Parameters

parameter	type	description
config	object	Optional configuration object (currently no config options are available)

Return Object

field	type	description
result	array	Array of cluster node information objects
result[].pubkey	string	Node's public key as base-58 encoded string (identity)
result[].gossip	string	Gossip network address for the node (IP:port)
result[].tpu	string	TPU (Transaction Processing Unit) network address (IP:port)
result[].rpc	string\|null	JSON RPC network address (IP:port), or null if not available
result[].version	string\|null	Software version of the node, or null if version is not available
result[].featureSet	number\|null	Unique identifier of the node's feature set, or null if not available
result[].shredVersion	number\|null	Shred version the node has been configured to use, or null if not available

Request Example

Request

Response Example

Response

Tip: The TPU address is used for sending transactions directly to validators for faster processing. Not all validators expose RPC endpoints (rpc field may be null). Use this method to discover available RPC nodes or monitor network topology. The shredVersion must match for nodes to communicate in the cluster.