Cómo usar getVoteAccounts

​

Casos de uso comunes

• Monitoreo de validadores: Haz un seguimiento del estado, el stake y el rendimiento de los validadores en la red.
• Paneles de staking: Muestra información sobre los validadores disponibles para los usuarios que desean delegar sus SOL.
• Análisis del estado de la red: Evalúa el estado general y la descentralización de la red examinando la distribución del stake y la actividad de los validadores.
• Identificación de validadores inactivos: Encuentra validadores que no participan activamente en el consenso.

​

Parámetros de solicitud

1. commitment (cadena, opcional): Especifica el nivel de compromiso de la consulta (por ejemplo, "finalized", "confirmed", "processed"). Si se omite, se usa el nivel de compromiso predeterminado del nodo.
2. votePubkey (cadena, opcional): Si se proporciona, los resultados se filtrarán para incluir únicamente la dirección especificada de la cuenta de votación del validador (codificada en base 58).
3. keepUnstakedDelinquents (booleano, opcional): El valor predeterminado es false. Si se establece en true, la lista delinquent incluirá validadores sin stake activado. De lo contrario, se excluirán.
4. delinquentSlotDistance (u64, opcional): Especifica cuántos slots debe estar un validador por detrás del extremo del libro mayor para considerarse inactivo. Si no se especifica, el nodo usa un valor predeterminado.

​

Estructura de la respuesta

• current: Un arreglo de objetos, donde cada objeto representa una cuenta de votación activa con los siguientes campos:
  • votePubkey (cadena): La dirección de la cuenta de votación (codificada en base 58).
  • nodePubkey (cadena): La clave pública de identidad del nodo validador (codificada en base 58).
  • activatedStake (u64): La cantidad de stake, en lamports, delegada a esta cuenta de votación y activa en la época actual.
  • epochVoteAccount (booleano): true si la cuenta de votación estuvo activa al menos una vez durante la época actual.
  • commission (número): El porcentaje de comisión (0-100) que cobra el validador.
  • lastVote (u64): El número de slot más reciente por el que votó este validador.
  • rootSlot (u64): El último slot que el nodo consideró como raíz (un bloque totalmente confirmado que no se revertirá).
  • epochCredits (arreglo): Un arreglo de arreglos, donde cada arreglo interno contiene [epoch, credits_earned_in_epoch, previous_total_credits].
• delinquent: Un arreglo de objetos con la misma estructura que current, que representa a los validadores que el nodo considera inactivos.

{
  "jsonrpc": "2.0",
  "result": {
    "current": [
      {
        "commission": 10,
        "epochCredits": [[300, 12345, 567890]],
        "epochVoteAccount": true,
        "lastVote": 180000500,
        "nodePubkey": "NodePubkeyExample123...",
        "rootSlot": 180000450,
        "activatedStake": "50000000000000", // lamports
        "votePubkey": "VoteAccountPubkeyExample123..."
      }
      // ... more current validators
    ],
    "delinquent": [
      // ... delinquent validators, if any
    ]
  },
  "id": 1
}

​

Ejemplos de código

# Get all current and delinquent vote accounts:
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getVoteAccounts"
  }' \
  <YOUR_RPC_URL>

# Get a specific vote account:
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getVoteAccounts",
    "params": [
      {
        "votePubkey": "<SPECIFIC_VOTE_ACCOUNT_PUBKEY>"
      }
    ]
  }' \
  <YOUR_RPC_URL>

# Get vote accounts with "confirmed" commitment and keep unstaked delinquents:
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getVoteAccounts",
    "params": [
      {
        "commitment": "confirmed",
        "keepUnstakedDelinquents": true
      }
    ]
  }' \
  <YOUR_RPC_URL>

const { Connection } = require('@solana/web3.js');

async function fetchVoteAccounts() {
  // Replace with your RPC endpoint
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');

  try {
    // Get all vote accounts
    const voteAccounts = await connection.getVoteAccounts();
    console.log(`Found ${voteAccounts.current.length} current validators.`);
    console.log(`Found ${voteAccounts.delinquent.length} delinquent validators.`);

    if (voteAccounts.current.length > 0) {
      console.log("\nFirst current validator details:");
      console.log(`  Vote Pubkey: ${voteAccounts.current[0].votePubkey}`);
      console.log(`  Node Pubkey: ${voteAccounts.current[0].nodePubkey}`);
      console.log(`  Activated Stake: ${voteAccounts.current[0].activatedStake} lamports`);
      console.log(`  Commission: ${voteAccounts.current[0].commission}%`);
      console.log(`  Last Vote: ${voteAccounts.current[0].lastVote}`);
      // console.log(JSON.stringify(voteAccounts.current[0], null, 2)); // For full details
    }

    // Get a specific vote account (replace with an actual vote account public key)
    // const specificVotePubkey = 'SPECIFIC_VOTE_ACCOUNT_PUBKEY';
    // const specificValidator = await connection.getVoteAccounts('confirmed', specificVotePubkey);
    // console.log(`\nDetails for ${specificVotePubkey}:`, JSON.stringify(specificValidator, null, 2));

  } catch (error) {
    console.error('Error fetching vote accounts:', error);
  }
}

fetchVoteAccounts();

​

Consejos para desarrolladores

• Respuesta grande: Este método puede devolver una gran cantidad de datos, especialmente en redes con muchos validadores, como Mainnet Beta. Ten en cuenta el tamaño de la respuesta y el tiempo de procesamiento.
• Definición de inactividad: La definición de “inactivo” puede depender de delinquentSlotDistance y de la perspectiva del nodo. Un validador podría aparecer como inactivo en un nodo, pero no en otro, si sus vistas del extremo del libro mayor difieren.
• Activación del stake: activatedStake refleja el stake activo en la época actual. Activar y desactivar el stake lleva tiempo.
• Créditos de época: epochCredits proporciona un historial del rendimiento de un validador al obtener créditos mediante la votación.