Skip to main content
POST
getAgGenesisCert
Nécessite Agave v4.3 ou une version ultérieure. Les versions antérieures ne reconnaissent pas la méthode et renvoient Method not found (-32601).

Détection de la migration

Utilisez cette méthode pour vérifier si un cluster utilise le consensus Alpenglow. La réponse peut prendre trois formes :
  • Un objet de certificat. Le cluster a migré. result.block.slot est le premier slot produit sous Alpenglow.
  • null. Le nœud exécute Agave v4.3 ou une version ultérieure, et le cluster n’a pas migré.
  • Erreur -32601. La version du nœud est antérieure à la v4.3. Le consensus du cluster est inconnu.
Considérez -32601 comme un état inconnu plutôt que comme « non migré ». Un nœud qui ne peut pas répondre à la question ne fournit aucune information sur le cluster. Le certificat ne change plus après la migration d’un cluster. Mettez-le en cache après la première réponse réussie au lieu d’effectuer des interrogations régulières.

Lecture du certificat

block identifie le bloc certifié. slot est son numéro de slot. blockId est un tableau de 32 octets, et non la chaîne en base 58 utilisée ailleurs dans l’API RPC. signature contient la signature BLS agrégée de chaque validateur ayant signé le certificat. bitmap indique quels validateurs l’ont signé, indexés selon leur classement par mise. La lecture du bitmap nécessite la même liste de validateurs, triée par mise, que celle utilisée par le cluster. blockId contient toujours 32 octets et signature toujours 192 octets ; les deux sont affichés dans leur intégralité dans l’exemple. bitmap n’a pas de taille fixe : il contient un bit par validateur et s’agrandit donc avec l’ensemble de validateurs. L’exemple en présente une version courte. La CLI Solana renvoie les mêmes données que solana alpenglow-genesis-info.

Autorisations

api-key
string
query
requis

Votre clé API Helius. Vous pouvez en obtenir une gratuitement dans le tableau de bord.

Corps

application/json
jsonrpc
enum<string>
défaut:2.0

La version du protocole JSON-RPC.

Options disponibles:
2.0
Exemple:

"2.0"

id
string
défaut:1

Un identifiant unique pour la requête.

Exemple:

"1"

method
enum<string>
défaut:getAgGenesisCert

Le nom de la méthode RPC à appeler.

Options disponibles:
getAgGenesisCert
Exemple:

"getAgGenesisCert"

Réponse

Le certificat de genèse Alpenglow a été récupéré, ou null si le cluster n’a pas migré.

jsonrpc
enum<string>

La version du protocole JSON-RPC.

Options disponibles:
2.0
Exemple:

"2.0"

id
string

Identifiant correspondant à la requête.

Exemple:

"1"

result
object | null

Le certificat de genèse Alpenglow, ou null lorsque le cluster utilise encore TowerBFT.