Tài liệu API thông tin Leader Slot

API thông tin Leader Slot (getLeaderSlots) là gì?

getLeaderSlots là phương thức Solana RPC mở rộng trả về các bản ghi leader slot sắp tới, bao gồm validator identity, stake weight, metadata endpoint mạng, vị trí leader ước tính và số đo latency tham chiếu. Nếu bạn có credit sử dụng ERPC (API token), bạn có thể gọi phương thức này với cùng định dạng như Solana RPC tiêu chuẩn.
API này cung cấp:
  • Lịch trình validator leader bắt đầu từ slot được chỉ định
  • stakeWeight của từng validator leader
  • Region, city, country, tọa độ, ASN organization và timezone ước tính của leader
  • Số đo ping tham chiếu từ các region quan sát của ERPC qua pingToLeaders

Endpoint và ví dụ Request Body

text
https://edge.erpc.global?api-key=<YOUR_API_KEY>
Chỉ định slot bắt đầu trong params.
json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getLeaderSlots",
  "params": [416462031]
}

Ví dụ (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]
  }'

Ví dụ Response (JSON)

Response hiện tại đặt các bản ghi trong result.data[]. result.total cho biết số lượng bản ghi được trả về.
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"
          }
        ]
      }
    ]
  }
}

Trường trong response

TrườngÝ nghĩa
result.successWhether the request succeeded.
result.messageHuman-readable status message.
result.totalNumber of returned leader slot records. The API currently returns 100 records per request.
result.data[]Ordered leader slot records starting from the requested slot.
identityLeader validator identity public key.
epochSolana epoch containing the slot.
slotSlot number. It is returned as a string, so clients should not assume a JSON number.
stakeWeightStake delegated to the leader validator. Higher stake generally means the validator appears in leader schedules more often over time.
leaderRegionNormalized operational region label used for routing and analysis. It may group nearby cities or provider locations.
leaderCity, leaderCountry, leaderLat, leaderLon, leaderOrg, leaderTimezoneEstimated geolocation and network organization for the leader validator.
pingToLeaders[]Reference latency from ERPC observation regions to the leader, including region, city, ms, fromIp, country, coordinates, ASN organization, postal code, and timezone.

Hiển thị Leader Slot trực quan

Cùng một response có thể được đọc như timeline vận hành theo từng slot. Ví dụ dưới đây dùng Frankfurt làm điểm quan sát.
Cửa sổ slotLeader regionVị trí leaderStake weightPing từ FrankfurtCách đọc vận hành
416462031stockholmŠiauliai, LT2,502,391.1427.742 msLatency trong châu Âu hợp lý, nhưng không cùng metro.
416462032-416462035amsterdamAmsterdam, NL280,745.6916.835 msCửa sổ châu Âu latency thấp. Tài nguyên Amsterdam có thể hữu ích.
416462036frankfurtFrankfurt am Main, DE12,254,651.760.974 msLeader cùng region. Tài nguyên Frankfurt có lợi thế rõ rệt.
Điều này quan trọng vì Solana là mạng toàn cầu. Khác với HFT truyền thống, nơi mục tiêu thường là ở gần một matching engine, leader của Solana luân phiên giữa các validator trên toàn thế giới. Region nhanh nhất thay đổi theo leader schedule.

Website dữ liệu mạng Solana

Validators Solutions - Solana network data
Để xem phân bố validator và mạng công khai, hãy dùng Validators Solutions. Dùng nó để hiểu bức tranh Solana rộng hơn, sau đó dùng getLeaderSlots cho lịch trình cấp slot, stake weight, vị trí validator và latency đo được phục vụ routing vận hành.

Sử dụng token

API lấy 100 bản ghi leader slot bắt đầu từ slot được chỉ định. Mỗi request tiêu thụ 420 tokens.

Vì sao thông tin Leader Slot quan trọng

  • Nếu leader xa về địa lý hoặc đường mạng, direct transaction delivery trở nên kém hiệu quả.
  • Stake weight giúp ước lượng validator nào có khả năng xuất hiện thường xuyên hơn trong leader schedule theo thời gian.
  • Trong các chuyển đổi leader toàn cầu, chiến lược chuyển region quan trọng hơn một con số latency trung bình toàn cầu.
  • Kết hợp slot schedule, stake weight, vị trí leader và ping đo được giúp tối ưu routing và vị trí hạ tầng.

Bối cảnh

Một Solana epoch có khoảng 432.000 slots. Việc thu thập liên tục leader schedule, validator metadata, geolocation và latency measurement cần một datapipeline chuyên dụng. ERPC duy trì dữ liệu này và cung cấp nó qua RPC như một leader slot map có thể dùng ngay.

Trường hợp sử dụng chiến lược

  • Tối ưu phát hiện: ưu tiên các leader window gần và latency thấp.
  • Triển khai đa region: đặt tài nguyên tại FRA, AMS, NY, TY, SGP và các region chiến lược khác để giảm khoảng trống khi chuyển leader.
  • Lập kế hoạch theo stake: dùng stakeWeight để hiểu leader nào thường quan trọng hơn trong khung thời gian dài.
  • Visualization và analytics: theo dõi leader ratio, stake distribution và latency distribution theo region.

Khả dụng

getLeaderSlots khả dụng cho tất cả người dùng ERPC. API token và credit sử dụng có thể được phát hành hoặc kiểm tra trên ERPC Web Dashboard.

Tỷ lệ thành công giao dịch và SWQoS Endpoint

Để cải thiện thêm tỷ lệ thành công giao dịch và tốc độ thực thi, chúng tôi khuyến nghị sử dụng SWQoS Endpoint. SWQoS (Stake-weighted Quality of Service) ưu tiên các validator có stake connection. Leader phân bổ khoảng 80% bandwidth cho priority traffic và 20% cho non-priority traffic; priority lane có throughput khoảng 5x. Scheduling này diễn ra trước khi đánh giá Priority fee, nghĩa là vào được SWQoS priority lane là điều kiện nền tảng cho hiệu năng low-latency thực sự.