> ## 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.
# isBlockhashValid
> Retorna se um blockhash ainda é válido ou não.
## Parâmetros de Requisição
Blockhash para verificar o status de validade, como uma string codificada em base-58.
O nível de compromisso para a requisição.
* `confirmed`
* `finalized`
* `processed`
O slot mínimo em que a requisição pode ser avaliada.
## OpenAPI
````yaml pt-BR/openapi/rpc-http/isBlockhashValid.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API de verificação de validade de transações para verificar se um blockhash
Solana previamente adquirido ainda está dentro de sua janela de tempo de uso
para novas submissões de transações.
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: isBlockhashValid
description: >
Verifique se um blockhash Solana ainda é válido para submissão de
transações. Esta API essencial de preparação de transações permite que
aplicativos determinem se um blockhash previamente adquirido ainda está
dentro de sua janela de validade (tipicamente ~2 minutos ou ~150
blocos). Transações construídas com blockhashes expirados serão
rejeitadas pela rede, portanto, verificar a validade antes da submissão
ajuda a prevenir falhas de transações e erros de timeout. Crítico para
aplicativos de carteiras, exchanges, processadores de pagamento e
qualquer serviço que prepare transações com antecedência ou precise
verificar se uma transação pendente ainda pode ser enviada ou precisa
ser reconstruída com um blockhash novo para evitar rejeições por
expiração.
operationId: isBlockhashValid
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: A versão do protocolo JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Um identificador único para a solicitação.
example: '45'
default: '1'
method:
type: string
enum:
- isBlockhashValid
description: O nome do método RPC a ser invocado.
example: isBlockhashValid
default: isBlockhashValid
params:
type: array
description: Parâmetros para avaliar a validade do blockhash.
default:
- J7rBdM6AecPDEZp8aPq5iPSNKVkU5Q76F3oAV4eW5wsW
- commitment: processed
items:
oneOf:
- type: string
description: >-
Blockhash para verificar status de validade, como uma
string codificada em base-58.
example: J7rBdM6AecPDEZp8aPq5iPSNKVkU5Q76F3oAV4eW5wsW
- 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:
- confirmed
- finalized
- processed
example: processed
minContextSlot:
type: integer
description: >-
O slot mínimo em que a solicitação pode ser
avaliada.
example: 1000
responses:
'200':
description: Validade do blockhash avaliada 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: '45'
result:
type: object
description: Resultado da validade do blockhash.
properties:
context:
type: object
description: Contexto da resposta.
properties:
slot:
type: integer
description: Slot no qual os dados foram buscados.
example: 2483
value:
type: boolean
description: >-
Booleano indicando se este blockhash ainda está dentro
de sua janela de validade e pode ser usado em novas
transações.
example: false
examples:
default:
$ref: '#/components/examples/isBlockhashValidResponse'
'400':
description: >-
Requisiçã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
id: '1'
'401':
description: Não autorizado - Chave de 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 Requisições - Limite de taxa excedido.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Muitas requisiçõ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: Gateway Timeout - A solicitação expirou.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Tempo limite de gateway
id: '1'
security:
- ApiKeyQuery: []
components:
examples:
isBlockhashValidResponse:
value:
jsonrpc: '2.0'
id: '45'
result:
context:
slot: 2483
value: false
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 de API Helius. Você pode obter uma gratuitamente no
[dashboard](https://dashboard.helius.dev/api-keys).
````