isBlockhashValid gRPC Method - Solana gRPC

Solana gRPC is included with Scale plans and up. Learn more on our pricing page.

Parameters

blockhash

string

REQUIRED

Loading...

commitment

string

Loading...

PROCESSED

string

Loading...

CONFIRMED

string

Loading...

FINALIZED

string

Loading...

Returns

valid

boolean

Loading...

slot

string

Loading...

Request

1
package main
2

3
import (
4
	"context"
5
	"crypto/tls"
6
	"fmt"
7
	"log"
8
	"time"
9

10
	pb "yellowstone/proto"
11

12

13
	"google.golang.org/grpc"
14
	"google.golang.org/grpc/credentials"
15
	"google.golang.org/grpc/encoding/gzip"
16
	"google.golang.org/grpc/keepalive"
17
)
18

19
// Quicknode endpoints consist of two crucial components: the endpoint name and the corresponding token
20
// For eg: QN Endpoint: https://docs-demo.solana-mainnet.quiknode.pro/abcde123456789
21
// endpoint will be: docs-demo.solana-mainnet.quiknode.pro:443  {443 is the port number for gRPC}
22
// token will be : abcde123456789
23

24
var (
25
	endpoint = "YOUR_QN_ENDPOINT:443"
26
	token    = "YOUR_TOKEN_NUMBER"
27
)
28

29
var kacp = keepalive.ClientParameters{
30
	Time:                10 * time.Second,
31
	Timeout:             time.Second,
32
	PermitWithoutStream: true,
33
}
34

35
type tokenAuth struct {
36
	token string
37
}
38

39
func (t tokenAuth) GetRequestMetadata(ctx context.Context, in ...string) (map[string]string, error) {
40
	return map[string]string{
41
		"x-token": t.token,
42
	}, nil
43
}
44

45
func (tokenAuth) RequireTransportSecurity() bool {
46
	return true
47
}
48

49
func main() {
50
	opts := []grpc.DialOption{
51
		grpc.WithTransportCredentials(credentials.NewTLS(&tls.Config{})),
52
		grpc.WithKeepaliveParams(kacp),
53
		grpc.WithDefaultCallOptions(grpc.MaxCallRecvMsgSize(1024*1024*1024), grpc.UseCompressor(gzip.Name)),
54
		grpc.WithPerRPCCredentials(tokenAuth{token: token}),
55
	}
56

57
	conn, err := grpc.NewClient(endpoint, opts...)
58
	if err != nil {
59
		log.Fatalf("Failed to connect: %v", err)
60
	}
61
	defer conn.Close()
62

63
	client := pb.NewGeyserClient(conn)
64

65
    ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
66
    defer cancel()
67

68
    const BLOCKHASH_TO_CHECK = "FJcV9hJycVRkyHWf3P8qjxE2vLs6dF38RTZzZBNvNM1z"
69

70
	isBlockhashValid, err := client.IsBlockhashValid(ctx, &pb.IsBlockhashValidRequest{
71
		Blockhash: BLOCKHASH_TO_CHECK,
72
	})
73
	if err != nil {
74
		log.Fatalf("Failed to check blockhash validity: %v", err)
75
	}
76

77

78
	fmt.Printf("Slot: %d\n", isBlockhashValid.Slot)
79
	fmt.Printf("Valid: %v\n", isBlockhashValid.Valid)
80

81

82
}
83

1
package main
2

3
import (
4
	"context"
5
	"crypto/tls"
6
	"fmt"
7
	"log"
8
	"time"
9

10
	pb "yellowstone/proto"
11

12

13
	"google.golang.org/grpc"
14
	"google.golang.org/grpc/credentials"
15
	"google.golang.org/grpc/encoding/gzip"
16
	"google.golang.org/grpc/keepalive"
17
)
18

19
// Quicknode endpoints consist of two crucial components: the endpoint name and the corresponding token
20
// For eg: QN Endpoint: https://docs-demo.solana-mainnet.quiknode.pro/abcde123456789
21
// endpoint will be: docs-demo.solana-mainnet.quiknode.pro:443  {443 is the port number for gRPC}
22
// token will be : abcde123456789
23

24
var (
25
	endpoint = "YOUR_QN_ENDPOINT:443"
26
	token    = "YOUR_TOKEN_NUMBER"
27
)
28

29
var kacp = keepalive.ClientParameters{
30
	Time:                10 * time.Second,
31
	Timeout:             time.Second,
32
	PermitWithoutStream: true,
33
}
34

35
type tokenAuth struct {
36
	token string
37
}
38

39
func (t tokenAuth) GetRequestMetadata(ctx context.Context, in ...string) (map[string]string, error) {
40
	return map[string]string{
41
		"x-token": t.token,
42
	}, nil
43
}
44

