Query operator information

Prerequisites

(https://docs.tingchain.org/ting-application-chain-ecosystem/developers/working-with-node/query-operator-information#prerequisites)

This guide assumes you have followed the Local Setup or guide on how to set up an IBFT cluster on the cloud.

A functioning node is required in order to query any kind of operator information.

With the Ting Application Chain, node operators are in control and informed about what the node they're operating is doing. At any time, they can use the node information layer, built on top of gRPC, and get meaningful information — no log sifting required.

If your node isn't running on 127.0.0.1:8545 you should add the flag --grpc-address <address:port> to the commands listed in this document.

Peer information

(https://docs.tingchain.org/ting-application-chain-ecosystem/developers/working-with-node/query-operator-information#peer-information)

Peers list

To get a complete list of connected peers (including the running node itself), run:

List peers

polygon-edge peers list

This returns a list of libp2p addresses that are currently peers of the running client.

Peer status

To get the status of a specific peer, run:

Peer status

polygon-edge peers status --peer-id <address>

Replace <address> with the libp2p address of the peer.

IBFT info

(https://docs.tingchain.org/ting-application-chain-ecosystem/developers/working-with-node/query-operator-information#ibft-info)

Operators often need information about the operating node's state in IBFT consensus. The Ting Application Chain provides commands to query this information.

Snapshots

Return the most recent snapshot:

Latest snapshot

polygon-edge ibft snapshot

Query the snapshot at a specific height (block number):

Snapshot at specific block

polygon-edge ibft snapshot --num <block-number>

Candidates

Get the latest info on candidates (current proposed candidates and those not yet included):

IBFT candidates

polygon-edge ibft candidates

Status

Return the current validator key of the running IBFT client:

IBFT status

polygon-edge ibft status

Transaction pool

(https://docs.tingchain.org/ting-application-chain-ecosystem/developers/working-with-node/query-operator-information#transaction-pool)

Find the current number of transactions in the transaction pool:

Txpool status

polygon-edge txpool status