Skip to main content
O método RPC getGenesisHash retorna o hash gênese do cluster Solana ao qual você está conectado. O hash gênese é um identificador único para uma rede Solana específica (por exemplo, Mainnet Beta, Devnet, Testnet ou um cluster privado).

Casos de Uso Comuns

  • Verificação de Rede: Confirme que sua aplicação está conectada ao cluster Solana pretendido (por exemplo, garantindo que você não está interagindo acidentalmente com o Mainnet Beta quando pretende usar o Devnet).
  • Configuração do Cliente: Algumas ferramentas ou aplicações do lado do cliente podem usar o hash gênese para se configurarem para uma rede específica.
  • Invalidação de Cache: Use o hash gênese como parte de uma chave de cache para garantir que os dados em cache sejam específicos para um cluster em particular, evitando que dados de uma rede sejam usados erroneamente em outra.

Parâmetros de Solicitação

Este método não aceita nenhum parâmetro.

Estrutura da Resposta

O campo result da resposta JSON-RPC será uma string contendo o hash gênese codificado em base-58.

Exemplos

1. Obter o Hash Gênese do Cluster Conectado

Este exemplo busca o hash gênese do endpoint RPC.

Dicas para Desenvolvedores

  • Unicidade: Cada cluster Solana (Mainnet Beta, Devnet, Testnet e quaisquer clusters privados) terá seu próprio hash gênese único.
  • Valor Constante: Para um dado cluster, o hash gênese é um valor constante definido quando o cluster foi inicialmente iniciado. Ele não muda ao longo do tempo.
  • Verificação no Lado do Cliente: É uma boa prática para aplicações cliente buscar o hash gênese e compará-lo com um valor esperado para evitar operações acidentais na rede errada, especialmente ao lidar com operações sensíveis ou fundos reais.
Este guia mostra como usar o método RPC getGenesisHash para recuperar o identificador único de um cluster Solana.