So verwenden Sie getLeaderSchedule

​

Häufige Anwendungsfälle

• Netzwerküberwachung: Beobachten Sie die Verteilung der Leader-Slots unter Validierern in einer Epoche.
• Transaktionsweiterleitung (Fortgeschritten): Einige fortgeschrittene Anwendungen könnten versuchen, Transaktionen zum aktuellen oder kommenden Leader zu leiten, obwohl dies im Allgemeinen vom Netzwerk und den RPC-Knoten gehandhabt wird.
• Validator-Leistungsanalyse: Korrelieren Sie den Leader-Zeitplan mit der tatsächlichen Blockproduktion, um die Betriebszeit und Leistung des Validators zu bewerten.
• Verständnis der Epoch-Fortschreitung: Sehen Sie, welche Validierer während einer Epoche für die Blockproduktion verantwortlich sind.

​

Anfrageparameter

1. slot (u64, optional): Eine Slotnummer. Wenn angegeben, wird der Leader-Zeitplan für die Epoche, die diesen Slot enthält, abgerufen. Wenn null oder weggelassen, wird der Leader-Zeitplan für die aktuelle Epoche abgerufen.
2. config (Objekt, optional): Ein Konfigurationsobjekt, das Folgendes enthalten kann:
   • commitment (String, optional): Gibt das Commitment-Level an. Wenn nicht bereitgestellt, wird das Standard-Commitment des Knotens verwendet.
   • identity (String, optional): Ein base-58-kodierter öffentlicher Schlüssel eines Validators. Wenn angegeben, enthält der zurückgegebene Zeitplan nur Slots, die diesem speziellen Validator zugewiesen sind.

​

Antwortstruktur

• null: Wenn die Epoche, die der angeforderten slot (oder aktuellen Epoche, wenn kein Slot bereitgestellt wird) entspricht, nicht gefunden wird oder ihr Leader-Zeitplan nicht verfügbar ist (z.B. für eine zukünftige, nicht berechnete Epoche).
• Ein Objekt: Wenn ein Zeitplan gefunden wird. Dieses Objekt ist eine Karte, bei der:
  • Jeder Schlüssel der base-58-kodierte öffentliche Schlüssel (Identität) eines Validators ist.
  • Der entsprechende Wert ein Array von Zahlen ist. Jede Zahl ist ein Slot-Index relativ zum Beginn der Epoche, für den dieser Validator der Leader ist.

​

Beispiele

​

1. Abrufen des Leader-Zeitplans für die aktuelle Epoche

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

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function fetchCurrentLeaderSchedule() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const leaderSchedule = await connection.getLeaderSchedule(); // Fetches for current epoch by default
    if (leaderSchedule) {
      console.log('Leader Schedule for Current Epoch:');
      for (const [validatorIdentity, slots] of Object.entries(leaderSchedule)) {
        console.log(`  Validator: ${validatorIdentity}`);
        console.log(`    Slots (relative to epoch start): ${slots.join(', ')}`);
      }
    } else {
      console.log('Leader schedule for the current epoch not found or not yet available.');
    }
    // console.log(JSON.stringify(leaderSchedule, null, 2));
  } catch (error) {
    console.error('Error fetching leader schedule:', error);
  }
}

fetchCurrentLeaderSchedule();

​

2. Abrufen des Leader-Zeitplans für einen bestimmten Validator in einer bestimmten Epoche (nach Slot)

# Replace <api-key> with your Helius API key
# Replace VALIDATOR_PUBKEY with an actual validator identity public key
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getLeaderSchedule",
    "params": [
      200000,
      { "identity": "VALIDATOR_PUBKEY" }
    ]
  }'

// Replace <api-key> with your Helius API key
// Replace VALIDATOR_PUBKEY with an actual validator identity public key
const { Connection, PublicKey } = require('@solana/web3.js');

async function fetchValidatorEpochSchedule() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  const targetSlot = 200000;
  const validatorIdentity = 'VALIDATOR_PUBKEY'; // e.g., 'Vote111111111111111111111111111111111111111'

  try {
    const leaderSchedule = await connection.getLeaderSchedule(targetSlot, { identity: validatorIdentity });
    if (leaderSchedule && leaderSchedule[validatorIdentity]) {
      console.log(`Leader Schedule for Validator ${validatorIdentity} in epoch of slot ${targetSlot}:`);
      console.log(`  Slots (relative to epoch start): ${leaderSchedule[validatorIdentity].join(', ')}`);
    } else {
      console.log(`No leader slots found for validator ${validatorIdentity} in epoch of slot ${targetSlot}, or schedule not available.`);
    }
    // console.log(JSON.stringify(leaderSchedule, null, 2));
  } catch (error) {
    console.error('Error fetching validator leader schedule:', error);
  }
}

fetchValidatorEpochSchedule();

​

Entwicklertipps

• Epochengrenzen: Der Leader-Zeitplan ist für eine gesamte Epoche festgelegt. Sie können getEpochInfo verwenden, um die Start- und End-Slots einer Epoche zu finden.
• Zukünftige Epochen: Das Anfordern des Zeitplans für eine weit in der Zukunft liegende Epoche könnte null zurückgeben, wenn das Netzwerk ihn noch nicht berechnet hat.
• Relative Slot-Indizes: Denken Sie daran, dass die Slots in der Antwort relativ zum ersten Slot der angeforderten Epoche und nicht absolute Slotnummern in der Blockchain sind.
• Große Antwort: Für einen vollständigen Epoch-Zeitplan ohne Identitätsfilter kann die Antwort groß sein, da alle Validierer und ihre zugewiesenen Slots aufgelistet werden.

​

Verwandte Methoden