Como Usar getClusterNodes

​

Casos de Uso Comuns

• Análise de Topologia de Rede: Obtenha um instantâneo dos nós conhecidos no cluster, incluindo suas chaves públicas e endereços de rede (gossip, TPU, RPC).
• Descobrindo Endpoints RPC: Identifique outros servidores RPC potenciais dentro do cluster (embora a disponibilidade e os limites de taxa possam variar).
• Monitoramento de Versões de Nó: Observe as versões de software sendo executadas por diferentes nós no cluster.

​

Parâmetros de Solicitação

​

Estrutura de Resposta

• pubkey (string): A chave pública (identidade) do nó, codificada em base58.
• gossip (string | null): O endereço IP e porta para o serviço de gossip do nó. Pode ser null se não estiver disponível.
• tpu (string | null): O endereço IP e porta para a Unidade de Processamento de Transações (TPU) do nó. Isto é usado para enviar transações diretamente. Pode ser null.
• rpc (string | null): O endereço IP e porta para o serviço JSON-RPC do nó. Pode ser null se o serviço RPC não estiver habilitado ou anunciado por este nó.
• version (string | null): A versão do software do nó. Pode ser null se a informação da versão não estiver disponível.
• featureSet (u32 | null): O identificador único do conjunto de funcionalidades do nó. Pode ser null.
• shredVersion (u16 | null): A versão da estrutura de dados usada por este nó para armazenar e transmitir blocos (shreds). Pode ser null.

​

Exemplos

​

1. Obter Todos os Nós Conhecidos do Cluster

curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getClusterNodes"
  }'

const { Connection } = require('@solana/web3.js');

async function getNodesInCluster() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const clusterNodes = await connection.getClusterNodes();
    console.log(`Found ${clusterNodes.length} cluster nodes:`);
    clusterNodes.forEach(node => {
      console.log(
        `  PubKey: ${node.pubkey}, Gossip: ${node.gossip || 'N/A'}, RPC: ${node.rpc || 'N/A'}, Version: ${node.version || 'N/A'}`
      );
    });
    // For full details:
    // console.log(JSON.stringify(clusterNodes, null, 2));
  } catch (error) {
    console.error('Error fetching cluster nodes:', error);
  }
}

getNodesInCluster();

​

Dicas para Desenvolvedores

• Perspectiva do Nó: A lista retornada reflete os nós conhecidos pelo nó RPC específico que você está consultando. Diferentes nós RPC podem ter visões ligeiramente diferentes do cluster, especialmente durante mudanças na rede.
• Disponibilidade RPC: Nem todos os nós listados terão necessariamente suas portas RPC abertas ou acessíveis publicamente. O campo rpc sendo não-nulo indica um endpoint RPC anunciado, mas não garante acessibilidade ou desempenho.
• Lista Dinâmica: A topologia do cluster é dinâmica. Nós podem entrar e sair, então a lista pode mudar ao longo do tempo.
• Resposta Grande: Em uma rede grande como a Mainnet Beta, a resposta pode ser bastante extensa, listando muitos nós.