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

> Retorna a programação de líderes do Solana para a época solicitada — o validador designado para produzir blocos em cada slot — usado para roteamento de transações conscientes de líderes e monitoramento de validadores.

## Parâmetros da Solicitação

<ParamField body="slot" type="number" required>
  Número da época ou slot para recuperar a programação de líderes. Se omitido, retorna a programação para a época atual.
</ParamField>

<ParamField body="commitment" type="string">
  O nível de compromisso para a solicitação.

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

<ParamField body="identity" type="string">
  Chave pública de identidade do validador opcional para filtrar resultados apenas para a programação de um validador específico.
</ParamField>


## OpenAPI

````yaml pt-BR/openapi/rpc-http/getLeaderSchedule.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API de agendamento de validadores para recuperar a sequência completa de
    rotação de líderes do Solana que determina quais validadores produzem blocos
    durante slots específicos de um epoch.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Ponto de extremidade RPC Mainnet
  - url: https://devnet.helius-rpc.com
    description: Ponto de extremidade RPC Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getLeaderSchedule
      description: >
        Recuperar o cronograma completo de rotação de validadores para um epoch
        inteiro do Solana.

        Esta API de consenso fornece o mapeamento detalhado de quais nós
        validadores são atribuídos 

        como líderes de slot durante um epoch, mostrando exatamente quais slots
        cada validador é

        responsável por produzir blocos. O cronograma de líderes é derivado
        deterministicamente

        usando uma função aleatória verificável baseada na seleção ponderada por
        participação. Essencial para 

        operadores de validadores monitorarem suas próximas responsabilidades de
        produção de blocos,

        aplicações de staking analisarem oportunidades de participação de
        validadores, ferramentas de 

        monitoramento de rede visualizarem padrões de consenso e aplicações que
        precisam

        prever ou analisar o tempo de produção de blocos e distribuição na rede.
      operationId: getLeaderSchedule
      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:
                    - getLeaderSchedule
                  example: getLeaderSchedule
                  default: getLeaderSchedule
                params:
                  type: array
                  description: Parâmetros para o método.
                  items:
                    oneOf:
                      - type: integer
                        description: >-
                          Número de epoch ou slot para recuperar o cronograma de
                          líderes. Se omitido, retorna o cronograma para o epoch
                          atual.
                        example: null
                      - type: object
                        description: Objeto de configuração com opções adicionais.
                        properties:
                          commitment:
                            type: string
                            description: O nível de compromisso para a solicitação.
                            enum:
                              - confirmed
                              - finalized
                              - processed
                            example: finalized
                          identity:
                            type: string
                            description: >-
                              Chave pública de identidade do validador opcional
                              para filtrar resultados apenas para o cronograma
                              de um validador específico.
                            example: 4Qkev8aNZcqFNSRhQzwyLMFSsi94jHqE8WNVTJzTP99F
      responses:
        '200':
          description: Cronograma de líderes recuperado 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:
                    oneOf:
                      - type: 'null'
                        description: Nulo se o epoch solicitado não for encontrado.
                      - type: object
                        description: >-
                          Mapeamento de identidades de validadores para seus
                          slots de liderança designados neste epoch.
                        additionalProperties:
                          type: array
                          description: >-
                            Array de índices de slot dentro do epoch onde este
                            validador está programado para produzir blocos.
                          items:
                            type: integer
                            example: 0
        '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: Invalid params
        '401':
          description: Não autorizado - chave API inválida ou ausente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                id: '1'
        '429':
          description: Muitas requisições - Limite de taxa excedido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Too many requests
                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: Internal error
                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: Service unavailable
                id: '1'
        '504':
          description: Gatewat Timeout - A requisição expirou.
          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: A versão do protocolo JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: O código de erro.
              example: -32602
            message:
              type: string
              description: A mensagem de erro.
            data:
              type: object
              description: Dados adicionais sobre o erro.
        id:
          type: string
          description: Identificador correspondente à solicitação.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Sua chave API Helius. Você pode obter uma gratuitamente no
        [painel](https://dashboard.helius.dev/api-keys).

````