Parameters

address

string

The validator operator or consensus address to query.

Returns

s

string

The application-level status of the indexer response.

errmsg

string

An error message when the request status indicates a failure; otherwise empty.

data

object

The validator record matching the requested address.

id

string

The internal identifier assigned to the validator record.

moniker

string

The human-readable name published by the validator.

operator_address

string

The validator operator address.

consensus_address

string

The validator’s consensus address.

jailed

boolean

Whether the validator is currently jailed from participating in consensus.

status

integer

The validator bonding status or request-specific execution status.

tokens

string

The validator’s bonded token amount, represented as a decimal string.

delegator_shares

string

The total delegator shares issued by the validator, represented as a decimal string.

description

object

The validator profile information published by its operator.

moniker

string

The human-readable name published by the validator.

identity

string

The optional identity identifier published by the validator.

website

string

The website URL published by the validator.

security_contact

string

The security contact information published by the validator.

details

string

The validator description supplied by its operator.

image_url

string

The URL of the validator or contract image.

unbonding_height

string

The block height at which the validator began unbonding.

unbonding_time

string

The UTC timestamp at which the validator began unbonding.

commission_rate

string

The validator’s current commission rate.

commission_max_rate

string

The maximum commission rate the validator may configure.

commission_max_change_rate

string

The maximum amount by which the validator commission rate may change per update.

commission_update_time

string

The UTC timestamp of the validator’s latest commission update.

proposed

string

The number of sampled blocks proposed by the validator.

signed

string

The number of sampled blocks signed by the validator.

missed

string

The number of sampled blocks the validator failed to sign.

timestamp

string

The UTC timestamp when the validator record was indexed.

uptimes

array

The validator’s recent per-block signing records.

block_number

string

The height of the Injective block containing the record.

status

string

Whether the validator signed the block represented by this uptime record.

slashing_events

array

The recorded events where the validator was penalized or jailed.

block_number

string

The height of the Injective block containing the record.

block_timestamp

string

The UTC timestamp of the block containing the record.

address

string

The validator address associated with the slashing event.

power

string

The validator voting power recorded at the slashing event.

reason

string

The reason recorded for the validator slashing event.

jailed

string

The jailed-state value recorded for the validator slashing event.

missed_blocks

string

The number of blocks missed in the recorded slashing event.

uptime_percentage

number

The percentage of the latest 10,000 blocks signed by the validator.

image_url

string

The URL of the validator or contract image.

Request

1
package main
2

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

10
	"google.golang.org/grpc"
11
	"google.golang.org/grpc/credentials"
12
	"google.golang.org/grpc/metadata"
13
	"google.golang.org/protobuf/encoding/protojson"
14

15
	pb "injective-indexer-grpc/pb/explorer"
16
)
17

18
const grpcEndpoint = "YOUR_ENDPOINT_NAME.injective-mainnet.quiknode.pro:443"
19
const authToken = "YOUR_TOKEN"
20

21
func main() {
22
	creds := credentials.NewTLS(&tls.Config{MinVersion: tls.VersionTLS12})
23
	conn, err := grpc.Dial(grpcEndpoint, grpc.WithTransportCredentials(creds))
24
	if err != nil {
25
		log.Fatal(err)
26
	}
27
	defer conn.Close()
28

29
	ctx, cancel := context.WithTimeout(context.Background(), 20*time.Second)
30
	defer cancel()
31
	ctx = metadata.AppendToOutgoingContext(ctx, "x-token", authToken)
32

33
	client := pb.NewInjectiveExplorerRPCClient(conn)
34
	request := &pb.GetValidatorRequest{}
35
	requestJSON := `{"address":"injvaloper1xnhwtlx47guamp36wkmnk6h4y7eqqn7jr8xcve"}`
36
	if err := protojson.Unmarshal([]byte(requestJSON), request); err != nil {
37
		log.Fatal(err)
38
	}
39

40
	response, err := client.GetValidator(ctx, request)
41
	if err != nil {
42
		log.Fatal(err)
43
	}
44

45
	data, err := protojson.MarshalOptions{UseProtoNames: true, Indent: "  "}.Marshal(response)
46
	if err != nil {
47
		log.Fatal(err)
48
	}
49
	data = append(data, '\n')
50
	fmt.Print(string(data))
51
}
52

