Parameters

blockhash

string

REQUIRED

The hash of the block encoded as base-58 string

object

object

An optional configuration object with the following fields:

commitment

string

The level of commitment required for the query. The options include:

finalized

The node will query the most recent block the cluster has recognized as finalized

confirmed

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

processed

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

Returns

result

object

The RpcResponse JSON object with the following fields:

context

object

The information about the current state of the program

slot

integer

The slot at which the blockhash validity was evaluated

apiVersion

string

The version of the Solana RPC API in use

value

boolean

True if the blockhash is still valid; otherwise false

Request

1
curl https://docs-demo.solana-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  -d '
5
    {
6
      "id":45,
7
      "jsonrpc":"2.0",
8
      "method":"isBlockhashValid",
9
      "params":[
10
       "JupRhwjrF5fAcs6dFhLH59r3TJFvbcyLP2NRM8UGH9H", {"commitment": "finalized"}
11
      ]
12
    }
13
'
14

1
curl https://docs-demo.solana-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  -d '
5
    {
6
      "id":45,
7
      "jsonrpc":"2.0",
8
      "method":"isBlockhashValid",
9
      "params":[
10
       "JupRhwjrF5fAcs6dFhLH59r3TJFvbcyLP2NRM8UGH9H", {"commitment": "finalized"}
11
      ]
12
    }
13
'
14

1
import { createSolanaRpc, blockhash } from "@solana/kit";
2

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

6
  const blockHash = blockhash("EPnQzurHhxLXGtk73B5zvWaRoGpkzd5tU9ZGVAULbQoJ");
7
  try {
8
    const isValid = await solanaRpc.isBlockhashValid(blockHash)
9
    console.log("Is blockhash valid:", isValid);
10
  } catch (error) {
11
    console.error("Error checking blockhash validity:", error);
12
  }
13
})();

1
import { createSolanaRpc, blockhash } from "@solana/kit";
2

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

6
  const blockHash = blockhash("EPnQzurHhxLXGtk73B5zvWaRoGpkzd5tU9ZGVAULbQoJ");
7
  try {
8
    const isValid = await solanaRpc.isBlockhashValid(blockHash)
9
    console.log("Is blockhash valid:", isValid);
10
  } catch (error) {
11
    console.error("Error checking blockhash validity:", error);
12
  }
13
})();

1
use reqwest::header;
2
use reqwest::Client;
3
use std::error::Error;
4

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

10
    let client = Client::new();
11
    let json_data = r#"
12
    {
13
        "id": 45,
14
        "jsonrpc": "2.0",
15
        "method": "isBlockhashValid",
16
        "params": [
17
        JupRhwjrF5fAcs6dFhLH59r3TJFvbcyLP2NRM8UGH9H
18
        ]
19
    }
20
    "#;
21
    let response = client
22
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
23
        .headers(headers)
24
        .body(json_data)
25
        .send()
26
        .await?; 
27

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

31
    Ok(())
32
}

1
use reqwest::header;
2
use reqwest::Client;
3
use std::error::Error;
4

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

10
    let client = Client::new();
11
    let json_data = r#"
12
    {
13
        "id": 45,
14
        "jsonrpc": "2.0",
15
        "method": "isBlockhashValid",
16
        "params": [
17
        JupRhwjrF5fAcs6dFhLH59r3TJFvbcyLP2NRM8UGH9H
18
        ]
19
    }
20
    "#;
21
    let response = client
22
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
23
        .headers(headers)
24
        .body(json_data)
25
        .send()
26
        .await?; 
27

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

31
    Ok(())
32
}

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'isBlockhashValid',
7
  [
8
  "JupRhwjrF5fAcs6dFhLH59r3TJFvbcyLP2NRM8UGH9H",
9
  {
10
    "commitment": "finalized"
11
  }
12
],
13
  undefined,
14
  'https://docs-demo.solana-mainnet.quiknode.pro/'
15
)
16

17
console.log(result)

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'isBlockhashValid',
7
  [
8
  "JupRhwjrF5fAcs6dFhLH59r3TJFvbcyLP2NRM8UGH9H",
9
  {
10
    "commitment": "finalized"
11
  }
12
],
13
  undefined,
14
  'https://docs-demo.solana-mainnet.quiknode.pro/'
15
)
16

17
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "isBlockhashValid",
8
        [
9
            "JupRhwjrF5fAcs6dFhLH59r3TJFvbcyLP2NRM8UGH9H",
10
            {
11
                "commitment": "finalized"
12
            }
13
        ],
14
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
15
    )
16
    print(result)
17

18
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "isBlockhashValid",
8
        [
9
            "JupRhwjrF5fAcs6dFhLH59r3TJFvbcyLP2NRM8UGH9H",
10
            {
11
                "commitment": "finalized"
12
            }
13
        ],
14
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
15
    )
16
    print(result)
17

18
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "isBlockhashValid",
7
  params: [
8
    "JupRhwjrF5fAcs6dFhLH59r3TJFvbcyLP2NRM8UGH9H",
9
    {
10
      "commitment" => "finalized"
11
    }
12
  ],
13
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
14
)
15

16
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "isBlockhashValid",
7
  params: [
8
    "JupRhwjrF5fAcs6dFhLH59r3TJFvbcyLP2NRM8UGH9H",
9
    {
10
      "commitment" => "finalized"
11
    }
12
  ],
13
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
14
)
15

16
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "isBlockhashValid",
10
            Some(serde_json::json!([
11
    "JupRhwjrF5fAcs6dFhLH59r3TJFvbcyLP2NRM8UGH9H",
12
    {
13
        "commitment": "finalized"
14
    }
15
])),
16
            None,
17
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
18
        )
19
        .await?;
20

21
    println!("{result}");
22
    Ok(())
23
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "isBlockhashValid",
10
            Some(serde_json::json!([
11
    "JupRhwjrF5fAcs6dFhLH59r3TJFvbcyLP2NRM8UGH9H",
12
    {
13
        "commitment": "finalized"
14
    }
15
])),
16
            None,
17
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
18
        )
19
        .await?;
20

21
    println!("{result}");
22
    Ok(())
23
}

Response

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "context": {
5
      "slot": 451948217,
6
      "apiVersion": "4.2.2"
7
    },
8
    "value": false
9
  },
10
  "id": 45
11
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "context": {
5
      "slot": 451948217,
6
      "apiVersion": "4.2.2"
7
    },
8
    "value": false
9
  },
10
  "id": 45
11
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free