ERPC

リーダースロット情報 API ドキュメント

リーダースロット情報 (getLeaderSlots) API とは

getLeaderSlots は、今後のリーダースロットについて、バリデータ identity、ステーク量、ネットワークエンドポイント情報、推定リーダー位置、参考レイテンシ計測を返す Solana 拡張 RPC メソッドです。ERPC の利用クレジット（API トークン）をお持ちの方は、通常の Solana RPC と同じ形式で呼び出せます。
取得できる主な情報:
  • 指定スロット以降のリーダーバリデータスケジュール
  • 各リーダーバリデータの stakeWeight
  • 推定リーダーリージョン、都市、国、緯度経度、ASN 組織、タイムゾーン
  • ERPC の観測リージョンからリーダーへの参考 ping 計測（pingToLeaders）

エンドポイントとリクエストボディ例

text
https://edge.erpc.global?api-key=<YOUR_API_KEY>
params に開始スロット番号を指定します。
json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getLeaderSlots",
  "params": [416462031]
}

使用例（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":[416462031]
  }'

レスポンス例（JSON）

現在のレスポンスでは、スロット情報は result.data[] に入ります。result.total は返却された件数です。
json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "success": true,
    "message": "Leader schedule records retrieved successfully",
    "total": 100,
    "data": [
      {
        "identity": "BSVckjdW2f8kcXPGcrPPtV9kUDBZ8w8PjrrGVnxgEdwq",
        "epoch": 964,
        "slot": "416462031",
        "stakeWeight": 2502391.138720913,
        "ipAddress": "5.199.172.175",
        "gossipPort": 12000,
        "tpuPort": 12003,
        "tpuQuicPort": 12009,
        "rpcAddress": null,
        "version": "3.1.13",
        "featureSet": "534737035",
        "leaderRegion": "stockholm",
        "leaderCity": "Šiauliai",
        "leaderCountry": "LT",
        "leaderLat": 55.93333,
        "leaderLon": 23.31667,
        "leaderOrg": "AS16125 UAB Cherry Servers",
        "leaderTimezone": "Europe/Vilnius",
        "pingToLeaders": [
          {
            "city": "Frankfurt am Main",
            "region": "frankfurt",
            "ms": 27.742,
            "fromIp": "185.191.118.11",
            "country": "DE",
            "lat": 50.139,
            "lon": 8.6725,
            "org": "AS213896 UAB Cherry Servers",
            "postal": "60320",
            "timezone": "Europe/Berlin"
          }
        ]
      },
      {
        "identity": "2oHUYyW2PU9VJh4XBs5TbGgzdernunvGqyKth3kxW4ns",
        "epoch": 964,
        "slot": "416462032",
        "stakeWeight": 280745.689124988,
        "ipAddress": "64.130.43.229",
        "gossipPort": 8001,
        "tpuPort": 5004,
        "tpuQuicPort": 5010,
        "rpcAddress": null,
        "version": "3.1.13",
        "featureSet": "534737035",
        "leaderRegion": "amsterdam",
        "leaderCity": "Amsterdam",
        "leaderCountry": "NL",
        "leaderLat": 52.37403,
        "leaderLon": 4.88969,
        "leaderOrg": "AS20326 TeraSwitch Networks Inc.",
        "leaderTimezone": "Europe/Amsterdam",
        "pingToLeaders": [
          {
            "city": "Frankfurt am Main",
            "region": "frankfurt",
            "ms": 16.835,
            "fromIp": "185.191.118.11",
            "country": "DE",
            "lat": 50.139,
            "lon": 8.6725,
            "org": "AS213896 UAB Cherry Servers",
            "postal": "60320",
            "timezone": "Europe/Berlin"
          }
        ]
      },
      {
        "identity": "JupmVLmA8RoyTUbTMMuTtoPWHEiNQobxgTeGTrPNkzT",
        "epoch": 964,
        "slot": "416462036",
        "stakeWeight": 12254651.761860535,
        "ipAddress": "64.130.41.46",
        "gossipPort": 8000,
        "tpuPort": 9001,
        "tpuQuicPort": 9007,
        "rpcAddress": null,
        "version": "3.1.13",
        "featureSet": "534737035",
        "leaderRegion": "frankfurt",
        "leaderCity": "Frankfurt am Main",
        "leaderCountry": "DE",
        "leaderLat": 50.1924,
        "leaderLon": 8.6753,
        "leaderOrg": "AS20326 TeraSwitch Networks Inc.",
        "leaderTimezone": "Europe/Berlin",
        "pingToLeaders": [
          {
            "city": "Frankfurt am Main",
            "region": "frankfurt",
            "ms": 0.974,
            "fromIp": "185.191.118.11",
            "country": "DE",
            "lat": 50.139,
            "lon": 8.6725,
            "org": "AS213896 UAB Cherry Servers",
            "postal": "60320",
            "timezone": "Europe/Berlin"
          }
        ]
      }
    ]
  }
}

