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

> Trả về thông tin về tất cả các nút tham gia vào cụm.



## OpenAPI

````yaml vi/openapi/rpc-http/getClusterNodes.yaml POST /
openapi: 3.1.0
info:
  title: API RPC Solana
  version: 1.0.0
  description: >-
    API khám phá mạng để truy xuất danh sách đầy đủ các nút trình xác thực
    Solana đang hoạt động, cùng với địa chỉ mạng, phiên bản và điểm cuối kết nối
    của chúng.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Điểm cuối RPC Mainnet
  - url: https://devnet.helius-rpc.com
    description: Điểm cuối RPC Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getClusterNodes
      description: >
        Truy xuất thông tin chi tiết về tất cả các nút trình xác thực đang hoạt
        động trong mạng Solana.

        API cấu trúc liên kết mạng này cung cấp bản ánh xạ đầy đủ về hệ thống
        trình xác thực hiện tại,

        trả về các thông tin kết nối thiết yếu cho từng nút tham gia. Thông tin
        bao gồm

        khóa công khai của trình xác thực, địa chỉ mạng cho các giao thức khác
        nhau (gossip, TPU, RPC),

        phiên bản phần mềm và bộ tính năng. API này rất cần thiết cho các công
        cụ giám sát mạng, bảng điều khiển

        thống kê trình xác thực, thư viện máy khách triển khai cơ chế lựa chọn
        nút thông minh, công cụ mạng

        cần giao tiếp trực tiếp với trình xác thực và các ứng dụng muốn tìm hiểu

        sự phân bố theo địa lý và phiên bản của mạng trình xác thực Solana.
      operationId: getClusterNodes
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
              properties:
                jsonrpc:
                  type: string
                  description: Phiên bản giao thức JSON-RPC.
                  enum:
                    - '2.0'
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Mã định danh duy nhất cho yêu cầu.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  description: Tên của phương thức RPC cần gọi.
                  enum:
                    - getClusterNodes
                  example: getClusterNodes
                  default: getClusterNodes
      responses:
        '200':
          description: Đã truy xuất thành công thông tin về các nút trong cụm.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: Phiên bản giao thức JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Mã định danh khớp với yêu cầu.
                    example: '1'
                  result:
                    type: array
                    description: >-
                      Danh sách đầy đủ tất cả các nút trình xác thực Solana có
                      thể phát hiện và hiện đang tham gia mạng.
                    items:
                      type: object
                      properties:
                        pubkey:
                          type: string
                          description: >-
                            Khóa công khai định danh duy nhất của trình xác thực
                            (được mã hóa base-58), dùng để xác định nút này trên
                            mạng Solana.
                          example: 9QzsJf7LPLj8GkXbYT3LFDKqsj2hHG7TA3xinJHu8epQ
                        gossip:
                          type: string
                          nullable: true
                          description: >-
                            Địa chỉ IP và cổng để kết nối với điểm cuối giao
                            thức gossip của trình xác thực này nhằm khám phá các
                            nút ngang hàng.
                          example: 10.239.6.48:8001
                        tpu:
                          type: string
                          nullable: true
                          description: >-
                            Địa chỉ Đơn vị xử lý giao dịch mà máy khách có thể
                            dùng để gửi giao dịch trực tiếp đến trình xác thực
                            này.
                          example: 10.239.6.48:8856
                        rpc:
                          type: string
                          nullable: true
                          description: >-
                            Địa chỉ điểm cuối API JSON-RPC nếu trình xác thực
                            này cung cấp dịch vụ RPC công khai; nếu không khả
                            dụng công khai thì giá trị là null.
                          example: 10.239.6.48:8899
                        version:
                          type: string
                          nullable: true
                          description: >-
                            Phiên bản phần mềm Solana và mã định danh bản dựng
                            đang chạy trên nút trình xác thực này.
                          example: 1.0.0 c375ce1f
                        featureSet:
                          type: integer
                          nullable: true
                          description: >-
                            Mã định danh dạng số của bộ tính năng được bật trên
                            trình xác thực này, dùng để theo dõi khả năng tương
                            thích giao thức.
                        shredVersion:
                          type: integer
                          nullable: true
                          description: >-
                            Số phiên bản tương thích mạng được dùng để xử lý và
                            định tuyến shred giữa các nút trình xác thực.
        '400':
          description: >-
            Yêu cầu không hợp lệ - Tham số yêu cầu không hợp lệ hoặc yêu cầu sai
            định dạng.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Tham số không hợp lệ
                id: '1'
        '401':
          description: Không được phép - Khóa API không hợp lệ hoặc bị thiếu.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Không được phép
                id: '1'
        '429':
          description: Quá nhiều yêu cầu - Đã vượt quá giới hạn tốc độ.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Quá nhiều yêu cầu
                id: '1'
        '500':
          description: Lỗi máy chủ nội bộ - Đã xảy ra lỗi trên máy chủ.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Lỗi nội bộ
                id: '1'
        '503':
          description: Dịch vụ không khả dụng - Dịch vụ tạm thời không khả dụng.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Dịch vụ không khả dụng
                id: '1'
        '504':
          description: Hết thời gian chờ của cổng kết nối - Yêu cầu đã hết thời gian chờ.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Hết thời gian chờ của cổng kết nối
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: Phiên bản giao thức JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: Mã lỗi.
            message:
              type: string
              description: Thông báo lỗi.
        id:
          type: string
          description: Mã định danh khớp với yêu cầu.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Khóa API Helius của bạn. Bạn có thể nhận khóa miễn phí trong [bảng điều
        khiển](https://dashboard.helius.dev/api-keys).

````