> ## 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 o getIdentity

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

O método RPC [`getIdentity`](https://www.helius.dev/docs/api-reference/rpc/http/getidentity) retorna a chave pública (também conhecida como identidade ou ID do nó) do nó RPC Solana ao qual você está conectado. Cada nó na rede Solana possui um par de chaves criptográficas exclusivo, e sua chave pública serve como seu identificador.

## Casos de Uso Comuns

* **Identificação do Nó:** Identifique exclusivamente o nó RPC com o qual você está se comunicando, especialmente em configurações distribuídas ou ao interagir com vários provedores RPC.
* **Análise de Rede:** Quando combinado com `getClusterNodes`, você pode associar a identidade de `getIdentity` a um nó na lista de clusters para encontrar mais detalhes sobre o nó específico que você está consultando.
* **Depuração e Registro:** Registre a identidade do nó para fins de depuração ou para rastrear qual nó atendeu a uma solicitação específica.
* **Verificação (Avançado):** Em alguns cenários específicos, a identidade do nó pode ser usada em protocolos de nível superior ou para fins de verificação, embora isso seja menos comum em interações típicas de dApp.

## Parâmetros de Solicitação

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

## Estrutura de Resposta

O campo `result` da resposta JSON-RPC será um objeto contendo um único campo:

* **`identity`** (string): A chave pública codificada em base-58 do nó RPC.

## Exemplos

### 1. Obter a Identidade do Nó RPC Conectado

Este exemplo obtém a chave pública do nó 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": "getIdentity"
    }'
  ```

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

  async function logNodeIdentity() {
    const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
    try {
      const identityInfo = await connection.getIdentity();
      console.log(`Node Identity (Public Key): ${identityInfo.identity}`);
    } catch (error) {
      console.error('Error fetching node identity:', error);
    }
  }

  logNodeIdentity();
  ```
</CodeGroup>

## Dicas para Desenvolvedores

* **Específico do Nó:** A identidade retornada é exclusiva para a instância específica do nó RPC ao qual você está conectado. Se você se conectar a um endpoint RPC diferente (mesmo que faça parte do mesmo cluster ou seja operado pelo mesmo provedor, mas com balanceamento de carga), pode obter uma identidade diferente.
* **Não para Carteiras de Usuário:** A identidade retornada é para o próprio nó RPC, não para qualquer carteira ou conta de usuário na rede Solana.
* **Estabilidade:** A identidade de um dado nó é geralmente estável, mas pode mudar se o operador do nó reconfigurar ou substituir o par de chaves do nó.

Este guia demonstra como usar o método RPC `getIdentity` para recuperar a chave pública exclusiva do nó Solana com o qual você está interagindo.

## Métodos Relacionados

<CardGroup cols={2}>
  <Card title="getClusterNodes" href="/docs/pt-BR/api-reference/rpc/http/getclusternodes">
    Obtenha detalhes sobre todos os nós no cluster
  </Card>
</CardGroup>