Lider Slot Bilgileri API Dokümantasyonu

Lider Slot Bilgileri (getLeaderSlots) API Nedir?

getLeaderSlots, yaklaşan lider slot kayıtlarını validator kimliği, stake ağırlığı, ağ endpoint metadata'sı, tahmini lider konumu ve referans gecikme ölçümleriyle birlikte döndüren genişletilmiş bir Solana RPC metodudur. ERPC kullanım kredilerine (API token'larına) sahipseniz, bunu standart bir Solana RPC metoduyla aynı formatta çağırabilirsiniz.

Bu API şunları sağlar:

İstenen slottan başlayan lider validator programı
Her lider validator için stakeWeight
Tahmini lider bölgesi, şehir, ülke, koordinatlar, ASN organizasyonu ve saat dilimi
pingToLeaders aracılığıyla ERPC gözlem bölgelerinden referans ping ölçümleri

Endpoint ve İstek Gövdesi Örneği

text

https://edge.erpc.global?api-key=<YOUR_API_KEY>

https://edge.erpc.global?api-key=<YOUR_API_KEY>

Başlangıç slot numarasını params içinde belirtin.

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getLeaderSlots",
  "params": [416462031]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getLeaderSlots",
  "params": [416462031]
}

Örnek (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]
  }'

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]
  }'

Örnek Yanıt (JSON)

Geçerli yanıt, kayıtları result.data[] içinde sarmalar. result.total, kaç kaydın döndürüldüğünü gösterir.

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"
          }
        ]
      }
    ]
  }
}

{
  "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"
          }
        ]
      }
    ]
  }
}

Yanıt Alanları

Alan	Anlamı
`result.success`	İsteğin başarılı olup olmadığı.
`result.message`	İnsan tarafından okunabilir durum mesajı.
`result.total`	Döndürülen lider slot kayıtlarının sayısı. API şu anda istek başına 100 kayıt döndürür.
`result.data[]`	İstenen slottan başlayan sıralı lider slot kayıtları.
`identity`	Lider validator kimlik açık anahtarı.
`epoch`	Slotu içeren Solana epoch'u.
`slot`	Slot numarası. Bir dize (string) olarak döndürülür, bu nedenle istemciler bunu bir JSON sayısı olarak varsaymamalıdır.
`stakeWeight`	Lider validator'a delege edilen stake. Daha yüksek stake genellikle validator'ın zaman içinde lider programlarında daha sık görünmesi anlamına gelir.
`leaderRegion`	Yönlendirme ve analiz için kullanılan normalleştirilmiş operasyonel bölge etiketi. Yakındaki şehirleri veya sağlayıcı konumlarını gruplayabilir.
`leaderCity`, `leaderCountry`, `leaderLat`, `leaderLon`, `leaderOrg`, `leaderTimezone`	Lider validator için tahmini coğrafi konum ve ağ organizasyonu.
`pingToLeaders[]`	ERPC gözlem bölgelerinden lidere referans gecikme; bölge, şehir, ms, fromIp, ülke, koordinatlar, ASN organizasyonu, posta kodu ve saat dilimi dahil.

Lider Slotlarını Görselleştirme

Aynı yanıt, slot-slot operasyonel bir zaman çizelgesi olarak görüntülenebilir. Bu örnek, gözlem noktası olarak Frankfurt'u kullanır.

Slot penceresi	Lider bölgesi	Lider konumu	Stake ağırlığı	Frankfurt'tan ping	Operasyonel yorum
416462031	stockholm	Šiauliai, LT	2,502,391.14	27.742 ms	Makul Avrupa gecikmesi, ancak aynı metropol değil.
416462032-416462035	amsterdam	Amsterdam, NL	280,745.69	16.835 ms	Düşük gecikmeli Avrupa penceresi. Amsterdam kaynakları yararlı olabilir.
416462036	frankfurt	Frankfurt am Main, DE	12,254,651.76	0.974 ms	Aynı bölge lideri. Bu slot için Frankfurt kaynakları güçlü bir şekilde tercih edilir.

