Cómo usar getClusterNodes

​

Casos de uso comunes

• Análisis de la topología de la red: Obtén una instantánea de los nodos conocidos del clúster, incluidas sus claves públicas y direcciones de red (gossip, TPU, RPC).
• Descubrimiento de endpoints RPC: Identifica otros posibles servidores RPC dentro del clúster, aunque su disponibilidad y límites de frecuencia pueden variar.
• Monitoreo de versiones de nodos: Observa las versiones de software que ejecutan los distintos nodos del clúster.

​

Parámetros de solicitud

​

Estructura de la respuesta

• pubkey (string): La clave pública (identidad) del nodo, codificada en base58.
• gossip (string | null): La dirección IP y el puerto del servicio gossip del nodo. Puede ser null si no está disponible.
• tpu (string | null): La dirección IP y el puerto de la Unidad de Procesamiento de Transacciones (TPU) del nodo. Se usa para enviar transacciones directamente. Puede ser null.
• rpc (string | null): La dirección IP y el puerto del servicio JSON-RPC del nodo. Puede ser null si el servicio RPC no está habilitado o este nodo no lo anuncia.
• version (string | null): La versión de software del nodo. Puede ser null si la información de la versión no está disponible.
• featureSet (u32 | null): El identificador único del conjunto de características del nodo. Puede ser null.
• shredVersion (u16 | null): La versión de la estructura de datos que usa este nodo para almacenar y transmitir bloques (shreds). Puede ser null.

​

Ejemplos

​

1. Obtén todos los nodos conocidos del clúster

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

​

Consejos para desarrolladores

• Perspectiva del nodo: La lista devuelta refleja los nodos que conoce el nodo RPC específico que consultas. Distintos nodos RPC pueden tener vistas ligeramente diferentes del clúster, especialmente durante cambios en la red.
• Disponibilidad de RPC: No todos los nodos de la lista tendrán necesariamente sus puertos RPC abiertos o accesibles públicamente. Si el campo rpc no es nulo, indica que se anuncia un endpoint RPC, pero no garantiza su accesibilidad ni rendimiento.
• Lista dinámica: La topología del clúster es dinámica. Los nodos pueden unirse y retirarse, por lo que la lista puede cambiar con el tiempo.
• Respuesta extensa: En una red grande como Mainnet Beta, la respuesta puede ser bastante extensa e incluir muchos nodos.