So verwendest du getClusterNodes

​

Häufige Anwendungsfälle

• Netzwerktopologie analysieren: Rufe eine Momentaufnahme der bekannten nodes im cluster ab, einschließlich ihrer öffentlichen Schlüssel und Netzwerkadressen (Gossip, TPU, RPC).
• RPC endpoint ermitteln: Identifiziere weitere potenzielle RPC-Server im cluster. Verfügbarkeit und rate limits können jedoch variieren.
• Node-Versionen überwachen: Prüfe, welche Softwareversionen auf den verschiedenen nodes im cluster ausgeführt werden.

​

Request-Parameter

​

Response-Struktur

• pubkey (string): Der Base58-codierte öffentliche Schlüssel (Identität) des node.
• gossip (string | null): Die IP-Adresse und der Port für den Gossip-Dienst des node. Kann null sein, wenn diese Angabe nicht verfügbar ist.
• tpu (string | null): Die IP-Adresse und der Port für die Transaction Processing Unit (TPU) des node. Sie dient dazu, Transaktionen direkt zu übermitteln. Kann null sein.
• rpc (string | null): Die IP-Adresse und der Port für den JSON-RPC-Dienst des node. Kann null sein, wenn der RPC-Dienst auf diesem node nicht aktiviert ist oder nicht angekündigt wird.
• version (string | null): Die Softwareversion des node. Kann null sein, wenn keine Versionsinformationen verfügbar sind.
• featureSet (u32 | null): Die eindeutige Kennung des Feature-Sets des node. Kann null sein.
• shredVersion (u16 | null): Die Version der Datenstruktur, mit der dieser node Blöcke (shred) speichert und überträgt. Kann null sein.

​

Beispiele

​

1. Alle bekannten Cluster-Nodes 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();

​

Tipps für Entwickler

• Perspektive des node: Die zurückgegebene Liste enthält die nodes, die dem abgefragten RPC node bekannt sind. Verschiedene RPC nodes können den cluster geringfügig unterschiedlich sehen, insbesondere bei Änderungen im Netzwerk.
• RPC-Verfügbarkeit: Nicht alle aufgeführten nodes haben zwingend offene oder öffentlich zugängliche RPC-Ports. Wenn das Feld rpc nicht null ist, wurde ein RPC endpoint angekündigt. Das garantiert jedoch weder Erreichbarkeit noch Leistung.
• Dynamische Liste: Die Topologie des cluster ist dynamisch. Nodes können hinzukommen oder ihn verlassen. Daher kann sich die Liste im Laufe der Zeit ändern.
• Umfangreiche Response: In einem großen Netzwerk wie Mainnet Beta kann die response sehr umfangreich sein und viele nodes auflisten.