Cómo usar getEpochInfo

​

Casos de uso comunes

• Monitoreo del progreso de la época: Haz un seguimiento del índice del slot actual dentro de la época y del total de slots de la época para estimar el tiempo restante.
• Análisis del estado de la red: Obtén el número de la época actual, la altura del bloque y la cantidad de transacciones procesadas en la época actual.
• Comprobaciones de sincronización: Verifica si un nodo está razonablemente sincronizado con la red comparando la información de su época.

​

Parámetros de solicitud

• commitment (string, opcional): Especifica el nivel de compromiso que se usará al consultar el libro mayor.
  • finalized: El nodo consultará el bloque más reciente que la supermayoría del clúster haya confirmado como bloque que alcanzó el bloqueo máximo.
  • confirmed: El nodo consultará el bloque más reciente por el que haya votado una supermayoría del clúster.
  • processed: El nodo consultará su bloque más reciente. Ten en cuenta que el bloque podría no estar completo.
  • Si no se proporciona, el nivel de compromiso predeterminado es finalized.
• minContextSlot (number, opcional): El slot mínimo en el que se puede evaluar la solicitud. Puedes usarlo para garantizar que la respuesta provenga de un estado suficientemente reciente.

​

Estructura de la respuesta

• absoluteSlot (u64): El número absoluto del slot actual.
• blockHeight (u64): La altura del bloque actual.
• epoch (u64): El número de la época actual.
• slotIndex (u64): El slot actual en relación con el inicio de la época actual.
• slotsInEpoch (u64): La cantidad total de slots en la época actual.
• transactionCount (u64 | null): La cantidad total de transacciones procesadas en la época actual. Puede ser null si los datos no están disponibles.

​

Ejemplos

​

1. Obtén información sobre la época actual (sin 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. Obtén información sobre la época actual con el nivel de compromiso ‘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();

​

Consejos para desarrolladores

• Niveles de compromiso: La elección de commitment puede afectar la inmediatez y la finalidad de los datos. processed es el más rápido, pero el menos seguro, mientras que finalized es el más seguro, aunque puede tener un ligero retraso. Obtén más información sobre los niveles de compromiso.
• Disponibilidad de transactionCount: El campo transactionCount podría ser null si el nodo no tiene esta información disponible de inmediato o si no se registra para el nivel de compromiso específico.
• Duración de la época: La cantidad de slotsInEpoch puede variar. Puedes usar getEpochSchedule para obtener más detalles sobre el calendario de épocas.

​

Métodos relacionados