45
func (tokenAuth) RequireTransportSecurity() bool {
46
	return true
47
}
48

49
func main() {
50
	opts := []grpc.DialOption{
51
		grpc.WithTransportCredentials(credentials.NewTLS(&tls.Config{})),
52
		grpc.WithKeepaliveParams(kacp),
53
		grpc.WithDefaultCallOptions(grpc.MaxCallRecvMsgSize(1024*1024*1024), grpc.UseCompressor(gzip.Name)),
54
		grpc.WithPerRPCCredentials(tokenAuth{token: token}),
55
	}
56

57
	conn, err := grpc.NewClient(endpoint, opts...)
58
	if err != nil {
59
		log.Fatalf("Failed to connect: %v", err)
60
	}
61
	defer conn.Close()
62

63
	client := pb.NewGeyserClient(conn)
64

65
    ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
66
    defer cancel()
67

68
    const BLOCKHASH_TO_CHECK = "FJcV9hJycVRkyHWf3P8qjxE2vLs6dF38RTZzZBNvNM1z"
69

70
	isBlockhashValid, err := client.IsBlockhashValid(ctx, &pb.IsBlockhashValidRequest{
71
		Blockhash: BLOCKHASH_TO_CHECK,
72
	})
73
	if err != nil {
74
		log.Fatalf("Failed to check blockhash validity: %v", err)
75
	}
76

77

78
	fmt.Printf("Slot: %d\n", isBlockhashValid.Slot)
79
	fmt.Printf("Valid: %v\n", isBlockhashValid.Valid)
80

81

82
}
83

1
import Client, { CommitmentLevel } from "@triton-one/yellowstone-grpc";
2

3
// Quicknode endpoints consist of two crucial components: the endpoint name and the corresponding token
4
// For eg: QN Endpoint: https://docs-demo.solana-mainnet.quiknode.pro/abcde123456789
5
// endpoint will be: https://docs-demo.solana-mainnet.quiknode.pro:443  {443 is the port number for gRPC}
6
// token will be : abcde123456789
7

8
const ENDPOINT = "https://YOUR_QN_ENDPOINT:443";
9
const TOKEN = "YOUR_TOKEN_NUMBER";
10

11
const BLOCKHASH_TO_CHECK = "FJcV9hJycVRkyHWf3P8qjxE2vLs6dF38RTZzZBNvNM1z";
12

13
async function main() {
14
    const client = new Client(ENDPOINT, TOKEN, {
15
        grpcDefaultCompressionAlgorithm: 0, // 0 = gzip, 1 = zstd
16
    });
17
    await client.connect();
18

19
    const commitment = CommitmentLevel.CONFIRMED;
20

21
    try {
22
        const result = await client.isBlockhashValid(BLOCKHASH_TO_CHECK, commitment);
23
        console.log(`Blockhash validity check for ${BLOCKHASH_TO_CHECK}:`);
24
        console.log(JSON.stringify(result, null, 2));
25

26
    } catch (error) {
27
        console.error("Error checking blockhash validity:", error);
28
    }
29
}
30

31
main()
32
    .catch((err) => {
33
        console.error("Unhandled error:", err);
34
        process.exit(1);
35
    });
36

1
import Client, { CommitmentLevel } from "@triton-one/yellowstone-grpc";
2

3
// Quicknode endpoints consist of two crucial components: the endpoint name and the corresponding token
4
// For eg: QN Endpoint: https://docs-demo.solana-mainnet.quiknode.pro/abcde123456789
5
// endpoint will be: https://docs-demo.solana-mainnet.quiknode.pro:443  {443 is the port number for gRPC}
6
// token will be : abcde123456789
7

8
const ENDPOINT = "https://YOUR_QN_ENDPOINT:443";
9
const TOKEN = "YOUR_TOKEN_NUMBER";
10

11
const BLOCKHASH_TO_CHECK = "FJcV9hJycVRkyHWf3P8qjxE2vLs6dF38RTZzZBNvNM1z";
12

13
async function main() {
14
    const client = new Client(ENDPOINT, TOKEN, {
15
        grpcDefaultCompressionAlgorithm: 0, // 0 = gzip, 1 = zstd
16
    });
17
    await client.connect();
18

19
    const commitment = CommitmentLevel.CONFIRMED;
20

21
    try {
22
        const result = await client.isBlockhashValid(BLOCKHASH_TO_CHECK, commitment);
23
        console.log(`Blockhash validity check for ${BLOCKHASH_TO_CHECK}:`);
24
        console.log(JSON.stringify(result, null, 2));
25

26
    } catch (error) {
27
        console.error("Error checking blockhash validity:", error);
28
    }
29
}
30

31
main()
32
    .catch((err) => {
33
        console.error("Unhandled error:", err);
34
        process.exit(1);
35
    });
36

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free