isBlockhashValid RPC Method

Parameters

blockhash

REQUIRED

The hash of the block encoded as base-58 string

object

array

An object with the following fields:

finalized

the node will query the most recent block confirmed by supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.

confirmed

the node will query the most recent block that has been voted on by supermajority of the cluster.

processed

the node will query its most recent block. Note that the block may not be complete.

minContextSlot

integer

The minimum slot at which the request can be evaluated

Returns

result

True if the blockhash is still valid otherwise false

Request

curl https://docs-demo.solana-mainnet.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  -d '
    {
      "id":45,
      "jsonrpc":"2.0",
      "method":"isBlockhashValid",
      "params":[
        "ENTER_BLOCKHASH_ID_HERE",
        {"commitment":"processed"}
      ]
    }
'

import { createSolanaRpc, blockhash } from "@solana/web3.js";

(async () => {
  const solanaRpc = createSolanaRpc("https://docs-demo.solana-mainnet.quiknode.pro/");

  const blockHash = blockhash("EPnQzurHhxLXGtk73B5zvWaRoGpkzd5tU9ZGVAULbQoJ");
  try {
    const isValid = await solanaRpc.isBlockhashValid(blockHash, { commitment: "processed" }).send();
    console.log("Is blockhash valid:", isValid);
  } catch (error) {
    console.error("Error checking blockhash validity:", error);
  }
})();

use reqwest::header;
use reqwest::Client;
use std::error::Error;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let mut headers = header::HeaderMap::new();
    headers.insert("Content-Type", "application/json".parse().unwrap());

    let client = Client::new();
    let json_data = r#"
    {
        "id": 45,
        "jsonrpc": "2.0",
        "method": "isBlockhashValid",
        "params": [
            "ENTER_BLOCKHASH_ID_HERE",
            {
                "commitment": "processed"
            }
        ]
    }
    "#;
    let response = client
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
        .headers(headers)
        .body(json_data)
        .send()
        .await?; 

    let body = response.text().await?;
    println!("{}", body);

    Ok(())
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free