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

Parameters

commitment

string

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

PROCESSED

string

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

CONFIRMED

string

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

FINALIZED

string

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

Returns

slot

string

The slot number associated with the latest blockhash.

blockhash

string

The latest blockhash

lastValidBlockHeight

string

The last block height at which the retrieved blockhash is valid

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
    latestBlockHash, err := client.GetLatestBlockhash(ctx, &pb.GetLatestBlockhashRequest{})
69
	if err != nil {
70
		log.Fatalf("Failed to get latest blockhash: %v", err)
71
	}
72

73
	fmt.Printf("Latest Blockhash Information:\n")
74
	fmt.Printf("  Blockhash: %+v\n", latestBlockHash)
75

76
}
77

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
    latestBlockHash, err := client.GetLatestBlockhash(ctx, &pb.GetLatestBlockhashRequest{})
69
	if err != nil {
70
		log.Fatalf("Failed to get latest blockhash: %v", err)
71
	}
72

73
	fmt.Printf("Latest Blockhash Information:\n")
74
	fmt.Printf("  Blockhash: %+v\n", latestBlockHash)
75

76
}
77

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
async function main() {
12
    const client = new Client(ENDPOINT, TOKEN, {
13
        grpcDefaultCompressionAlgorithm: 0, // 0 = gzip, 1 = zstd
14
    });
15
    await client.connect();
16

17
    const commitment = CommitmentLevel.CONFIRMED;
18

19
    try {
20
        const response = await client.getLatestBlockhash(commitment);
21
        console.log(`Latest Blockhash: ${JSON.stringify(response, null, 2)}`);
22
    } catch (error) {
23
        console.error("Error fetching latest blockhash:", error);
24
    }
25
}
26

27
main()
28
    .catch((err) => {
29
        console.error("Unhandled error:", err);
30
        process.exit(1);
31
    });
32

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
async function main() {
12
    const client = new Client(ENDPOINT, TOKEN, {
13
        grpcDefaultCompressionAlgorithm: 0, // 0 = gzip, 1 = zstd
14
    });
15
    await client.connect();
16

17
    const commitment = CommitmentLevel.CONFIRMED;
18

19
    try {
20
        const response = await client.getLatestBlockhash(commitment);
21
        console.log(`Latest Blockhash: ${JSON.stringify(response, null, 2)}`);
22
    } catch (error) {
23
        console.error("Error fetching latest blockhash:", error);
24
    }
25
}
26

27
main()
28
    .catch((err) => {
29
        console.error("Unhandled error:", err);
30
        process.exit(1);
31
    });
32

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free