1. Home
  2. Docs
  3. Matic
  4. Polygon SDK
  5. How to Query Operator Information

How to Query Operator Information

How to query operator information


This how-to assumes you have followed the guide on how to set up an IBFT cluster.

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

With the Polygon SDK, 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 you should add a flag --grpc-address <address:port> to the commands listed in this document.

Peer information

Peers list

To get a complete list of connected peers (including the running node itself), run the following command:go run main.go peers listCopy

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

Peer status

For the status of a specific peer, run:go run main.go peers status –peer-id <address>Copy

With the address parameter being the libp2p address of the peer.

IBFT info

Lots of times, an operator might want to know about the state of the operating node in IBFT consensus.

Luckily, the Polygon SDK provides an easy way to find this information.


Running the following command returns the most recent snapshot.go run main.go ibft snapshotCopy

To query the snapshot at a specific height (block number), the operator can run:go run main.go ibft snapshot –num <block-number>Copy


To get the latest info on candidates, the operator can run:go run main.go ibft candidatesCopy

This command queries the current set of proposed candidates, as well as candidates that have not been included yet


The following command returns the status of the overall IBFT client:go run main.go ibft statusCopy

Transaction pool

To find the current number of transactions in the transaction pool, the operator can run:go run main.go txpool statusCopy

Originally published @ https://sdk-docs.polygon.technology/docs/how-tos/howto-query-operator

Was this article helpful to you? Yes No

How can we help?