レスポンスフィールド

フィールド意味
result.successリクエストが成功したかどうか。
result.messageステータスメッセージ。
result.total返却されたリーダースロット件数。現在は 1 リクエストあたり 100 件です。
result.data[]指定スロット以降のリーダースロットレコード。
identityリーダーバリデータの identity public key。
epoch対象スロットが含まれる Solana epoch。
slotスロット番号。JSON number ではなく文字列として返るため、クライアント側でも文字列として扱うのが安全です。
stakeWeightリーダーバリデータに委任されているステーク量。ステークが大きいほど、長い時間軸ではリーダーに選ばれる頻度が高くなりやすいです。
leaderRegionルーティングや分析に使う正規化済みリージョン名。近い都市やプロバイダ拠点をまとめる場合があります。
leaderCity, leaderCountry, leaderLat, leaderLon, leaderOrg, leaderTimezoneリーダーバリデータの推定地理情報とネットワーク組織。
pingToLeaders[]ERPC の観測リージョンからリーダーへの参考レイテンシ。region、city、ms、fromIp、国、緯度経度、ASN 組織、郵便番号、タイムゾーンを含みます。

リーダースロットを視覚的に見る

同じレスポンスは、スロットごとの運用タイムラインとして見ると分かりやすくなります。以下はフランクフルトを観測地点にした例です。
スロット範囲リーダーリージョンリーダー位置ステーク量Frankfurt からの ping読み取り方
416462031stockholmŠiauliai, LT2,502,391.1427.742 ms欧州内としては十分近いが、同一メトロではない。
416462032-416462035amsterdamAmsterdam, NL280,745.6916.835 ms低レイテンシの欧州ウィンドウ。Amsterdam 拠点が有利になりやすい。
416462036frankfurtFrankfurt am Main, DE12,254,651.760.974 ms同一リージョンのリーダー。Frankfurt 拠点が強く有利。
この見方が重要なのは、Solana がグローバルに動作するためです。従来型 HFT のように一つの取引所マッチングエンジン近くに置けば終わりではなく、Solana では世界中のバリデータ間でリーダーが交代します。そのため、最速に近いリージョンもリーダースケジュールに合わせて変わります。

Solana ネットワークデータサイト

Validators Solutions - Solana ネットワークデータ
バリデータ分布やネットワーク全体の公開情報を確認するには、Validators Solutions を利用できます。Solana ネットワーク全体の分布を Validators Solutions で把握し、スロット単位のリーダースケジュール、ステーク量、バリデータ位置、実測レイテンシが必要な運用判断には getLeaderSlots を使います。

トークン使用量

指定したスロットから 100 件のリーダースロット情報を取得します。1 回のリクエストにつき 420 トークンを使用します。

なぜリーダースロット情報が重要か

  • リーダーの物理距離やネットワーク経路が遠い場合、直接送信は不利になりやすい。
  • ステーク量を見ることで、長い時間軸でどのバリデータがリーダーに現れやすいかを把握できる。
  • グローバルなリーダー交代では、単一の平均レイテンシよりもリージョン切替戦略が重要になる。
  • スロットスケジュール、ステーク量、リーダー位置、実測 ping を組み合わせることで、送信先と配置を最適化できる。

背景

Solana の 1 epoch は約 432,000 スロットです。リーダースケジュール、バリデータメタデータ、地理情報、レイテンシ計測を継続的に収集するには専用のデータ基盤が必要です。ERPC ではこれを整備し、即利用できるリーダースロットマップとして RPC 経由で提供しています。

戦略的活用例

  • 検知最適化: 近距離、低 ms のリーダーウィンドウを優先する。
  • 多拠点化: FRA、AMS、NY、TY、SGP などに拠点を置き、リーダー交代時の取りこぼしを減らす。
  • ステーク考慮: stakeWeight を使い、長い時間軸で重要度が高いリーダーを把握する。
  • 可視化・分析: リージョン別のリーダー比率、ステーク分布、レイテンシ分布を監視する。

利用条件

getLeaderSlots は ERPC の全ユーザーが利用可能です。API トークン（利用クレジット）は ERPC Web ダッシュボードで発行・確認できます。

トランザクション成功率と SWQoS エンドポイント

トランザクションの成功率と実行速度をさらに高めるには、SWQoS エンドポイントの利用をおすすめします。SWQoS（Stake-weighted Quality of Service）は、ステーク接続を持つバリデータを優先する仕組みです。リーダーは帯域の約 80% を優先帯域、約 20% を非優先帯域に割り当て、優先帯域は非優先の約 5 倍の throughput を持ちます。このスケジューリングは Priority fee の評価より前に適用されるため、まず SWQoS の優先レーンに乗ることが低レイテンシ処理の前提になります。

前へ

Solana MCP サーバー (ERPC Solana RPC)

次へ

Solana SWQoS エンドポイント ドキュメント