Como Usar getEpochInfo

​

Casos de Uso Comuns

• Monitoramento do Progresso do Epoch: Acompanhe o índice do slot atual dentro do epoch e o total de slots no epoch para estimar o tempo restante.
• Análise de Estado da Rede: Obtenha o número do epoch atual, a altura do bloco e o número de transações processadas no epoch atual.
• Verificações de Sincronização: Verifique se um nó está razoavelmente sincronizado com a rede comparando suas informações de epoch.

​

Parâmetros da Requisição

• commitment (string, opcional): Especifica o nível de compromisso a ser usado ao consultar o ledger.
  • finalized: O nó irá consultar o bloco mais recente confirmado pela supermaioria do cluster como tendo alcançado bloqueio máximo.
  • confirmed: O nó irá consultar o bloco mais recente que foi votado por uma supermaioria do cluster.
  • processed: O nó irá consultar seu bloco mais recente. Observe que o bloco pode não estar completo.
  • Se não for fornecido, o compromisso padrão é finalized.
• minContextSlot (número, opcional): O slot mínimo no qual a requisição pode ser avaliada. Isso pode ser usado para garantir que a resposta seja de um estado suficientemente recente.

​

Estrutura da Resposta

• absoluteSlot (u64): O número absoluto do slot atual.
• blockHeight (u64): A altura do bloco atual.
• epoch (u64): O número do epoch atual.
• slotIndex (u64): O slot atual em relação ao início do epoch atual.
• slotsInEpoch (u64): O número total de slots no epoch atual.
• transactionCount (u64 | null): O número total de transações processadas no epoch atual. Pode ser null se os dados não estiverem disponíveis.

​

Exemplos

​

1. Obter Informações do Epoch Atual (Sem Parâmetros)

curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getEpochInfo"
  }'

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

async function getCurrentEpochInfo() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const epochInfo = await connection.getEpochInfo();
    console.log(JSON.stringify(epochInfo, null, 2));
  } catch (error) {
    console.error('Error fetching epoch information:', error);
  }
}

getCurrentEpochInfo();

​

2. Obter Informações do Epoch Atual com Compromisso ‘confirmed’

curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getEpochInfo",
    "params": [
      {
        "commitment": "confirmed"
      }
    ]
  }'

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

async function getConfirmedEpochInfo() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const epochInfo = await connection.getEpochInfo('confirmed'); // Or connection.getEpochInfo({ commitment: 'confirmed' });
    console.log(JSON.stringify(epochInfo, null, 2));
  } catch (error) {
    console.error('Error fetching confirmed epoch information:', error);
  }
}

getConfirmedEpochInfo();

​

Dicas para Desenvolvedores

• Níveis de Compromisso: A escolha de commitment pode afetar a pontualidade e a finalidade dos dados. processed é o mais rápido, mas menos seguro, enquanto finalized é o mais seguro, mas pode ter um pequeno atraso. Saiba mais sobre níveis de compromisso para informações detalhadas.
• Disponibilidade do transactionCount: O campo transactionCount pode ser null se o nó não tiver essa informação prontamente disponível ou se não estiver sendo rastreada para o nível de compromisso específico.
• Duração do Epoch: O número de slotsInEpoch pode variar. Você pode usar getEpochSchedule para obter mais detalhes sobre o cronograma do epoch.

​

Métodos Relacionados