Comment utiliser getSlotLeaders

​

Cas d’utilisation courants

• Prédiction des producteurs de blocs à court terme : Identifiez quels validateurs devraient produire des blocs dans un avenir proche pour une plage limitée de créneaux.
• Analyse de la distribution des leaders : Observez la séquence des leaders pour un segment d’une époque.
• Outils d’analyse du réseau : Les outils qui surveillent ou analysent le comportement du réseau peuvent utiliser cela pour comprendre les modèles de leaders.

​

Paramètres de requête

1. startSlot (u64): (Obligatoire) Le premier créneau (inclus) pour lequel récupérer le calendrier des leaders.
2. limit (u64): (Obligatoire) Le nombre de créneaux consécutifs pour lesquels récupérer les leaders. La limite doit être comprise entre 1 et 5 000.

​

Structure de la réponse

{
  "jsonrpc": "2.0",
  "result": [
    "ValidatorPubkey1XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "ValidatorPubkey2XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "ValidatorPubkey3XXXXXXXXXXXXXXXXXXXXXXXXXXXX"
  ],
  "id": 1
}

​

Exemples

​

1. Obtenir les leaders de créneaux pour une plage spécifique

# Replace <api-key> with your Helius API key
# Replace STARTING_SLOT with a recent or future slot number
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSlotLeaders",
    "params": [
      180000000, 
      5          
    ]
  }'

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

async function getUpcomingSlotLeaders() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  const startSlot = 180000000; // Replace with a recent or future slot number
  const limit = 5;

  try {
    const leaders = await connection.getSlotLeaders(startSlot, limit);
    console.log(`Slot leaders starting from slot ${startSlot} (limit ${limit}):`);
    leaders.forEach((leader, index) => {
      console.log(`  Slot ${startSlot + index}: ${leader}`);
    });
  } catch (error) {
    console.error('Error fetching slot leaders:', error);
  }
}

getUpcomingSlotLeaders();

​

Conseils pour les développeurs

• Limite : Le paramètre limit spécifie combien de leaders consécutifs de créneaux retourner, jusqu’à un maximum de 5 000. Cela signifie que vous pouvez prévoir un nombre important de créneaux au sein d’une époque.
• Limites des époques : Le calendrier des leaders est déterminé pour une époque entière, comme détaillé dans notre guide sur Les créneaux, les blocs et les époques. Cette méthode vous permet de consulter des parties de ce calendrier. Si votre plage traverse une limite d’époque, les leaders retournés seront toujours basés sur le calendrier de l’époque dans laquelle réside startSlot, jusqu’à la limite que vous fournissez ou jusqu’à la fin du calendrier connu de cette époque si le nœud RPC ne prévoit pas plus pour cet appel.
• Créneaux futurs : Vous pouvez demander des leaders pour des créneaux futurs. Le nœud RPC retournera les leaders programmés selon le calendrier actuel des leaders pour l’époque concernée.
• Précision : Le calendrier des leaders est fixe pour une époque, donc les leaders retournés sont généralement précis sauf en cas de circonstances exceptionnelles du réseau ou de changements dans l’ensemble des validateurs qui pourraient affecter les calculs des époques ultérieures.
• Distinction par rapport à getLeaderSchedule : Tandis que getSlotLeaders vous donne une liste directe pour une plage, getLeaderSchedule fournit le calendrier complet pour une époque entière, mappant les identités des validateurs à tous leurs créneaux assignés à l’intérieur de cette époque. getSlotLeaders est plus direct si vous avez seulement besoin d’une liste séquentielle pour une plage spécifique et limitée.

​

Méthodes connexes