getClusterNodes 사용 방법

​

일반적인 사용 사례

• 네트워크 토폴로지 분석: 클러스터 내 알려진 노드의 스냅샷을 얻고, 공개 키 및 네트워크 주소(gossip, TPU, RPC)를 포함합니다.
• RPC 엔드포인트 발견: 클러스터 내 다른 잠재적인 RPC 서버 식별 (가용성과 속도 제한은 다를 수 있음).
• 노드 버전 모니터링: 클러스터 내 다양한 노드에서 실행되는 소프트웨어 버전을 관찰합니다.

​

요청 매개변수

​

응답 구조

• pubkey (string): base58로 인코딩된 노드의 공개 키(identity).
• gossip (string | null): 노드의 gossip 서비스에 대한 IP 주소와 포트입니다. 사용 가능하지 않으면 null일 수 있습니다.
• tpu (string | null): 노드의 트랜잭션 처리 유닛(TPU)을 위한 IP 주소와 포트입니다. 직접적인 트랜잭션 제출에 사용됩니다. null일 수 있습니다.
• rpc (string | null): 노드의 JSON-RPC 서비스에 대한 IP 주소와 포트입니다. 이 노드에 의해 RPC 서비스가 활성화되지 않거나 광고되지 않는 경우 null일 수 있습니다.
• version (string | null): 노드의 소프트웨어 버전입니다. 버전 정보가 사용 가능하지 않으면 null일 수 있습니다.
• featureSet (u32 | null): 노드의 기능 세트의 고유 식별자입니다. null일 수 있습니다.
• shredVersion (u16 | null): 이 노드가 블록(절편)을 저장하고 전송하는 데 사용되는 데이터 구조의 버전입니다. null일 수 있습니다.

​

예제

​

1. 모든 알려진 클러스터 노드 가져오기

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

​

개발자 팁

• 노드의 관점: 반환된 목록은 특정 RPC 노드에 알려진 노드를 반영합니다. 다른 RPC 노드는 네트워크 변경 중에 클러스터에 대한 약간 다른 관점을 가질 수 있습니다.
• RPC 가용성: 나열된 모든 노드의 RPC 포트가 반드시 열려 있거나 공개적으로 접근 가능한 것은 아닙니다. rpc 필드가 null이 아니면 광고된 RPC 엔드포인트임을 나타내지만, 접근성이나 성능을 보장하지는 않습니다.
• 동적 목록: 클러스터 토폴로지는 동적입니다. 노드는 가입하고 떠날 수 있으며, 따라서 목록은 시간이 지남에 따라 변경될 수 있습니다.
• 큰 응답: 메인넷 베타와 같은 큰 네트워크에서는 응답이 상당히 광범위할 수 있으며, 많은 노드를 나열합니다.