GetNodeInfo - Tron

Example code for the GetNodeInfo gRPC method. Complete guide on how to use GetNodeInfo gRPC method in GetBlock Web3 documentation.

This method returns diagnostic information about the node, including its version, active connections, and block-sync state.

Service

This method is served by the protocol.Wallet service.

Method

rpc GetNodeInfo (EmptyMessage) returns (NodeInfo)

Request Message

EmptyMessage

This message has no fields.

Request

grpcurl

grpcurl -H 'x-api-key: <ACCESS-TOKEN>' \
  -d '{}' \
  go.getblock.io:443 protocol.Wallet/GetNodeInfo

Python

example.py

import grpc
# Stubs generated from java-tron's api.proto with grpcio-tools
from api import api_pb2_grpc
from core import Contract_pb2, Tron_pb2

creds = grpc.ssl_channel_credentials()
channel = grpc.secure_channel('go.getblock.io:443', creds)
metadata = [('x-api-key', '<ACCESS-TOKEN>')]
stub = api_pb2_grpc.WalletStub(channel)

response = stub.GetNodeInfo(Tron_pb2.EmptyMessage(), metadata=metadata)
print(response)

Go

example.go

conn, _ := grpc.Dial(
    "go.getblock.io:443",
    grpc.WithTransportCredentials(credentials.NewTLS(&tls.Config{})),
)
defer conn.Close()

client := api.NewWalletClient(conn)
ctx := metadata.AppendToOutgoingContext(
    context.Background(), "x-api-key", "<ACCESS-TOKEN>")

resp, _ := client.GetNodeInfo(ctx, &api.EmptyMessage{})
fmt.Println(resp)

Response Message

NodeInfo

Field	Type	Description
block	string	The node's current head block
solidityBlock	string	The node's latest confirmed (Solidity) block
currentConnectCount	int32	Number of peer connections
configNodeInfo	ConfigNodeInfo	Node configuration, including the java-tron version

Use Cases

• Health Checks: Confirm a node is connected and syncing

• Confirmation Lag: Compare head and Solidity block heights

• Version Reporting: Read the java-tron version for support

• Peer Monitoring: Track peer connection counts

Error Handling

Code	Status	Description
3	INVALID_ARGUMENT	A request field is missing or malformed
5	NOT_FOUND	The requested account, block, or transaction does not exist
16	UNAUTHENTICATED	The access token is missing or invalid
13	INTERNAL	The node failed to process the request