getnodeinfo - Tron

getnodeinfo. Returns version, configuration, and peer connection details for the queried node.

getnodeinfo - tron [Value: 20CU]
Returns version, configuration, and peer connection details for the queried node.
Use cases

Use cases

  • Also available as GET
  • Check a node's sync status and software version before relying on its data
  • Monitor a node's peer count for health checks
Constraints

Constraints

  • Reflects only the specific node queried, not the network as a whole
  • Also available under /walletsolidity/ for confirmed (solidified) data instead of the latest state
Get started
Unlock Access to 100+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl --request POST \
     --url https://lb.drpc.live/tron/{API-KEY}/wallet/getnodeinfo \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{}'
Copy
Response
200
{
  "activeConnectCount": 3,
  "beginSyncNum": 66987546,
  "block": "Num:66987565,ID:0000000003fe262d52bfa4b2814f816fd2e57af5b98a33d60d8630a03a908e0e",
  "solidityBlock": "Num:66987547,ID:0000000003fe261b9e6e8091f5bd92dc67816890ec4739f6fe5109ad7779120c",
  "currentConnectCount": 60,
  "passiveConnectCount": 57,
  "totalFlow": 0,
  "configNodeInfo": {
    "codeVersion": "4.8.1",
    "versionNum": "18636",
    "p2pVersion": "201910292",
    "listenPort": 18888,
    "discoverEnable": true,
    "maxConnectCount": 60,
    "supportConstant": true,
    "dbVersion": 2
  },
  "machineInfo": {
    "cpuCount": 16,
    "cpuRate": 0.06666666666666667,
    "totalMemory": 32726257664,
    "freeMemory": 232448000,
    "jvmTotalMemory": 18683133952,
    "jvmFreeMemory": 7802853696,
    "javaVersion": "1.8.0_291",
    "osName": "Linux 3.10.0-1160.49.1.el7.x86_64",
    "threadCount": 361,
    "deadLockThreadCount": 0
  }
}
Copy

Request params

idinteger
jsonrpcstring
methodstring
ParametersThis method does not accept any parameters.

Response

200
Returns version, configuration, and peer connection details for the queried node.

Response params

object
activeConnectCountinteger
The number of outbound peer connections this node initiated itself.
beginSyncNuminteger
The block height from which this node started its most recent sync cycle.
blockstring
The node's current latest block, formatted as "Num:<height>,ID:<blockID>".
solidityBlockstring
The node's latest solidified (irreversible) block, formatted as "Num:<height>,ID:<blockID>".
currentConnectCountinteger
The total number of peer connections currently established by this node.
passiveConnectCountinteger
The number of inbound peer connections initiated by other nodes toward this one.
totalFlowinteger
The cumulative amount of network traffic this node has processed.
configNodeInfoobject
Static configuration and version details for this node.
object
codeVersionstring
The version of the java-tron software this node is running.
versionNumstring
The internal numeric build identifier corresponding to this software version.
p2pVersionstring
The version of the peer-to-peer networking protocol this node uses.
listenPortinteger
The TCP port this node listens on for peer connections.
discoverEnableboolean
Whether this node participates in peer discovery to find new nodes on the network.
maxConnectCountinteger
The maximum number of peer connections this node is configured to maintain.
supportConstantboolean
Whether this node supports executing read-only (constant) smart contract calls.
dbVersioninteger
The version of the underlying database schema this node uses for its chain state.
machineInfoobject
Hardware and runtime resource statistics for the machine hosting this node.
object
cpuCountinteger
The number of CPU cores available to this node's host machine.
cpuRatenumber
The current fraction of CPU capacity being utilized, expressed as a value between 0 and 1.
totalMemoryinteger
The total physical memory available on this node's host machine, in bytes.
freeMemoryinteger
The amount of physical memory currently unused on this node's host machine, in bytes.
jvmTotalMemoryinteger
The total heap memory allocated to the Java Virtual Machine running this node, in bytes.
jvmFreeMemoryinteger
The amount of JVM heap memory currently unused, in bytes.
javaVersionstring
The version of the Java runtime this node is executing on.
osNamestring
The name and version of the operating system running on this node's host machine.
threadCountinteger
The number of threads currently active within this node's process.
deadLockThreadCountinteger
The number of threads currently detected as deadlocked within this node's process.
Node infoList Nodes