Cara Menggunakan getClusterNodes

​

Kasus Penggunaan Umum

• Analisis Topologi Jaringan: Dapatkan gambaran singkat tentang node yang diketahui dalam klaster, termasuk kunci publik dan alamat jaringannya (gossip, TPU, RPC).
• Menemukan Endpoint RPC: Identifikasi server RPC potensial lainnya dalam klaster (meskipun ketersediaan dan batas laju mungkin berbeda-beda).
• Memantau Versi Node: Amati versi perangkat lunak yang dijalankan oleh berbagai node dalam klaster.

​

Parameter Permintaan

​

Struktur Respons

• pubkey (string): Kunci publik (identitas) node yang dikodekan dengan base58.
• gossip (string | null): Alamat IP dan port untuk layanan gossip node. Dapat berupa null jika tidak tersedia.
• tpu (string | null): Alamat IP dan port untuk Transaction Processing Unit (TPU) node. Ini digunakan untuk mengirimkan transaksi secara langsung. Dapat berupa null.
• rpc (string | null): Alamat IP dan port untuk layanan JSON-RPC node. Dapat berupa null jika layanan RPC tidak diaktifkan atau tidak diumumkan oleh node ini.
• version (string | null): Versi perangkat lunak node. Dapat berupa null jika informasi versi tidak tersedia.
• featureSet (u32 | null): Pengidentifikasi unik kumpulan fitur node. Dapat berupa null.
• shredVersion (u16 | null): Versi struktur data yang digunakan oleh node ini untuk menyimpan dan mengirimkan blok (shred). Dapat berupa null.

​

Contoh

​

1. Dapatkan Semua Node Klaster yang Diketahui

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

​

Tips untuk Pengembang

• Perspektif Node: Daftar yang dikembalikan mencerminkan node yang diketahui oleh node RPC tertentu yang Anda kueri. Node RPC yang berbeda mungkin memiliki pandangan yang sedikit berbeda terhadap klaster, terutama selama terjadi perubahan jaringan.
• Ketersediaan RPC: Tidak semua node yang tercantum pasti membuka port RPC-nya atau dapat diakses secara publik. Bidang rpc yang tidak bernilai null menunjukkan endpoint RPC yang diumumkan, tetapi tidak menjamin aksesibilitas atau performa.
• Daftar Dinamis: Topologi klaster bersifat dinamis. Node dapat bergabung dan keluar, sehingga daftar dapat berubah seiring waktu.
• Respons Besar: Pada jaringan besar seperti Mainnet Beta, respons dapat berukuran cukup besar dan mencantumkan banyak node.