Как использовать getSlotLeaders

​

Распространенные сценарии использования

• Прогнозирование ближайших производителей блоков: Определите, какие валидаторы должны производить блоки в ближайшем будущем для ограниченного диапазона слотов.
• Анализ распределения лидеров: Просмотрите последовательность лидеров для части эпохи.
• Инструменты анализа сети: Инструменты мониторинга и анализа поведения сети могут использовать этот метод для изучения закономерностей назначения лидеров.

​

Параметры запроса

1. startSlot (u64): (Обязательный) Первый слот (включительно), для которого нужно получить расписание лидеров.
2. limit (u64): (Обязательный) Количество последовательных слотов, для которых нужно получить лидеров. Значение должно находиться в диапазоне от 1 до 5 000.

​

Структура ответа

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

​

Примеры

​

1. Получение лидеров слотов для указанного диапазона

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

​

Рекомендации для разработчиков

• Лимит: Параметр limit задает количество лидеров последовательных слотов, которые нужно вернуть, — не более 5 000. Это позволяет просматривать лидеров для значительного количества предстоящих слотов в пределах эпохи.
• Границы эпох: Расписание лидеров определяется для всей эпохи, как подробно описано в нашем руководстве Слоты, блоки и эпохи. Этот метод позволяет запрашивать части такого расписания. Если диапазон пересекает границу эпохи, возвращаемые лидеры по-прежнему будут определяться расписанием той эпохи, к которой относится startSlot, вплоть до указанного вами лимита или конца известного расписания этой эпохи, если узел RPC не выполняет дальнейший расчет для данного вызова.
• Будущие слоты: Вы можете запрашивать лидеров для будущих слотов. Узел RPC вернет назначенных лидеров на основе текущего расписания лидеров для соответствующей эпохи.
• Точность: Расписание лидеров фиксируется на всю эпоху, поэтому возвращаемые сведения о лидерах обычно точны, кроме исключительных ситуаций в сети или изменений в наборе валидаторов, которые могут повлиять на расчеты для последующих эпох.
• Отличие от getLeaderSchedule: В то время как getSlotLeaders возвращает непосредственный список для диапазона, getLeaderSchedule предоставляет полное расписание для всей эпохи, сопоставляя идентификаторы валидаторов со всеми назначенными им слотами в этой эпохе. getSlotLeaders удобнее, если вам нужен только последовательный список для конкретного ограниченного диапазона.

​

Связанные методы