Skip to main content
POST
getAgGenesisCert
Requer o Agave v4.3 ou posterior. Versões anteriores não reconhecem o método e retornam Method not found (-32601).

Como detectar a migração

Use este método para verificar se um cluster executa o consenso Alpenglow. A resposta pode ter três formas:
  • Um objeto de certificado. O cluster migrou. result.block.slot é o primeiro slot produzido no Alpenglow.
  • null. O nó executa o Agave v4.3 ou posterior, e o cluster não migrou.
  • Erro -32601. O nó é anterior à v4.3. O consenso do cluster é desconhecido.
Trate -32601 como desconhecido, e não como “não migrado”. Um nó que não consegue responder à pergunta não fornece nenhuma informação sobre o cluster. O certificado não muda depois que um cluster migra. Armazene-o em cache após a primeira resposta bem-sucedida, em vez de fazer consultas periódicas.

Como interpretar o certificado

block identifica o bloco certificado. slot é o número do slot desse bloco. blockId é um array de 32 bytes, não a string em base 58 usada em outras partes da API RPC. signature contém a assinatura BLS agregada de todos os validadores que assinaram o certificado. bitmap registra quais foram esses validadores, indexados pela classificação de stake. A leitura do bitmap requer a mesma lista de validadores ordenada por stake que o cluster usou. blockId sempre tem 32 bytes, e signature sempre tem 192, ambos exibidos por inteiro no exemplo. bitmap não tem tamanho fixo: ele contém um bit por validador, portanto cresce com o conjunto de validadores, e o exemplo mostra um bitmap curto. A CLI da Solana retorna os mesmos dados que solana alpenglow-genesis-info.

Autorizações

api-key
string
query
obrigatório

Sua chave de API da Helius. Você pode obter uma gratuitamente no painel.

Corpo

application/json
jsonrpc
enum<string>
padrão:2.0

A versão do protocolo JSON-RPC.

Opções disponíveis:
2.0
Exemplo:

"2.0"

id
string
padrão:1

Um identificador exclusivo para a solicitação.

Exemplo:

"1"

method
enum<string>
padrão:getAgGenesisCert

O nome do método RPC a ser invocado.

Opções disponíveis:
getAgGenesisCert
Exemplo:

"getAgGenesisCert"

Resposta

O certificado de gênese do Alpenglow foi recuperado com sucesso, ou null se o cluster não tiver migrado.

jsonrpc
enum<string>

A versão do protocolo JSON-RPC.

Opções disponíveis:
2.0
Exemplo:

"2.0"

id
string

Identificador correspondente à solicitação.

Exemplo:

"1"

result
object | null

O certificado de gênese do Alpenglow, ou null quando o cluster ainda estiver executando o TowerBFT.