Comment utiliser getEpochInfo

​

Cas d’utilisation courants

• Suivi de la progression de l’époque : Suivez l’index de slot actuel dans l’époque et le nombre total de slots dans l’époque pour estimer le temps restant.
• Analyse de l’état du réseau : Obtenez le numéro de l’époque actuelle, la hauteur du bloc et le nombre de transactions traitées dans l’époque actuelle.
• Vérifications de synchronisation : Vérifiez si un nœud est raisonnablement synchronisé avec le réseau en comparant ses informations d’époque.

​

Paramètres de requête

• commitment (string, optional) : Spécifie le niveau d’engagement à utiliser lors de la requête au grand livre.
  • finalized : Le nœud interrogera le bloc le plus récent confirmé par la supermajorité du cluster comme ayant atteint le blocage maximum.
  • confirmed : Le nœud interrogera le bloc le plus récent qui a été voté par une supermajorité du cluster.
  • processed : Le nœud interrogera son bloc le plus récent. Notez que le bloc peut ne pas être complet.
  • Si non fourni, l’engagement par défaut est finalized.
• minContextSlot (number, optional) : Le slot minimum auquel la requête peut être évaluée. Cela peut être utilisé pour s’assurer que la réponse provient d’un état suffisamment récent.

​

Structure de la réponse

• absoluteSlot (u64) : Le numéro de slot absolu actuel.
• blockHeight (u64) : La hauteur actuelle du bloc.
• epoch (u64) : Le numéro de l’époque actuelle.
• slotIndex (u64) : Le slot actuel par rapport au début de l’époque actuelle.
• slotsInEpoch (u64) : Le nombre total de slots dans l’époque actuelle.
• transactionCount (u64 | null) : Le nombre total de transactions traitées dans l’époque actuelle. Peut être null si les données ne sont pas disponibles.

​

Exemples

​

1. Obtenir les informations de l’époque actuelle (aucun paramètre)

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. Obtenir les informations de l’époque actuelle avec un engagement ‘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();

​

Conseils pour les développeurs

• Niveaux d’engagement : Le choix de commitment peut affecter l’actualité et la finalité des données. processed est le plus rapide mais le moins sûr, tandis que finalized est le plus sûr mais peut avoir un léger retard. Apprenez-en plus sur les niveaux d’engagement pour des informations détaillées.
• Disponibilité de transactionCount : Le champ transactionCount pourrait être null si le nœud n’a pas cette information facilement disponible ou si elle n’est pas suivie pour le niveau d’engagement spécifique.
• Longueur de l’époque : Le nombre de slotsInEpoch peut varier. Vous pouvez utiliser getEpochSchedule pour obtenir plus de détails sur le calendrier de l’époque.

​

Méthodes associées