Verwendung von getClusterNodes

​

Häufige Anwendungsfälle

• Netzwerktopologie-Analyse: Erhalten Sie eine Momentaufnahme der bekannten Knoten im Cluster, einschließlich ihrer öffentlichen Schlüssel und Netzwerkadressen (gossip, TPU, RPC).
• Entdecken von RPC-Endpunkten: Identifizieren Sie andere potenzielle RPC-Server innerhalb des Clusters (obwohl Verfügbarkeit und Ratenlimits variieren können).
• Überwachung von Node-Versionen: Beobachten Sie die Softwareversionen, die von verschiedenen Knoten im Cluster ausgeführt werden.

​

Anforderungsparameter

​

Antwortstruktur

• pubkey (string): Der öffentliche Schlüssel (Identität) des Knotens, Base58-kodiert.
• gossip (string | null): Die IP-Adresse und der Port für den Gossip-Dienst des Knotens. Kann null sein, wenn nicht verfügbar.
• tpu (string | null): Die IP-Adresse und der Port für die Transaction Processing Unit (TPU) des Knotens. Dies wird verwendet, um Transaktionen direkt einzureichen. Kann null sein.
• rpc (string | null): Die IP-Adresse und der Port für den JSON-RPC-Dienst des Knotens. Kann null sein, wenn der RPC-Dienst von diesem Knoten nicht aktiviert oder beworben wird.
• version (string | null): Die Softwareversion des Knotens. Kann null sein, wenn Versionsinformationen nicht verfügbar sind.
• featureSet (u32 | null): Der eindeutige Bezeichner des Funktionssatzes des Knotens. Kann null sein.
• shredVersion (u16 | null): Die Version der Datenstruktur, die von diesem Knoten verwendet wird, um Blöcke (Shreds) zu speichern und zu übertragen. Kann null sein.

​

Beispiele

​

1. Alle bekannten Clusterknoten abrufen

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

​

Entwicklertipps

• Perspektive des Knotens: Die zurückgegebene Liste spiegelt die Knoten wider, die dem spezifischen RPC-Knoten bekannt sind, den Sie abfragen. Verschiedene RPC-Knoten könnten leicht unterschiedliche Ansichten des Clusters haben, insbesondere während Netzwerkänderungen.
• RPC-Verfügbarkeit: Nicht alle aufgelisteten Knoten haben notwendigerweise ihre RPC-Ports offen oder sind öffentlich zugänglich. Das nicht-null rpc-Feld zeigt einen beworbenen RPC-Endpunkt an, garantiert jedoch nicht die Zugänglichkeit oder Leistung.
• Dynamische Liste: Die Clustertopologie ist dynamisch. Knoten können beitreten und austreten, daher kann sich die Liste im Laufe der Zeit ändern.
• Große Antwort: In einem großen Netzwerk wie dem Mainnet Beta kann die Antwort ziemlich umfangreich sein und viele Knoten auflisten.