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

# getClusterNodes

> Retorna informações sobre todos os nós que participam do cluster.



## OpenAPI

````yaml pt-BR/openapi/rpc-http/getClusterNodes.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API de descoberta de rede para obter uma lista abrangente de nós validador
    Solana ativos com seus endereços de rede, versões e pontos de conectividade.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Endpoint RPC da Mainnet
  - url: https://devnet.helius-rpc.com
    description: Endpoint RPC da Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getClusterNodes
      description: >
        Recupere informações detalhadas sobre todos os nós validadores ativos na
        rede Solana.

        Esta API de topologia de rede fornece um mapeamento completo do atual
        cenário de validadores,

        retornando detalhes essenciais de conectividade para cada nó
        participante. As informações incluem

        chaves públicas dos validadores, endereços de rede para diferentes
        protocolos (gossip, TPU, RPC),

        versões de software e conjuntos de recursos. Essencial para ferramentas
        de monitoramento de rede, painéis de estatísticas de validadores,
        bibliotecas de clientes que implementam seleção inteligente de nós,
        ferramentas de rede que precisam de comunicação direta com validadores e
        aplicações que desejam entender

        a distribuição geográfica e de versões da rede de validadores Solana.
      operationId: getClusterNodes
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
              properties:
                jsonrpc:
                  type: string
                  description: A versão do protocolo JSON-RPC.
                  enum:
                    - '2.0'
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Um identificador único para a solicitação.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  description: O nome do método RPC a ser invocado.
                  enum:
                    - getClusterNodes
                  example: getClusterNodes
                  default: getClusterNodes
      responses:
        '200':
          description: Informações dos nós do cluster recuperadas com sucesso.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: A versão do protocolo JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Identificador correspondente à solicitação.
                    example: '1'
                  result:
                    type: array
                    description: >-
                      Lista abrangente de todos os nós validadores Solana
                      descobertos atualmente participando da rede.
                    items:
                      type: object
                      properties:
                        pubkey:
                          type: string
                          description: >-
                            Chave pública de identidade única do validador
                            (codificada em base-58) que identifica este nó na
                            rede Solana.
                          example: 9QzsJf7LPLj8GkXbYT3LFDKqsj2hHG7TA3xinJHu8epQ
                        gossip:
                          type: string
                          nullable: true
                          description: >-
                            Endereço IP e porta para conexão ao endpoint do
                            protocolo gossip deste validador para descoberta de
                            pares.
                          example: 10.239.6.48:8001
                        tpu:
                          type: string
                          nullable: true
                          description: >-
                            Endereço da Unidade de Processamento de Transações
                            onde os clientes podem enviar transações diretamente
                            para este validador.
                          example: 10.239.6.48:8856
                        rpc:
                          type: string
                          nullable: true
                          description: >-
                            Endereço do endpoint da API JSON-RPC se este
                            validador oferecer serviços RPC públicos, ou nulo se
                            não estiver publicamente disponível.
                          example: 10.239.6.48:8899
                        version:
                          type: string
                          nullable: true
                          description: >-
                            Versão do software Solana e identificador de
                            compilação em execução neste nó validador.
                          example: 1.0.0 c375ce1f
                        featureSet:
                          type: integer
                          nullable: true
                          description: >-
                            Identificador numérico do conjunto de recursos
                            habilitados neste validador, usado para rastrear a
                            compatibilidade do protocolo.
                        shredVersion:
                          type: integer
                          nullable: true
                          description: >-
                            Número da versão de compatibilidade de rede usada
                            para processamento e roteamento de shred entre nós
                            validadores.
        '400':
          description: >-
            Solicitação inválida - Parâmetros de solicitação inválidos ou
            solicitação malformada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Parâmetros inválidos
                id: '1'
        '401':
          description: Não autorizado - Chave de API inválida ou ausente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Não autorizado
                id: '1'
        '429':
          description: Muitas solicitações - Limite de taxa excedido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Muitas solicitações
                id: '1'
        '500':
          description: Erro interno do servidor - Ocorreu um erro no servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Erro interno
                id: '1'
        '503':
          description: Serviço indisponível - O serviço está temporariamente indisponível.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Serviço indisponível
                id: '1'
        '504':
          description: Tempo limite do gateway - A solicitação excedeu o tempo limite.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Tempo limite do gateway
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: A versão do protocolo JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: Código de erro.
            message:
              type: string
              description: Mensagem de erro.
        id:
          type: string
          description: Identificador correspondente à solicitação.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Sua chave de API da Helius. Você pode obter uma gratuitamente no
        [dashboard](https://dashboard.helius.dev/api-keys).

````