So verwendest du getEpochInfo

​

Häufige Anwendungsfälle

• Fortschritt der Epoche überwachen: Verfolge den aktuellen slot-Index innerhalb der Epoche und die Gesamtzahl der slots in der Epoche, um die verbleibende Zeit abzuschätzen.
• Netzwerkzustand analysieren: Rufe die aktuelle Epochennummer, die Blockhöhe und die Anzahl der in der aktuellen Epoche verarbeiteten Transaktionen ab.
• Synchronisierung prüfen: Prüfe durch einen Vergleich der Epocheninformationen, ob ein node ausreichend mit dem Netzwerk synchronisiert ist.

​

Parameter des request

• commitment (string, optional): Gibt die Stufe des commitment für die Abfrage des Ledgers an.
  • finalized: Der node fragt den neuesten Block ab, für den eine Supermehrheit des cluster bestätigt hat, dass er den maximalen Lockout erreicht hat.
  • confirmed: Der node fragt den neuesten Block ab, über den eine Supermehrheit des cluster abgestimmt hat.
  • processed: Der node fragt seinen neuesten Block ab. Beachte, dass der Block möglicherweise nicht vollständig ist.
  • Wenn du keinen Wert angibst, wird standardmäßig das commitment finalized verwendet.
• minContextSlot (number, optional): Der früheste slot, ab dem der request ausgewertet werden kann. Damit stellst du sicher, dass die response einen ausreichend aktuellen Zustand wiedergibt.

​

Struktur der response

• absoluteSlot (u64): Die aktuelle absolute Nummer des slot.
• blockHeight (u64): Die aktuelle Blockhöhe.
• epoch (u64): Die aktuelle Epochennummer.
• slotIndex (u64): Der aktuelle slot relativ zum Beginn der aktuellen Epoche.
• slotsInEpoch (u64): Die Gesamtzahl der slots in der aktuellen Epoche.
• transactionCount (u64 | null): Die Gesamtzahl 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 dem commitment „confirmed“ 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();

​

Tipps für Entwickler

• Stufen des commitment: Die Wahl von commitment kann beeinflussen, wie aktuell und endgültig die Daten sind. processed ist am schnellsten, aber am wenigsten sicher. finalized ist dagegen am sichersten, kann jedoch leicht verzögert sein. Weitere Details findest du unter Stufen des commitment.
• Verfügbarkeit von transactionCount: Das Feld transactionCount kann null sein, wenn dem node diese Informationen nicht direkt zur Verfügung stehen oder wenn sie für die jeweilige Stufe des commitment nicht erfasst werden.
• Länge der Epoche: Die Anzahl in slotsInEpoch kann variieren. Mit getEpochSchedule erhältst du weitere Details zum Epochenplan.

​

Verwandte Methoden