getnetworkinfo

Command#

pacprotocol-cli getnetworkinfo

getnetworkinfo Returns an object containing various state info regarding P2P networking.

Examples#

pacprotocol-cli getnetworkinfo

curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getnetworkinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:1111/

Result#

{
  "version": xxxxx,                      #(numeric) the server version
  "buildversion": "x.x.x.x-xxx",       #(string) the server build version including RC info or commit as relevant
  "subversion": "/pacprotocol:x.x.x/", #(string) the server subversion string
  "protocolversion": xxxxx,              #(numeric) the protocol version
  "localservices": "xxxxxxxxxxxxxxxx", #(string) the services we offer to the network
  "localrelay": true|false,              #(bool) true if transaction relay is requested from peers
  "timeoffset": xxxxx,                   #(numeric) the time offset
  "connections": xxxxx,                  #(numeric) the number of connections
  "networkactive": true|false,           #(bool) whether p2p networking is enabled
  "socketevents": "xxx/",              #(string) the socket events mode, either kqueue, epoll, poll or select
  "networks": [                          #(array) information per network
  {
    "name": "xxx",                     #(string) network #(ipv4, ipv6 or onion)
    "limited": true|false,               #(boolean) is the network limited using -onlynet?
    "reachable": true|false,             #(boolean) is the network reachable?
    "proxy": "host:port"               #(string) the proxy that is used for this network, or empty if none
    "proxy_randomize_credentials": true|false,  #(string) Whether randomized credentials are used
  }
  ,...
  ],
  "relayfee": x.xxxxxxxx,                #(numeric) minimum relay fee for transactions in PAC/kB
  "incrementalfee": x.xxxxxxxx,          #(numeric) minimum fee increment for mempool limiting in PAC/kB
  "localaddresses": [                    #(array) list of local addresses
  {
    "address": "xxxx",                 #(string) network address
    "port": xxx,                         #(numeric) network port
    "score": xxx                         #(numeric) relative score
  }
  ,...
  ]
  "warnings": "..."                    #(string) any network and blockchain warnings
}

Running following help command

 pacprotocol-cli help getnetworkinfo

Will produce following output:

getnetworkinfo
Returns an object containing various state info regarding P2P networking.

Result:
{
  "version": xxxxx,                      (numeric) the server version
  "buildversion": "x.x.x.x-xxx",       (string) the server build version including RC info or commit as relevant
  "subversion": "/pacprotocol:x.x.x/", (string) the server subversion string
  "protocolversion": xxxxx,              (numeric) the protocol version
  "localservices": "xxxxxxxxxxxxxxxx", (string) the services we offer to the network
  "localrelay": true|false,              (bool) true if transaction relay is requested from peers
  "timeoffset": xxxxx,                   (numeric) the time offset
  "connections": xxxxx,                  (numeric) the number of connections
  "networkactive": true|false,           (bool) whether p2p networking is enabled
  "socketevents": "xxx/",              (string) the socket events mode, either kqueue, epoll, poll or select
  "networks": [                          (array) information per network
  {
    "name": "xxx",                     (string) network (ipv4, ipv6 or onion)
    "limited": true|false,               (boolean) is the network limited using -onlynet?
    "reachable": true|false,             (boolean) is the network reachable?
    "proxy": "host:port"               (string) the proxy that is used for this network, or empty if none
    "proxy_randomize_credentials": true|false,  (string) Whether randomized credentials are used
  }
  ,...
  ],
  "relayfee": x.xxxxxxxx,                (numeric) minimum relay fee for transactions in PAC/kB
  "incrementalfee": x.xxxxxxxx,          (numeric) minimum fee increment for mempool limiting in PAC/kB
  "localaddresses": [                    (array) list of local addresses
  {
    "address": "xxxx",                 (string) network address
    "port": xxx,                         (numeric) network port
    "score": xxx                         (numeric) relative score
  }
  ,...
  ]
  "warnings": "..."                    (string) any network and blockchain warnings
}

Examples:
> pacprotocol-cli getnetworkinfo 
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getnetworkinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:1111/