Skip to main content
Die getSlot RPC-Methode gibt den aktuellen Slot zurück, den der RPC-Knoten als einen bestimmten Verpflichtungsgrad erreicht betrachtet. Dies ist eine grundlegende Methode, um den aktuellen Stand der Blockchain zu verstehen, so wie er vom Knoten wahrgenommen wird.

Allgemeine Anwendungsfälle

  • Aktuellen Netzwerkfortschritt abrufen: Bestimmen Sie den zuletzt verarbeiteten oder vom Knoten bestätigten Slot.
  • Synchronisationsprüfung des Knotens: Der Vergleich des Slots von verschiedenen Knoten kann einen Hinweis auf ihren Synchronisationsstatus geben.
  • Zeitstempelung von Operationen: Verwenden Sie den aktuellen Slot als Referenzpunkt für Operationen oder um das Alter bestimmter Daten zu verstehen.
  • Eingabe für andere RPC-Anfragen: Einige RPC-Methoden könnten eine Slot-Nummer als Referenzpunkt verwenden.

Anforderungsparameter

Diese Methode nimmt ein optionales Konfigurationsobjekt als ersten Parameter entgegen:
  1. options (object, optional): Ein optionales Konfigurationsobjekt mit den folgenden Feldern:
    • commitment (string, optional): Gibt das Verpflichtungsniveau für die Anfrage an. Unterstützte Werte sind finalized, confirmed oder processed. Wenn weggelassen, wird das Standardverpflichtungsniveau des RPC-Knotens verwendet (normalerweise finalized).
      • processed: Der Knoten wird seinen neuesten Slot abfragen. Beachten Sie, dass dieser Slot möglicherweise noch nicht vom Cluster bestätigt wurde und potenziell übersprungen werden könnte.
      • confirmed: Der Knoten wird den neuesten Slot abfragen, auf den von einer Supermehrheit des Clusters abgestimmt wurde.
      • finalized: Der Knoten wird den neuesten Slot abfragen, der von der Supermehrheit des Clusters als maximal gesperrt bestätigt wurde (kann nicht zurückgesetzt werden).
    • minContextSlot (number, optional): Der minimale Slot, bei dem die Anfrage ausgewertet werden kann. Dies setzt den Mindestslot für den Kontext des Knotens fest. Wenn der Zustand des Knotens älter als dieser Slot ist, könnte er einen Fehler oder eine Slot-Nummer zurückgeben, die seinen aktuellen (älteren) Zustand relativ zu diesem Minimum widerspiegelt.

Antwortstruktur

Das result Feld der JSON-RPC-Antwort ist ein einzelner u64 (ungesichertes 64-Bit-Integer), der die aktuelle Slot-Nummer entsprechend dem angegebenen Verpflichtungsniveau darstellt. Beispielantwort:

Beispiele

1. Aktuellen Slot abrufen (Standardverpflichtung)

Dieses Beispiel ruft den aktuellen Slot mit dem Standardverpflichtungsniveau des Knotens ab (normalerweise finalized).

2. Aktuellen Slot mit spezifischer Verpflichtung abrufen

Dieses Beispiel ruft den aktuellen Slot ab, der das confirmed Verpflichtungsniveau erreicht hat.

Entwickler-Tipps

  • Verpflichtung ist wichtig: Die zurückgegebene Slot-Nummer hängt stark vom angegebenen commitment Niveau ab. Siehe Solana Commitment Levels für detaillierte Informationen. processed wird der höchste (neueste) Slot sein, den der Knoten kennt, während finalized ein älterer Slot sein wird, der vom gesamten Netzwerk bestätigt wurde. Wählen Sie das Verpflichtungsniveau, das den Anforderungen Ihres Anwendungsfalls an Datenfinalität entspricht.
  • Knotenvariabilität: Verschiedene RPC-Knoten könnten leicht unterschiedliche Slot-Nummern für dasselbe Verpflichtungsniveau aufgrund von Netzwerkverzögerungen oder ihrem eigenen Verarbeitungszustand zurückgeben. Dies ist besonders für processed und confirmed Levels zutreffend.
  • minContextSlot: Dieser Parameter stellt sicher, dass der Knoten, der Ihre Anfrage verarbeitet, mindestens den minContextSlot erreicht hat. Wenn der Knoten hinter diesem Slot liegt, kann das Verhalten variieren (z. B. ein Fehler oder der aktuelle höchste Slot des Knotens, der kleiner ist als minContextSlot). Er wird allgemein in fortgeschrittenen Szenarien verwendet, in denen Sie sicherstellen müssen, dass eine Abfrage gegen einen ausreichend aktuellen Zustand ausgeführt wird.
getSlot ist eine einfache, aber wesentliche Methode zur Interaktion mit der Solana Blockchain und zum Verständnis ihres aktuellen Fortschritts.