> ## 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.
# getEpochInfo
> Retorna informações sobre a época atual.
## Parâmetros da Solicitação
O nível de compromisso para a solicitação.
* `confirmed`
* `finalized`
O slot mínimo que a solicitação pode ser avaliada.
## OpenAPI
````yaml pt-BR/openapi/rpc-http/getEpochInfo.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API de monitoramento abrangente de epochs do Solana para acompanhar o
progresso do ciclo dos validadores, períodos de staking e métricas de tempo
do blockchain com estatísticas detalhadas de epochs.
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 Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getEpochInfo
description: >
Recupere informações detalhadas sobre o epoch atual do Solana, ciclo de
validadores e progressão da rede.
Esta API essencial fornece métricas abrangentes de epochs, incluindo o
número atual do epoch, progresso dos slots
e contagens de transações. Os epochs representam ciclos de rotação de
validadores, períodos de recompensa de staking e
a segmentação do tempo no blockchain Solana. Crítico para aplicações de
staking, calculadoras de recompensas,
ferramentas de monitoramento de validadores e qualquer aplicação que
precise acompanhar o progresso da rede ou implementar
lógica baseada em epochs, como distribuição de recompensas ou upgrades
de protocolo.
operationId: getEpochInfo
requestBody:
required: true
content:
application/json:
schema:
type: object
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:
- getEpochInfo
example: getEpochInfo
default: getEpochInfo
params:
type: array
description: Parâmetros opcionais para a solicitação.
default: []
items:
type: object
properties:
commitment:
type: string
description: O nível de compromisso para a solicitação.
enum:
- confirmed
- finalized
example: finalized
minContextSlot:
type: integer
description: The minimum slot that the request can be evaluated at.
example: 1000
responses:
'200':
description: Informações do epoch recuperadas 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 que corresponde à solicitação.
example: '1'
result:
type: object
properties:
absoluteSlot:
type: integer
description: >-
O número atual de slot Solana absoluto representando o
progresso global do blockchain.
example: 166598
blockHeight:
type: integer
description: >-
Altura atual do blockchain Solana em blocos, útil para
rastrear o crescimento geral da cadeia.
example: 166500
epoch:
type: integer
description: >-
Número atual do epoch Solana representando o ciclo do
validador e o período de staking.
example: 27
slotIndex:
type: integer
description: >-
Posição atual dentro do epoch, mostrando o progresso
através do ciclo do validador.
example: 2790
slotsInEpoch:
type: integer
description: >-
Número total de slots no epoch atual, definindo a
duração do epoch e o comprimento da programação do
validador.
example: 8192
transactionCount:
type: integer
nullable: true
description: >-
Número cumulativo de transações bem-sucedidas
processadas no Solana desde a gênese.
example: 22661093
examples:
default:
value:
jsonrpc: '2.0'
id: '1'
result:
absoluteSlot: 166598
blockHeight: 166500
epoch: 27
slotIndex: 2790
slotsInEpoch: 8192
transactionCount: 22661093
'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
'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
'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
'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
'504':
description: Tempo limite do gateway - A 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
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.
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Sua chave API Helius. Você pode obter uma gratuitamente no
[dashboard](https://dashboard.helius.dev/api-keys).
````