Comment utiliser getClusterNodes

​

Cas d’utilisation courants

• Analyse de la topologie du réseau : Obtenez un instantané des nœuds connus dans le cluster, y compris leurs clés publiques et adresses réseau (gossip, TPU, RPC).
• Découverte de points de terminaison RPC : Identifiez d’autres serveurs RPC potentiels au sein du cluster (bien que la disponibilité et les limites de taux puissent varier).
• Surveillance des versions des nœuds : Observez les versions logicielles exécutées par différents nœuds dans le cluster.

​

Paramètres de requête

​

Structure de la réponse

• pubkey (string) : La clé publique (identité) du nœud, encodée en base58.
• gossip (string | null) : L’adresse IP et le port du service gossip du nœud. Peut être null si non disponible.
• tpu (string | null) : L’adresse IP et le port pour l’unité de traitement des transactions (TPU) du nœud. Utilisée pour soumettre des transactions directement. Peut être null.
• rpc (string | null) : L’adresse IP et le port pour le service JSON-RPC du nœud. Peut être null si le service RPC n’est pas activé ou annoncé par ce nœud.
• version (string | null) : La version logicielle du nœud. Peut être null si l’information sur la version n’est pas disponible.
• featureSet (u32 | null) : L’identifiant unique de l’ensemble des fonctionnalités du nœud. Peut être null.
• shredVersion (u16 | null) : La version de la structure de données utilisée par ce nœud pour stocker et transmettre des blocs (shreds). Peut être null.

​

Exemples

​

1. Obtenir tous les nœuds du cluster connus

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();

​

Conseils pour les développeurs

• Perspective du nœud : La liste renvoyée reflète les nœuds connus du nœud RPC spécifique que vous interrogez. Différents nœuds RPC peuvent avoir des vues légèrement différentes du cluster, surtout lors de changements dans le réseau.
• Disponibilité RPC : Tous les nœuds listés n’auront pas nécessairement leurs ports RPC ouverts ou accessibles au public. Le champ rpc non nul indique un point de terminaison RPC annoncé, mais ne garantit pas l’accessibilité ou la performance.
• Liste dynamique : La topologie du cluster est dynamique. Les nœuds peuvent rejoindre et quitter, donc la liste peut changer au fil du temps.
• Réponse volumineuse : Sur un grand réseau comme le Mainnet Beta, la réponse peut être assez longue, répertoriant de nombreux nœuds.