1
package main
2

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

10
	"google.golang.org/grpc"
11
	"google.golang.org/grpc/credentials"
12
	"google.golang.org/grpc/metadata"
13
	"google.golang.org/protobuf/encoding/protojson"
14

15
	pb "injective-indexer-grpc/pb/explorer"
16
)
17

18
const grpcEndpoint = "YOUR_ENDPOINT_NAME.injective-mainnet.quiknode.pro:443"
19
const authToken = "YOUR_TOKEN"
20

21
func main() {
22
	creds := credentials.NewTLS(&tls.Config{MinVersion: tls.VersionTLS12})
23
	conn, err := grpc.Dial(grpcEndpoint, grpc.WithTransportCredentials(creds))
24
	if err != nil {
25
		log.Fatal(err)
26
	}
27
	defer conn.Close()
28

29
	ctx, cancel := context.WithTimeout(context.Background(), 20*time.Second)
30
	defer cancel()
31
	ctx = metadata.AppendToOutgoingContext(ctx, "x-token", authToken)
32

33
	client := pb.NewInjectiveExplorerRPCClient(conn)
34
	request := &pb.GetValidatorRequest{}
35
	requestJSON := `{"address":"injvaloper1xnhwtlx47guamp36wkmnk6h4y7eqqn7jr8xcve"}`
36
	if err := protojson.Unmarshal([]byte(requestJSON), request); err != nil {
37
		log.Fatal(err)
38
	}
39

40
	response, err := client.GetValidator(ctx, request)
41
	if err != nil {
42
		log.Fatal(err)
43
	}
44

45
	data, err := protojson.MarshalOptions{UseProtoNames: true, Indent: "  "}.Marshal(response)
46
	if err != nil {
47
		log.Fatal(err)
48
	}
49
	data = append(data, '\n')
50
	fmt.Print(string(data))
51
}
52

1
const grpc = require('@grpc/grpc-js')
2
const protoLoader = require('@grpc/proto-loader')
3
const path = require('path')
4

5
const GRPC_ENDPOINT = 'YOUR_ENDPOINT_NAME.injective-mainnet.quiknode.pro:443'
6
const AUTH_TOKEN = 'YOUR_TOKEN'
7

8
const definition = protoLoader.loadSync(
9
	path.join(__dirname, 'proto/explorer/injective_explorer_rpc.proto'),
10
	{
11
		keepCase: true,
12
		longs: String,
13
		enums: String,
14
		bytes: String,
15
		defaults: true,
16
		oneofs: true,
17
	}
18
)
19

20
const proto = grpc.loadPackageDefinition(definition).injective_explorer_rpc
21
const client = new proto.InjectiveExplorerRPC(
22
	GRPC_ENDPOINT,
23
	grpc.credentials.createSsl()
24
)
25

26
const metadata = new grpc.Metadata()
27
metadata.add('x-token', AUTH_TOKEN)
28

29
const request = {
30
	address: 'injvaloper1xnhwtlx47guamp36wkmnk6h4y7eqqn7jr8xcve',
31
}
32

33
client.GetValidator(
34
	request,
35
	metadata,
36
	{ deadline: Date.now() + 20000 },
37
	(error, response) => {
38
		if (error) {
39
			console.error(error)
40
			process.exitCode = 1
41
			return
42
		}
43

44
		console.log(JSON.stringify(response, null, 2))
45
		client.close()
46
	}
47
)
48

1
const grpc = require('@grpc/grpc-js')
2
const protoLoader = require('@grpc/proto-loader')
3
const path = require('path')
4

