Solana gRPC is available on Mainnet and Devnet, included with Scale and Business plans. Learn more on our pricing page.

Parameters

This method does not accept any parameters

Returns

version

object

The version object which contains the following fields:

package

string

Specifies the version of the yellowstone-grpc-geyser package being used

version

string

Indicates the plugin's version

proto

string

Version of the protocol buffer definition used by Solana gRPC

solana

string

Specifies the version of the Solana blockchain that the plugin is compatible with

git

string

Provides the short hash of the Git commit from which this build was created

rustc

string

Version of the Rust compiler used to build the plugin

buildts

string

A timestamp indicating when this version was built

extra

object

The extra object which contains the following fields:

hostname

string

The hostname of the server or instance running the plugin

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

73
	fmt.Printf("Yellowstone gRPC Version:\n")
74
	fmt.Printf("  GeyserGrpc: %s\n", version.GetVersion())
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
    version, err := client.GetVersion(ctx, &pb.GetVersionRequest{})
69
	if err != nil {
70
		log.Fatalf("Failed to get version: %v", err)
71
	}
72

73
	fmt.Printf("Yellowstone gRPC Version:\n")
74
	fmt.Printf("  GeyserGrpc: %s\n", version.GetVersion())
75

76
}
77

1
import Client 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
    try {
18
        const version = await client.getVersion();
19
        console.log("Solana Version Information:");
20
        console.log(`getVersion: ${version.version}`);
21
    } catch (error) {
22
        console.error("Error fetching version:", error);
23
    }
24
}
25

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

1
import Client 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
    try {
18
        const version = await client.getVersion();
19
        console.log("Solana Version Information:");
20
        console.log(`getVersion: ${version.version}`);
21
    } catch (error) {
22
        console.error("Error fetching version:", error);
23
    }
24
}
25

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

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free