net peers
Command
clio net peers [OPTIONS]
Description
Returns a list with the status of all peer connections.
Synopsis
clio net peers
[-h | --help] # Print this help message and exit
Usage
Prerequisites
-
Install the currently supported version of
clio
.note| The
clio
tool is bundled with the Wire software. Installing Wire core will install theclio
andkiod
command line tools. -
You have access to a producing node instance with the
net_api_plugin
loaded.
Example
The following examples demonstrate how to use the clio net peers
command:
- List the status of all peer connections for a local node listening at http address
http://127.0.0.1:8887
:
clio -u http://127.0.0.1:8887 net peers
Output:
[{
"peer": "devnet-0:4444",
"remote_ip": "123.456.78.90",
"remote_port": "4444",
"connecting": false,
"syncing": false,
"is_bp_peer": false,
"is_socket_open": true,
"is_blocks_only": false,
"is_transactions_only": false,
"last_handshake": {
"network_version": 1212,
"chain_id": "0da1bd053a2a63f23cc37bf6df539923a9e0c22632a67390147448174f3bea18",
"node_id": "5fb300c286806faf369f2c7e6129719e1ccf3f4baaa06b9e77cd095f39718480",
"key": "SYS1111111111111111111111111111111114T1Anm",
"time": "1751910927896359786",
"token": "0000000000000000000000000000000000000000000000000000000000000000",
"sig": "SIG_K1_111111111111111111111111111111111111111111111111111111111111111116uk5ne",
"p2p_address": "192.168.50.250:4444 - 5fb300c",
"last_irreversible_block_num": 6593,
"last_irreversible_block_id": "000019c199a7d6b662dc5a25ee46b80cbe37f5bbde7d86a34a853d0009eeda6a",
"head_num": 6594,
"head_id": "000019c2e87658b61119ba1831c0a47e29c685382521769cefdbdd547b71a30d",
"os": "linux",
"agent": "sysio",
"generation": 2
}
},{
"peer": "devnet-1:4444",
"remote_ip": "123.456.78.91",
"remote_port": "4444",
"connecting": false,
"syncing": false,
"is_bp_peer": false,
"is_socket_open": false,
"is_blocks_only": false,
"is_transactions_only": false,
"last_handshake": {
"network_version": 0,
"chain_id": "0000000000000000000000000000000000000000000000000000000000000000",
"node_id": "0000000000000000000000000000000000000000000000000000000000000000",
"key": "SYS1111111111111111111111111111111114T1Anm",
"time": 0,
"token": "0000000000000000000000000000000000000000000000000000000000000000",
"sig": "SIG_K1_111111111111111111111111111111111111111111111111111111111111111116uk5ne",
"p2p_address": "",
"last_irreversible_block_num": 0,
"last_irreversible_block_id": "0000000000000000000000000000000000000000000000000000000000000000",
"head_num": 0,
"head_id": "0000000000000000000000000000000000000000000000000000000000000000",
"os": "",
"agent": "",
"generation": 0
}
....
]
Note: The last_handshake
field contains the chain state of each connected peer as of the last handshake message with the node.