Cách sử dụng getClusterNodes

​

Các trường hợp sử dụng phổ biến

• Phân tích cấu trúc liên kết mạng: Lấy thông tin tổng quan về các nút đã biết trong cụm, bao gồm khóa công khai và địa chỉ mạng của chúng (gossip, TPU, RPC).
• Tìm điểm cuối RPC: Xác định các máy chủ RPC tiềm năng khác trong cụm (mặc dù tính khả dụng và giới hạn tốc độ có thể khác nhau).
• Theo dõi phiên bản nút: Quan sát các phiên bản phần mềm đang chạy trên những nút khác nhau trong cụm.

​

Tham số yêu cầu

​

Cấu trúc phản hồi

• pubkey (string): Khóa công khai (danh tính) của nút, được mã hóa bằng base58.
• gossip (string | null): Địa chỉ IP và cổng dành cho dịch vụ gossip của nút. Có thể là null nếu không khả dụng.
• tpu (string | null): Địa chỉ IP và cổng dành cho Đơn vị xử lý giao dịch (TPU) của nút. Trường này được dùng để gửi giao dịch trực tiếp. Có thể là null.
• rpc (string | null): Địa chỉ IP và cổng dành cho dịch vụ JSON-RPC của nút. Có thể là null nếu dịch vụ RPC không được bật hoặc không được nút này công bố.
• version (string | null): Phiên bản phần mềm của nút. Có thể là null nếu không có thông tin phiên bản.
• featureSet (u32 | null): Mã định danh duy nhất của bộ tính năng trên nút. Có thể là null.
• shredVersion (u16 | null): Phiên bản của cấu trúc dữ liệu mà nút này sử dụng để lưu trữ và truyền các khối (shred). Có thể là null.

​

Ví dụ

​

1. Lấy tất cả các nút cụm đã biết

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

​

Mẹo dành cho nhà phát triển

• Góc nhìn của nút: Danh sách trả về phản ánh các nút mà nút RPC cụ thể đang được truy vấn biết đến. Các nút RPC khác nhau có thể có góc nhìn hơi khác nhau về cụm, đặc biệt khi mạng đang thay đổi.
• Tính khả dụng của RPC: Không phải mọi nút trong danh sách đều nhất thiết mở cổng RPC hoặc cho phép truy cập công khai. Trường rpc khác null cho biết một điểm cuối RPC đã được công bố, nhưng không đảm bảo khả năng truy cập hoặc hiệu năng.
• Danh sách động: Cấu trúc liên kết của cụm có tính động. Các nút có thể tham gia và rời khỏi cụm, vì vậy danh sách có thể thay đổi theo thời gian.
• Phản hồi lớn: Trên một mạng lớn như Mainnet Beta, phản hồi có thể khá dài và liệt kê nhiều nút.