> ## 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.
# getBlockProduction
> Retorna informações recentes de produção de blocos do epoch atual ou anterior.
## Parâmetros da Solicitação
O nível de compromisso para a solicitação.
* `processed`
* `confirmed`
* `finalized`
Chave pública opcional de identidade do validador (codificada em base-58) para filtrar resultados para um validador específico.
Limitações opcionais de intervalo de slots para restringir o período de tempo das estatísticas de produção de blocos.
Número do slot inicial para começar a analisar as estatísticas de produção de blocos (inclusivo).
Número do slot final para analisar as estatísticas de produção de blocos até (inclusivo). Se omitido, utiliza o slot atual.
## OpenAPI
````yaml pt-BR/openapi/rpc-http/getBlockProduction.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API de análise de desempenho de validadores para monitorar a eficiência da
produção de blocos Solana e comparar os slots do cronograma do líder com os
blocos reais criados.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Endpoint RPC da Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC da Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getBlockProduction
description: >
Recuperar estatísticas detalhadas de produção de blocos para validadores
Solana dentro de um intervalo de slots especificado.
Esta API de análise de desempenho fornece métricas precisas sobre a
eficiência de cada validador na
produção de blocos quando programado como líder. Retorna tanto o número
de slots em que um validador
foi designado como líder quanto o número real de blocos que ele produziu
com sucesso, permitindo o
cálculo das taxas de confiabilidade. Essencial para monitoramento de
desempenho de validadores, análise
de saúde da rede, dashboards de staking e aplicativos que precisam
avaliar a confiabilidade dos
validadores ao tomar decisões de delegação ou monitorar a eficácia geral
da participação na rede Solana.
operationId: getBlockProduction
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: A versão do protocolo JSON-RPC.
default: '2.0'
id:
type: string
description: Um identificador único para a solicitação.
example: '1'
default: '1'
method:
type: string
enum:
- getBlockProduction
description: O nome do método RPC a ser invocado.
default: getBlockProduction
params:
type: array
default: []
description: Parâmetros para a solicitação.
items:
oneOf:
- type: object
description: Opções de configuração para a solicitação.
properties:
commitment:
type: string
description: O nível de compromisso para a solicitação.
enum:
- processed
- confirmed
- finalized
example: finalized
identity:
type: string
description: >-
Chave pública opcional de identidade do validador
(codificada em base-58) para filtrar resultados
para um validador específico.
example: 85iYT5RuzRTDgjyRa3cP8SYhM2j21fj7NhfJ3peu1DPr
range:
type: object
description: >-
Limites opcionais de intervalo de slots para
limitar o período de tempo das estatísticas de
produção de blocos.
properties:
firstSlot:
type: integer
description: >-
Número do primeiro slot para iniciar a análise
das estatísticas de produção de blocos
(inclusivo).
example: 0
lastSlot:
type: integer
description: >-
Número do último slot para analisar as
estatísticas de produção de blocos até
(inclusivo). Se omitido, usa o slot atual.
example: 9887
responses:
'200':
description: Informações de produção de blocos recuperadas com sucesso.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
id:
type: string
result:
type: object
properties:
context:
type: object
properties:
slot:
type: integer
description: O slot no momento da resposta.
example: 9887
value:
type: object
properties:
byIdentity:
type: object
additionalProperties:
type: array
items:
type: integer
description: >-
Array de dois elementos contendo estatísticas
[leaderSlots, blocksProduced] para este
validador.
description: >-
Mapa de chaves públicas de identidade do validador
para suas métricas de desempenho de produção de
blocos.
example:
85iYT5RuzRTDgjyRa3cP8SYhM2j21fj7NhfJ3peu1DPr:
- 9888
- 9886
range:
type: object
properties:
firstSlot:
type: integer
description: >-
Número do primeiro slot do período de
estatísticas de produção de blocos analisado.
example: 0
lastSlot:
type: integer
description: >-
Número do último slot do período de
estatísticas de produção de blocos analisado.
example: 9887
'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: Parâmetros inválidos
'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: Não autorizado
id: '1'
'429':
description: Muitas Solicitações - Limite de taxa excedido.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Muitas solicitações
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: Erro interno
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: Serviço indisponível
id: '1'
'504':
description: Tempo Limite do Gateway - O tempo de solicitação expirou.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Tempo limite do gateway
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
error:
type: object
properties:
code:
type: integer
message:
type: string
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).
````