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

# getLeaderSchedule

> 요청된 에포크에 대한 Solana 리더 일정 - 각 슬롯에서 블록을 생성하도록 할당된 검증자 - 리더 인식 트랜잭션 라우팅 및 검증자 모니터링에 사용됩니다.

## 요청 매개변수

<ParamField body="slot" type="number" required>
  리더 일정을 가져올 에포크 또는 슬롯 번호입니다. 생략하면 현재 에포크의 일정을 반환합니다.
</ParamField>

<ParamField body="commitment" type="string">
  요청에 대한 커밋 수준입니다.

  * `confirmed`
  * `finalized`
  * `processed`
</ParamField>

<ParamField body="identity" type="string">
  특정 검증자의 일정만 필터링하기 위한 선택적 검증자 ID 공개 키입니다.
</ParamField>


## OpenAPI

````yaml ko/openapi/rpc-http/getLeaderSchedule.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: getLeaderSchedule
      description: |
        전체 Solana 에포크에 대한 완전한 검증자 회전 스케줄을 검색합니다.
        이 컨센서스 API는 에포크 동안 어떤 슬롯 리더로 지정된 검증자 노드의 세부적인 매핑을 제공합니다. 
        리더 스케줄은 스테이크 가중치 선택에 기반한 검증 가능한 랜덤 함수로 결정적으로 도출됩니다. 
        향후 블록 생성 책임을 모니터링하는 검증자 운영자, 검증자 참여 기회를 분석하는 스테이킹 애플리케이션,
        컨센서스 패턴을 시각화하는 네트워크 모니터링 도구, 네트워크 전반에 걸친 블록 생성 타이밍 및 분포를 
        예측하거나 분석할 필요가 있는 애플리케이션에 필수적입니다.
      operationId: getLeaderSchedule
      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:
                    - getLeaderSchedule
                  example: getLeaderSchedule
                  default: getLeaderSchedule
                params:
                  type: array
                  description: 메서드에 대한 매개변수입니다.
                  items:
                    oneOf:
                      - type: integer
                        description: 리더 스케줄을 검색할 에포크 또는 슬롯 번호입니다. 생략 시 현재 에포크의 스케줄을 반환합니다.
                        example: null
                      - type: object
                        description: 추가 옵션이 있는 구성 객체입니다.
                        properties:
                          commitment:
                            type: string
                            description: 요청에 대한 커밋 수준입니다.
                            enum:
                              - confirmed
                              - finalized
                              - processed
                            example: finalized
                          identity:
                            type: string
                            description: 특정 검증자의 스케줄만 필터링하기 위한 선택적 검증자 아이덴티티 공개 키입니다.
                            example: 4Qkev8aNZcqFNSRhQzwyLMFSsi94jHqE8WNVTJzTP99F
      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:
                    oneOf:
                      - type: 'null'
                        description: 요청된 에포크를 찾을 수 없는 경우 null입니다.
                      - type: object
                        description: 이 에포크 내에서 할당된 리더 슬롯에 대한 검증자 아이덴티티의 매핑입니다.
                        additionalProperties:
                          type: array
                          description: 이 검증자가 블록을 생성하도록 예정된 에포크 내의 슬롯 인덱스 배열입니다.
                          items:
                            type: integer
                            example: 0
        '400':
          description: 잘못된 요청 - 잘못된 요청 매개변수 또는 잘못된 요청입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Invalid params
        '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: 오류 코드입니다.
              example: -32602
            message:
              type: string
              description: 오류 메시지입니다.
            data:
              type: object
              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)에서
        무료로 얻을 수 있습니다.

````