Skip to main content
POST
getAgGenesisCert
Erfordert Agave v4.3 oder höher. Frühere Versionen erkennen die Methode nicht und geben Method not found (-32601) zurück.

Migration erkennen

Prüfe mit dieser Methode, ob ein cluster den Alpenglow-Konsens verwendet. Die response kann drei Formen annehmen:
  • Ein Zertifikatobjekt. Der cluster wurde migriert. result.block.slot ist der erste unter Alpenglow erzeugte slot.
  • null. Der node verwendet Agave v4.3 oder höher und der cluster wurde noch nicht migriert.
  • Fehler -32601. Der node verwendet eine Version vor v4.3. Der Konsens des clusters ist unbekannt.
Behandle -32601 als unbekannt und nicht als „nicht migriert“. Wenn ein node diese Frage nicht beantworten kann, sagt das nichts über den cluster aus. Nach der Migration eines clusters ändert sich das Zertifikat nicht mehr. Speichere es nach der ersten erfolgreichen response im Cache, statt es regelmäßig abzufragen.

Zertifikat auslesen

block identifiziert den zertifizierten Block. slot ist dessen slot-Nummer. blockId ist ein Array mit 32 Byte und nicht die Base58-Zeichenfolge, die an anderer Stelle in der RPC API verwendet wird. signature enthält die aggregierte BLS-Signatur aller Validatoren, die das Zertifikat signiert haben. bitmap hält fest, welche Validatoren dies waren, indiziert nach ihrem Stake-Rang. Zum Auslesen der Bitmap brauchst du dieselbe nach Stake sortierte Validatorliste, die der cluster verwendet hat. blockId umfasst immer 32 Byte und signature immer 192 Byte. Beide werden im Beispiel in voller Länge gezeigt. bitmap hat keine feste Größe: Es enthält ein Bit pro Validator und wächst daher mit der Validatorengruppe. Das Beispiel zeigt eine kurze Bitmap. Die Solana CLI gibt dieselben Daten zurück wie solana alpenglow-genesis-info.

Autorisierungen

api-key
string
query
erforderlich

Dein Helius API key. Du kannst ihn kostenlos im Dashboard erstellen.

Body

application/json
jsonrpc
enum<string>
Standard:2.0

Die Version des JSON-RPC-Protokolls.

Verfügbare Optionen:
2.0
Beispiel:

"2.0"

id
string
Standard:1

Eine eindeutige Kennung für den request.

Beispiel:

"1"

method
enum<string>
Standard:getAgGenesisCert

Der Name der aufzurufenden RPC-Methode.

Verfügbare Optionen:
getAgGenesisCert
Beispiel:

"getAgGenesisCert"

Antwort

Das Alpenglow-Genesis-Zertifikat wurde erfolgreich abgerufen. Wenn der cluster noch nicht migriert wurde, wird null zurückgegeben.

jsonrpc
enum<string>

Die Version des JSON-RPC-Protokolls.

Verfügbare Optionen:
2.0
Beispiel:

"2.0"

id
string

Kennung, die dem request entspricht.

Beispiel:

"1"

result
object | null

Das Alpenglow-Genesis-Zertifikat oder null, wenn der cluster weiterhin TowerBFT verwendet.