So verwenden Sie getEpochInfo

​

Häufige Anwendungsfälle

• Überwachung des Epochenfortschritts: Verfolgen Sie den aktuellen Slot-Index innerhalb der Epoche und die Gesamtanzahl der Slots in der Epoche, um die verbleibende Zeit abzuschätzen.
• Netzwerkanalyse: Erhalten Sie die aktuelle Epochenzahl, die Blockhöhe und die Anzahl der in der aktuellen Epoche verarbeiteten Transaktionen.
• Synchronisationsüberprüfungen: Überprüfen Sie, ob ein Knoten mit dem Netzwerk ausreichend synchronisiert ist, indem Sie seine Epocheninformationen vergleichen.

​

Anforderungsparameter

• commitment (string, optional): Gibt das Commitment-Level an, das beim Abfragen des Ledgers verwendet werden soll.
  • finalized: Der Knoten wird den neuesten Block abfragen, der von der Supermehrheit des Clusters als maximale Sperre bestätigt wurde.
  • confirmed: Der Knoten wird den neuesten Block abfragen, der von einer Supermehrheit des Clusters gewählt wurde.
  • processed: Der Knoten wird seinen neuesten Block abfragen. Beachten Sie, dass der Block möglicherweise nicht vollständig ist.
  • Wenn nicht angegeben, ist das Standard-Commitment finalized.
• minContextSlot (number, optional): Der Mindestslot, bei dem die Anfrage ausgewertet werden kann. Dies kann verwendet werden, um sicherzustellen, dass die Antwort aus einem hinreichend aktuellen Zustand stammt.

​

Antwortstruktur

• absoluteSlot (u64): Die aktuelle absolute Slotnummer.
• blockHeight (u64): Die aktuelle Blockhöhe.
• epoch (u64): Die aktuelle Epochenzahl.
• slotIndex (u64): Der aktuelle Slot relativ zum Beginn der aktuellen Epoche.
• slotsInEpoch (u64): Die Gesamtanzahl der Slots in der aktuellen Epoche.
• transactionCount (u64 | null): Die Gesamtanzahl der in der aktuellen Epoche verarbeiteten Transaktionen. Kann null sein, wenn die Daten nicht verfügbar sind.

​

Beispiele

​

1. Informationen zur aktuellen Epoche abrufen (Keine Parameter)

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. Informationen zur aktuellen Epoche mit “confirmed” Commitment abrufen

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

​

Entwicklertipps

• Commitment-Level: Die Wahl des commitment kann die Aktualität und Endgültigkeit der Daten beeinflussen. processed ist der schnellste, aber am wenigsten sichere, während finalized der sicherste ist, aber möglicherweise etwas verzögert. Erfahren Sie mehr über Commitment-Level, um detaillierte Informationen zu erhalten.
• transactionCount-Verfügbarkeit: Das transactionCount-Feld könnte null sein, wenn der Knoten diese Information nicht direkt verfügbar hat oder wenn sie für das spezifische Commitment-Level nicht verfolgt wird.
• Epochenlänge: Die Anzahl der slotsInEpoch kann variieren. Sie können getEpochSchedule verwenden, um weitere Details zum Epochenzeitplan zu erhalten.

​

Verwandte Methoden