Skip to main content
POST
getAgGenesisCert
Requiere Agave v4.3 o una versión posterior. Las versiones anteriores no reconocen el método y devuelven Method not found (-32601).

Detectar la migración

Usa este método para comprobar si un clúster ejecuta el consenso de Alpenglow. La respuesta puede adoptar tres formas:
  • Un objeto de certificado. El clúster migró. result.block.slot es el primer slot producido con Alpenglow.
  • null. El nodo ejecuta Agave v4.3 o una versión posterior, y el clúster no migró.
  • Error -32601. El nodo ejecuta una versión anterior a v4.3. Se desconoce el consenso del clúster.
Trata -32601 como un estado desconocido, no como “sin migrar”. Si un nodo no puede responder la pregunta, eso no revela nada sobre el clúster. El certificado no cambia después de que un clúster migra. Guárdalo en caché después de la primera respuesta correcta en lugar de realizar consultas periódicas.

Leer el certificado

block identifica el bloque certificado. slot es su número de slot. blockId es un arreglo de 32 bytes, no la cadena en base 58 que se usa en otras partes de la API RPC. signature contiene la firma BLS agregada de todos los validadores que firmaron el certificado. bitmap registra cuáles fueron esos validadores, indexados según su clasificación por stake. Para leer el mapa de bits, necesitas la misma lista de validadores ordenada por stake que utilizó el clúster. blockId siempre tiene 32 bytes e signature siempre tiene 192; ambos se muestran completos en el ejemplo. bitmap no tiene un tamaño fijo: contiene un bit por validador, por lo que crece con el conjunto de validadores, y el ejemplo muestra uno pequeño. La CLI de Solana devuelve los mismos datos que solana alpenglow-genesis-info.

Autorizaciones

api-key
string
query
requerido

Tu clave de API de Helius. Puedes obtener una gratis en el panel.

Cuerpo

application/json
jsonrpc
enum<string>
predeterminado:2.0

La versión del protocolo JSON-RPC.

Opciones disponibles:
2.0
Ejemplo:

"2.0"

id
string
predeterminado:1

Un identificador único para la solicitud.

Ejemplo:

"1"

method
enum<string>
predeterminado:getAgGenesisCert

El nombre del método RPC que se invocará.

Opciones disponibles:
getAgGenesisCert
Ejemplo:

"getAgGenesisCert"

Respuesta

El certificado génesis de Alpenglow se obtuvo correctamente, o null si el clúster no migró.

jsonrpc
enum<string>

La versión del protocolo JSON-RPC.

Opciones disponibles:
2.0
Ejemplo:

"2.0"

id
string

Identificador que coincide con la solicitud.

Ejemplo:

"1"

result
object | null

El certificado génesis de Alpenglow, o null cuando el clúster aún ejecuta TowerBFT.