> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Como Usar getGenesisHash

> Aprenda sobre casos de uso do getGenesisHash, exemplos de código, parâmetros de solicitação, estrutura de resposta e dicas.

O método RPC [`getGenesisHash`](https://www.helius.dev/docs/api-reference/rpc/http/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.

<CodeGroup>
  ```bash cURL theme={"system"}
  curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
    '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getGenesisHash"
    }'
  ```

  ```javascript JavaScript (using @solana/web3.js) theme={"system"}
  const { Connection } = require('@solana/web3.js');

  async function logGenesisHash() {
    const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
    try {
      const genesisHash = await connection.getGenesisHash();
      console.log(`Genesis Hash: ${genesisHash}`);
    } catch (error) {
      console.error('Error fetching genesis hash:', error);
    }
  }

  logGenesisHash();
  ```
</CodeGroup>

## 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.