Документация по Leader Slot Information API

Что такое Leader Slot Information API (getLeaderSlots)?

getLeaderSlots - это расширенный Solana RPC method, который получает из сети информацию о расписании leader validators. Если у вас есть usage credits ERPC (API tokens), вы можете использовать его в том же формате, что и стандартный Solana RPC call.
Этот API предоставляет следующую информацию:
  • расписание leader validators, начиная с указанного slot
  • предполагаемый регион и geolocation каждого leader
  • эталонные измерения ping (pingToLeaders)

Пример endpoint и request body

text
https://edge.erpc.global?api-key=<YOUR_API_KEY>
Укажите номер начального slot в params.
json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getLeaderSlots",
  "params": [368488568]
}

Пример (HTTP)

bash
curl https://edge.erpc.global?api-key=<YOUR_API_KEY> \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"getLeaderSlots",
    "params":[368488568]
  }'

Пример response (JSON)

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "identity": "DTSUKYHde29PHLy2fBLarsbDdPHQuhZmvjRVuJ2QRC8",
      "epoch": 852,
      "slot": 368488631,
      "ipAddress": "198.73.56.215",
      "gossipPort": 8000,
      "tpuPort": 8003,
      "tpuQuicPort": 8009,
      "rpcAddress": null,
      "version": "0.708.20306",
      "featureSet": "3640012085",
      "pingToLeaders": [
        {
          "city": "Amsterdam",
          "region": "North Holland",
          "ms": 7.687,
          "fromIp": "185.191.118.11",
          "country": "NL",
          "lat": 52.374,
          "lon": 4.8897,
          "org": "AS5552 Serverside.com",
          "postal": "1012",
          "timezone": "Europe/Amsterdam"
        }
      ]
    },
    {
      "identity": "HyperSPG8w4jgdHgmA8ExrhRLL1LBRirRTHDU9FdXJUud",
      "epoch": 852,
      "slot": 368488632,
      "ipAddress": "216.238.85.198",
      "gossipPort": 8001,
      "tpuPort": 9001,
      "tpuQuicPort": 9007,
      "rpcAddress": null,
      "version": "0.708.20306",
      "featureSet": "3640012085",
      "pingToLeaders": [
        {
          "city": "General Lázaro Cárdenas",
          "region": "Querétaro",
          "ms": 136.96,
          "fromIp": "185.191.118.11",
          "country": "MX",
          "lat": 20.5619,
          "lon": -100.2449,
          "org": "AS42473 The Constant Company, LLC",
          "postal": "76264",
          "timezone": "America/Mexico_City"
        }
      ]
    },
    {
      "identity": "HyperSPG8w4jgdHgmA8ExrhRLL1LBRirRTHDU9FdXJUud",
      "epoch": 852,
      "slot": 368488633,
      "ipAddress": "216.238.85.198",
      "gossipPort": 8001,
      "tpuPort": 9001,
      "tpuQuicPort": 9007,
      "rpcAddress": null,
      "version": "0.708.20306",
      "featureSet": "3640012085",
      "pingToLeaders": [
        {
          "city": "General Lázaro Cárdenas",
          "region": "Querétaro",
          "ms": 136.92,
          "fromIp": "185.191.118.11",
          "country": "MX",
          "lat": 20.5619,
          "lon": -100.2449,
          "org": "AS42473 The Constant Company, LLC",
          "postal": "76264",
          "timezone": "America/Mexico_City"
        }
      ]
    }
  ]
}

Расход tokens

Получает 100 записей leader slots, начиная с указанного slot. Каждый request расходует 420 tokens.

Почему информация о leader slots важна

  • Когда leader находится географически далеко (например, >100 ms), прямая доставка transactions становится неэффективной.
  • Во время межконтинентальных переходов leaders (например, FRA -> NY) критично важны стратегии переключения между регионами.
  • Комбинация slot schedule и измеренного ping data позволяет оптимизировать routing и размещение validators.

Background

Один Solana epoch состоит примерно из 432 000 slots. Постоянно пинговать всех validators, хранить и агрегировать эти данные требует дорогостоящей инфраструктуры. ERPC автоматизирует этот процесс и предоставляет готовую к использованию карту leader slots как сервис.

Стратегические use cases

  • Оптимизация detection: приоритизируйте отправку transactions ближайшим leaders с низкой latency
  • Multi-region deployment: размещайтесь в FRA, NY, TY и т.д., чтобы минимизировать gaps при смене slots
  • Визуализация и аналитика: отслеживайте доли leaders и распределение latency по регионам

Доступность

getLeaderSlots доступен всем пользователям ERPC. API tokens (usage credits) можно получить или проверить в Validators DAO Discord.

Успешность transactions и SWQoS Endpoint

Чтобы дополнительно повысить transaction success rate и execution speed, мы рекомендуем использовать SWQoS Endpoint.
SWQoS (Stake-weighted Quality of Service) отдает приоритет validators со stake connections. Leaders выделяют примерно 80 % bandwidth для priority traffic и 20 % для non-priority, а priority lane обеспечивает примерно в 5 раз большую пропускную способность. Это планирование происходит до оценки Priority fee, то есть попадание в priority lane SWQoS - обязательное условие для действительно low-latency performance.