Como Usar getVoteAccounts

​

Casos de Uso Comuns

• Monitoramento de Validadores: Rastreamento do status, participação e desempenho dos validadores na rede.
• Painéis de Staking: Exibição de informações sobre validadores disponíveis para usuários que desejam delegar seu SOL.
• Análise de Saúde da Rede: Avaliação da saúde geral e descentralização da rede, examinando a distribuição da participação e a atividade dos validadores.
• Identificação de Validadores Delinquentes: Encontrar validadores que não estão participando ativamente do consenso.

​

Parâmetros da Solicitação

1. commitment (string, opcional): Especifica o nível de compromisso para a consulta (por exemplo, "finalized", "confirmed", "processed"). Se omitido, o compromisso padrão do nó é utilizado.
2. votePubkey (string, opcional): Se fornecido, os resultados serão filtrados para incluir apenas o endereço de conta de votação do validador especificado (codificado em base-58).
3. keepUnstakedDelinquents (booleano, opcional): O padrão é false. Se definido como true, a lista delinquent incluirá validadores sem participação ativada. Caso contrário, eles serão filtrados.
4. delinquentSlotDistance (u64, opcional): Especifica quantos slots um validador deve estar atrás do topo do livro razão para ser considerado delinquente. Se não especificado, o nó usa um valor padrão.

​

Estrutura de Resposta

• current: Um array de objetos, onde cada objeto representa uma conta de votação ativa com os seguintes campos:
  • votePubkey (string): O endereço da conta de votação (codificado em base-58).
  • nodePubkey (string): A chave pública de identidade do nó validador (codificado em base-58).
  • activatedStake (u64): A quantidade de participação, em lamports, delegada a esta conta de votação e ativa no epoch atual.
  • epochVoteAccount (booleano): true se a conta de votação esteve ativa pelo menos uma vez durante o epoch atual.
  • commission (número): A porcentagem de comissão (0-100) cobrada pelo validador.
  • lastVote (u64): O número mais recente de slot em que este validador votou.
  • rootSlot (u64): O último slot que o nó considerou ser uma raiz (um bloco totalmente confirmado que não será revertido).
  • epochCredits (array): Um array de arrays, onde cada array interno contém [epoch, credits_earned_in_epoch, previous_total_credits].
• delinquent: Um array de objetos, com a mesma estrutura de current, representando validadores considerados delinquentes pelo nó.

{
  "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
}

​

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

​

Dicas para Desenvolvedores

• Resposta Grande: Este método pode retornar uma grande quantidade de dados, especialmente em redes com muitos validadores, como a Mainnet Beta. Fique atento ao tamanho da resposta e ao tempo de processamento.
• Definição de Delinquência: A definição de “delinquente” pode depender do delinquentSlotDistance e da perspectiva do nó. Um validador pode parecer delinquente em um nó, mas não em outro, se a visão deles do topo do livro razão for diferente.
• Ativação de Participação: activatedStake reflete a participação que está ativa no epoch atual. A participação leva tempo para ativar e desativar.
• Créditos de Epoch: epochCredits fornece um histórico do desempenho de um validador em ganhar créditos por votação.