Comment Utiliser getLeaderSchedule

​

Cas d’Utilisation Communes

• Surveillance du Réseau : Observer la distribution des créneaux de leader parmi les validateurs lors d’une époque.
• Routage de Transactions (Avancé) : Certaines applications avancées pourraient essayer de router des transactions vers le leader actuel ou à venir, bien que cela soit généralement géré par le réseau et les nœuds RPC.
• Analyse des Performances des Validateurs : Corréler le calendrier des leaders avec la production réelle de blocs pour évaluer la disponibilité et les performances du validateur.
• Compréhension de la Progression de l’Époque : Voir quels validateurs sont responsables de la production de blocs tout au long d’une époque.

​

Paramètres de Requête

1. slot (u64, optionnel) : Un numéro de créneau. Si fourni, le calendrier des leaders pour l’époque contenant ce créneau sera récupéré. Si null ou omis, le calendrier des leaders pour l’époque actuelle est récupéré.
2. config (objet, optionnel) : Un objet de configuration qui peut contenir :
   • commitment (chaîne, optionnelle) : Spécifie le niveau d’engagement. Si non fourni, l’engagement par défaut du nœud est utilisé.
   • identity (chaîne, optionnelle) : Une clé publique encodée en base-58 d’un validateur. Si fourni, le calendrier retourné inclura uniquement les créneaux attribués à ce validateur spécifique.

​

Structure de Réponse

• null : Si l’époque correspondant au slot demandé (ou époque actuelle si aucun créneau n’est fourni) n’est pas trouvée ou si son calendrier des leaders n’est pas disponible (par exemple, pour une époque future non calculée).
• Un objet : Si un calendrier est trouvé. Cet objet est une carte où :
  • Chaque clé est la clé publique encodée en base-58 (identité) d’un validateur.
  • La valeur correspondante est un tableau de chiffres. Chaque chiffre est un indice de créneau relatif au début de l’époque pour lequel ce validateur est le leader.

​

Exemples

​

1. Obtenir le Calendrier des Leaders pour l’Époque Actuelle

# 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. Obtenir le Calendrier des Leaders pour un Validateur Spécifique dans une Époque Spécifique (par Créneau)

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

​

Conseils pour les Développeurs

• Limites des Époques : Le calendrier des leaders est fixe pour toute une époque. Vous pouvez utiliser getEpochInfo pour trouver les créneaux de début et de fin d’une époque.
• Époques Futures : Demander le calendrier pour une époque très future peut retourner null si le réseau ne l’a pas encore calculé.
• Indices de Créneaux Relatifs : Rappelez-vous que les numéros de créneaux dans la réponse sont relatifs au premier créneau de l’époque demandée, et non des numéros de créneaux absolus sur la blockchain.
• Réponse Important : Pour un calendrier complet d’une époque sans filtre d’identité, la réponse peut être importante, répertoriant tous les validateurs et leurs créneaux assignés.

​

Méthodes Associées