> ## 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 ko/openapi/rpc-http/getClusterNodes.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: 네트워크 주소, 버전 및 연결 지점과 함께 활성 Solana 검증자 노드의 포괄적인 목록을 검색하는 네트워크 검색 API입니다.
  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: Devnet RPC 엔드포인트
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getClusterNodes
      description: >-
        Solana 네트워크의 모든 활성 검증자 노드에 대한 세부 정보를 검색합니다. 이 네트워크 토폴로지 API는 현재 검증자 지형에
        대한 완전한 매핑을 제공하며, 각 참여 노드에 대한 필수 연결 세부 정보를 반환합니다. 정보에는 검증자 공개 키, 다른
        프로토콜(가십, 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: >-
                            이 노드를 Solana 네트워크에서 식별하는 고유한 검증자 ID 공개 키(base-58
                            인코딩)입니다.
                          example: 9QzsJf7LPLj8GkXbYT3LFDKqsj2hHG7TA3xinJHu8epQ
                        gossip:
                          type: string
                          nullable: true
                          description: >-
                            피어 검색을 위한 이 검증자의 가십 프로토콜 엔드포인트에 연결하기 위한 IP 주소 및
                            포트입니다.
                          example: 10.239.6.48:8001
                        tpu:
                          type: string
                          nullable: true
                          description: 클라이언트가 이 검증자에게 직접 트랜잭션을 제출할 수 있는 트랜잭션 처리 장치 주소입니다.
                          example: 10.239.6.48:8856
                        rpc:
                          type: string
                          nullable: true
                          description: >-
                            이 검증자가 공용 RPC 서비스를 제공할 경우 JSON-RPC API 엔드포인트 주소이며,
                            공개적으로 사용할 수 없는 경우 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: >-
        당신의 Helius API 키입니다. [대시보드](https://dashboard.helius.dev/api-keys)에서 무료로
        받을 수 있습니다.

````