5
const GRPC_ENDPOINT = 'YOUR_ENDPOINT_NAME.injective-mainnet.quiknode.pro:443'
6
const AUTH_TOKEN = 'YOUR_TOKEN'
7

8
const definition = protoLoader.loadSync(
9
	path.join(__dirname, 'proto/explorer/injective_explorer_rpc.proto'),
10
	{
11
		keepCase: true,
12
		longs: String,
13
		enums: String,
14
		bytes: String,
15
		defaults: true,
16
		oneofs: true,
17
	}
18
)
19

20
const proto = grpc.loadPackageDefinition(definition).injective_explorer_rpc
21
const client = new proto.InjectiveExplorerRPC(
22
	GRPC_ENDPOINT,
23
	grpc.credentials.createSsl()
24
)
25

26
const metadata = new grpc.Metadata()
27
metadata.add('x-token', AUTH_TOKEN)
28

29
const request = {
30
	address: 'injvaloper1xnhwtlx47guamp36wkmnk6h4y7eqqn7jr8xcve',
31
}
32

33
client.GetValidator(
34
	request,
35
	metadata,
36
	{ deadline: Date.now() + 20000 },
37
	(error, response) => {
38
		if (error) {
39
			console.error(error)
40
			process.exitCode = 1
41
			return
42
		}
43

44
		console.log(JSON.stringify(response, null, 2))
45
		client.close()
46
	}
47
)
48

1
import json
2
import grpc
3
from google.protobuf.json_format import MessageToJson, ParseDict
4
from explorer import injective_explorer_rpc_pb2
5
from explorer import injective_explorer_rpc_pb2_grpc
6

7
GRPC_ENDPOINT = "YOUR_ENDPOINT_NAME.injective-mainnet.quiknode.pro:443"
8
AUTH_TOKEN = "YOUR_TOKEN"
9

10
channel = grpc.secure_channel(GRPC_ENDPOINT, grpc.ssl_channel_credentials())
11
client = injective_explorer_rpc_pb2_grpc.InjectiveExplorerRPCStub(channel)
12
metadata = (("x-token", AUTH_TOKEN),)
13

14
request_data = {
15
  "address": "injvaloper1xnhwtlx47guamp36wkmnk6h4y7eqqn7jr8xcve"
16
}
17
request = ParseDict(request_data, injective_explorer_rpc_pb2.GetValidatorRequest())
18

19
try:
20
    response = client.GetValidator(request, metadata=metadata, timeout=20)
21
    print(MessageToJson(response, preserving_proto_field_name=True, indent=2))
22
except grpc.RpcError as error:
23
    print(f"gRPC error {error.code().name}: {error.details()}")
24
    raise
25
finally:
26
    channel.close()
27

1
import json
2
import grpc
3
from google.protobuf.json_format import MessageToJson, ParseDict
4
from explorer import injective_explorer_rpc_pb2
5
from explorer import injective_explorer_rpc_pb2_grpc
6

7
GRPC_ENDPOINT = "YOUR_ENDPOINT_NAME.injective-mainnet.quiknode.pro:443"
8
AUTH_TOKEN = "YOUR_TOKEN"
9

10
channel = grpc.secure_channel(GRPC_ENDPOINT, grpc.ssl_channel_credentials())
11
client = injective_explorer_rpc_pb2_grpc.InjectiveExplorerRPCStub(channel)
12
metadata = (("x-token", AUTH_TOKEN),)
13

14
request_data = {
15
  "address": "injvaloper1xnhwtlx47guamp36wkmnk6h4y7eqqn7jr8xcve"
16
}
17
request = ParseDict(request_data, injective_explorer_rpc_pb2.GetValidatorRequest())
18

19
try:
20
    response = client.GetValidator(request, metadata=metadata, timeout=20)
21
    print(MessageToJson(response, preserving_proto_field_name=True, indent=2))
22
except grpc.RpcError as error:
23
    print(f"gRPC error {error.code().name}: {error.details()}")
24
    raise
25
finally:
26
    channel.close()
27

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free