Bu görünüm yararlıdır çünkü Solana globaldir. Ana hedefin genellikle tek bir eşleştirme motoruna yakın konumlanmak olduğu geleneksel HFT'nin aksine, Solana liderleri dünyanın dört bir yanındaki validator'lar arasında dönüşümlü olarak değişir. En hızlı bölge, lider programı değiştikçe değişir.

Solana Network Data Website

Validators Solutions - Solana ağ verileri

Validator ve ağ dağılımının kamuya açık bir görünümü için Validators Solutions kullanın. Daha geniş Solana ağını anlamak için bunu kullanın, ardından operasyonel yönlendirme için gereken slot seviyesinde program, stake ağırlığı, validator konumu ve ölçülen gecikme verileri için getLeaderSlots kullanın.

Token Kullanımı

API, belirtilen slottan başlayarak 100 lider slot kaydı alır. Her istek 420 token tüketir.

Lider Slot Bilgileri Neden Önemlidir?

Lider coğrafi olarak veya ağ yolu açısından uzaksa, doğrudan işlem teslimatı verimsiz hale gelir.
Stake ağırlığı, bir validator'ın zaman içinde lider programında ne sıklıkta görünebileceğini tahmin etmeye yardımcı olur.
Küresel lider geçişleri sırasında, bölgesel geçiş stratejileri tek bir küresel ortalama gecikmeden daha önemlidir.
Slot programı, stake ağırlığı, lider konumu ve ölçülen ping verilerinin birleştirilmesi, optimize edilmiş yönlendirme ve validator yerleşimi sağlar.

Arka Plan

Tek bir Solana epoch'u yaklaşık 432,000 slottan oluşur. Lider programlarını, validator metadata'sını, coğrafi konumu ve gecikme ölçümlerini sürekli olarak toplamak, özel bir veri hattı gerektirir. ERPC bu veriyi tutar ve RPC arayüzü üzerinden hemen kullanılabilir bir lider slot haritası olarak sunar.

Stratejik Kullanım Senaryoları

Tespit optimizasyonu: yakındaki, düşük gecikmeli lider pencerelerine öncelik verin.
Çok bölgeli dağıtım: geçiş boşluklarını azaltmak için FRA, AMS, NY, TY, SGP ve diğer stratejik bölgelerde dağıtım yapın.
Stake'e duyarlı planlama: daha uzun pencereler boyunca hangi liderlerin daha sık önemli olduğunu anlamak için stakeWeight kullanın.
Görselleştirme ve analiz: lider oranlarını, stake dağılımını ve bölgeye göre gecikme dağılımını izleyin.

Kullanılabilirlik

getLeaderSlots tüm ERPC kullanıcıları için kullanılabilir. API token'ları ve kullanım kredileri, ERPC Web Dashboard üzerinde verilebilir veya doğrulanabilir.

ERPC Web Dashboard: ERPC Web Dashboard

İşlem Başarı Oranı ve SWQoS Endpoint

İşlem başarı oranını ve yürütme hızını daha da artırmak için SWQoS Endpoint kullanmanızı öneririz. SWQoS (Stake-weighted Quality of Service), stake bağlantıları olan validator'lara öncelik verir. Liderler, bant genişliğinin yaklaşık %80'ini öncelikli trafiğe ve %20'sini öncelikli olmayan trafiğe ayırır; öncelikli şerit yaklaşık 5 kat verim sunar. Bu zamanlama, Priority-fee değerlendirmesinden önce gerçekleşir; bu da SWQoS öncelikli şeridine girmenin, gerçek düşük gecikmeli performansın ön koşulu olduğu anlamına gelir.

Unlimited Endpoint Desteklenen Yöntemler | ERPC

Solana SWQoS Endpoint Documentation