Documentation de l'API d'information sur les slots leaders

Qu'est-ce que l'API Leader Slot (getLeaderSlots)?

getLeaderSlots est une méthode Solana RPC étendue qui renvoie les prochains slots leaders avec l'identité du validateur, le poids de stake, les métadonnées d'endpoint réseau, l'emplacement estimé du leader et des mesures de latence de référence. Si vous disposez de crédits d'utilisation ERPC (tokens API), vous pouvez l'appeler au même format qu'une méthode Solana RPC standard.
Cette API fournit:
  • Planning des validateurs leaders à partir du slot demandé
  • stakeWeight pour chaque validateur leader
  • Région, ville, pays, coordonnées, organisation ASN et fuseau horaire estimés du leader
  • Mesures de ping de référence depuis les régions d'observation ERPC via pingToLeaders

Exemple d'endpoint et de corps de requête

text
https://edge.erpc.global?api-key=<YOUR_API_KEY>
Spécifiez le numéro du slot de départ dans params.
json
{
 "jsonrpc": "2.0",
 "id": 1,
 "method": "getLeaderSlots",
 "params": [416462031]
}

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

Exemple de réponse (JSON)

La réponse actuelle enveloppe les enregistrements dans result.data[]. result.total indique le nombre d'enregistrements renvoyés.
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"
 }
 ]
 }
 ]
 }
}

Champs de réponse

ChampSignification
result.successIndique si la requête a réussi.
result.messageMessage de statut lisible par un humain.
result.totalNombre d'enregistrements de slots leaders renvoyés. L'API renvoie actuellement 100 enregistrements par requête.
result.data[]Enregistrements de slots leaders ordonnés à partir du slot demandé.
identityClé publique d'identité du validateur leader.
epochÉpoque Solana contenant le slot.
slotNuméro du slot. Il est renvoyé sous forme de chaîne, les clients ne doivent donc pas supposer qu'il s'agit d'un nombre JSON.
stakeWeightStake délégué au validateur leader. Un stake plus élevé signifie généralement que le validateur apparaît plus souvent dans les plannings leaders au fil du temps.
leaderRegionLibellé de région opérationnelle normalisé, utilisé pour le routage et l'analyse. Il peut regrouper des villes proches ou des emplacements de fournisseurs.
leaderCity, leaderCountry, leaderLat, leaderLon, leaderOrg, leaderTimezoneGéolocalisation et organisation réseau estimées du validateur leader.
pingToLeaders[]Latence de référence depuis les régions d'observation ERPC vers le leader, avec région, ville, ms, fromIp, pays, coordonnées, organisation ASN, code postal et fuseau horaire.

Visualisation des slots leaders

La même réponse peut être visualisée comme une chronologie opérationnelle slot par slot. Cet exemple utilise Francfort comme point d'observation.
Fenêtre de slotRégion leaderLieu du leaderPoids de stakePing de FrancfortLecture opérationnelle
416462031stockholmŠiauliai, LT2,502,391.1427.742 msLatence européenne raisonnable, mais pas dans la même métropole.
416462032-416462035AmsterdamAmsterdam, NL280,745.6916.835 msFenêtre européenne à faible latence. Les ressources d'Amsterdam peuvent être utiles.
416462036frankfurtFrankfurt am Main, DE12,254,651.760.974 msLeader dans la même région. Les ressources de Francfort sont fortement favorisées pour ce slot.
Cette vue est utile parce que Solana est un réseau mondial. Contrairement au HFT traditionnel, où l'objectif principal consiste souvent à se placer près d'un matching engine, les leaders Solana tournent entre des validateurs répartis dans le monde entier. La région la plus rapide change donc avec le planning des leaders.

Site Web des données du réseau Solana

Validators Solutions - Solana network data
Pour une vue publique de la distribution des validateurs et du réseau, utilisez Validators Solutions. Servez-vous-en pour comprendre le réseau Solana dans son ensemble, puis utilisez getLeaderSlots pour obtenir le planning au niveau du slot, le poids de stake, l'emplacement des validateurs et les données de latence mesurées nécessaires au routage opérationnel.

Utilisation des jetons

L'API récupère 100 enregistrements de slots leaders à partir du slot spécifié. Chaque requête consomme 420 tokens.

Pourquoi l'information sur les slots leaders compte-t-elle?

  • Si le leader est éloigné géographiquement ou en réseau, la livraison directe des transactions devient inefficace.
  • Le poids de stake aide à estimer la fréquence à laquelle un validateur est susceptible d'apparaître dans le planning des leaders au fil du temps.
  • Lors des transitions entre leaders mondiaux, les stratégies de bascule régionale comptent davantage qu'une simple latence moyenne globale.
  • La combinaison du planning des slots, du poids de stake, de l'emplacement du leader et des données de ping mesurées permet d'optimiser le routage et le placement des validateurs.

Historique

Une époque Solana comprend environ 432 000 slots. Collecter en continu les plannings des leaders, les métadonnées des validateurs, la géolocalisation et les mesures de latence exige un pipeline de données dédié. ERPC maintient ces données et les expose via l'interface RPC sous forme de carte des slots leaders immédiatement exploitable.

Cas d'utilisation stratégique

  • Optimisation de la détection: prioriser les fenêtres de leaders proches et à faible latence.
  • Déploiement multi-régions: déployer en FRA, AMS, NY, TY, SGP et dans d'autres régions stratégiques pour réduire les écarts lors des transitions.
  • Planification fondée sur stakeWeight: comprendre quels leaders comptent le plus souvent sur des fenêtres longues.
  • Visualisation et analyse: surveiller les ratios de leaders, la répartition du stake et la distribution des latences par région.

Disponibilité

getLeaderSlots est disponible pour tous les utilisateurs ERPC. Les tokens API et les crédits d'utilisation peuvent être émis ou vérifiés depuis le tableau de bord Web ERPC.

Taux de réussite des transactions et endpoint SWQoS

Pour améliorer encore le taux de réussite des transactions et la vitesse d'exécution, nous recommandons d'utiliser le SWQoS Endpoint. SWQoS (Stake-weighted Quality of Service) donne la priorité aux validateurs disposant de connexions pondérées par le stake. Les leaders attribuent environ 80 % de la bande passante au trafic prioritaire et 20 % au trafic non prioritaire, la voie prioritaire offrant un débit d'environ 5x. Cette allocation intervient avant l'évaluation des frais de priorité: l'accès à la voie prioritaire SWQoS est donc une condition préalable pour obtenir de vraies performances à faible latence.