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

> Возвращает информацию обо всех узлах, участвующих в работе кластера.



## OpenAPI

````yaml ru/openapi/rpc-http/getClusterNodes.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API обнаружения сети для получения полного списка активных узлов-валидаторов
    Solana с их сетевыми адресами, версиями и конечными точками подключения.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Конечная точка RPC основной сети
  - url: https://devnet.helius-rpc.com
    description: Конечная точка RPC сети разработки
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getClusterNodes
      description: >
        Получает подробную информацию обо всех активных узлах-валидаторах в сети
        Solana.

        Этот API топологии сети предоставляет полную карту текущей
        инфраструктуры валидаторов

        и возвращает основные сведения о подключении для каждого участвующего
        узла. Информация включает

        публичные ключи валидаторов, сетевые адреса для различных протоколов
        (gossip, TPU, RPC),

        версии программного обеспечения и наборы функций. Это необходимо для
        инструментов мониторинга сети, панелей

        статистики валидаторов, клиентских библиотек с интеллектуальным выбором
        узлов, сетевых

        инструментов, которым требуется прямое взаимодействие с валидаторами, и
        приложений для анализа

        географического распределения и распределения версий в сети валидаторов
        Solana.
      operationId: getClusterNodes
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
              properties:
                jsonrpc:
                  type: string
                  description: Версия протокола JSON-RPC.
                  enum:
                    - '2.0'
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Уникальный идентификатор запроса.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  description: Имя вызываемого метода RPC.
                  enum:
                    - getClusterNodes
                  example: getClusterNodes
                  default: getClusterNodes
      responses:
        '200':
          description: Информация об узлах кластера успешно получена.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: Версия протокола JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Идентификатор, соответствующий запросу.
                    example: '1'
                  result:
                    type: array
                    description: >-
                      Полный список всех доступных для обнаружения
                      узлов-валидаторов Solana, которые в данный момент
                      участвуют в работе сети.
                    items:
                      type: object
                      properties:
                        pubkey:
                          type: string
                          description: >-
                            Уникальный публичный ключ идентификации валидатора в
                            кодировке base-58, который идентифицирует этот узел
                            в сети Solana.
                          example: 9QzsJf7LPLj8GkXbYT3LFDKqsj2hHG7TA3xinJHu8epQ
                        gossip:
                          type: string
                          nullable: true
                          description: >-
                            IP-адрес и порт для подключения к конечной точке
                            gossip-протокола этого валидатора с целью
                            обнаружения одноранговых узлов.
                          example: 10.239.6.48:8001
                        tpu:
                          type: string
                          nullable: true
                          description: >-
                            Адрес блока обработки транзакций, на который клиенты
                            могут напрямую отправлять транзакции этому
                            валидатору.
                          example: 10.239.6.48:8856
                        rpc:
                          type: string
                          nullable: true
                          description: >-
                            Адрес конечной точки JSON-RPC API, если этот
                            валидатор предоставляет общедоступные службы RPC,
                            или null, если они недоступны публично.
                          example: 10.239.6.48:8899
                        version:
                          type: string
                          nullable: true
                          description: >-
                            Версия программного обеспечения Solana и
                            идентификатор сборки, запущенной на этом
                            узле-валидаторе.
                          example: 1.0.0 c375ce1f
                        featureSet:
                          type: integer
                          nullable: true
                          description: >-
                            Числовой идентификатор набора функций, включенного
                            на этом валидаторе и используемого для отслеживания
                            совместимости протокола.
                        shredVersion:
                          type: integer
                          nullable: true
                          description: >-
                            Номер версии сетевой совместимости, используемый для
                            обработки и маршрутизации фрагментов данных между
                            узлами-валидаторами.
        '400':
          description: >-
            Неверный запрос — недопустимые параметры или некорректная структура
            запроса.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Invalid params
                id: '1'
        '401':
          description: Не авторизовано — ключ API недействителен или отсутствует.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                id: '1'
        '429':
          description: Слишком много запросов — превышено ограничение частоты запросов.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Too many requests
                id: '1'
        '500':
          description: Внутренняя ошибка сервера — на сервере произошла ошибка.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Internal error
                id: '1'
        '503':
          description: Служба недоступна — служба временно недоступна.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service unavailable
                id: '1'
        '504':
          description: Истекло время ожидания шлюза — превышено время ожидания запроса.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Gateway timeout
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: Версия протокола JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: Код ошибки.
            message:
              type: string
              description: Сообщение об ошибке.
        id:
          type: string
          description: Идентификатор, соответствующий запросу.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Ваш ключ API Helius. Его можно получить бесплатно в [панели
        управления](https://dashboard.helius.dev/api-keys).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.