lightning-listnodes -- Command to get the list of nodes in the own node network.
============================================================
SYNOPSIS
--------
**listnodes** \[id\]
DESCRIPTION
-----------
The **listnodes** command returns nodes in the own node network, or a single one if the node *id* was specified.
EXAMPLE JSON REQUEST
------------
```json
{
"id": 82,
"method": "listnodes",
"params": {
"id": "02e29856dab8ddd9044c18486e4cab79ec717b490447af2d4831e290e48d57638a"
}
}
```
RETURN VALUE
------------
On success, the command will return a list of nodes, each object represents a node, with the following details:
- *nodeid*: A string that rappresents the node id.
- *alias*: A string that rappresents alias of the node on the network.
- *color*: A string that rappresents the personal color of the node.
- *last_timestamp*: An integer that rappresent the last timestamp.
- *features*: A string that rappresent the features value.
- *addresses*: An array that rappresent the addreses avaible. Each address is rappresented with an object with the following properties:
- *type*: A string that rappresent the address type (ipv4 or ipv6).
- *address*: A string that rappresent the address value.
- *port*: An integer that rappresent the port number where the node are listening.
On failure, one of the following error codes may be returned:
- -32602: Error in given parameters.
EXAMPLE JSON RESPONSE
-----
```json
{
"nodes": [
{
"nodeid": "02e29856dab8ddd9044c14586e4cab79ec717b490447af2d4831e290e48d58638a",
"alias": "some_alias",
"color": "68f442",
"last_timestamp": 1597213741,
"features": "02a2a1",
"addresses": [
{
"type": "ipv4",
"address": "zzz.yy.xx.xx",
"port": 9735
}
]
}
]
}
```
AUTHOR
------
Vincenzo Palazzo < < vincenzo.palazzo @ protonmail . com > > wrote the initial version of this man page, but many others did the hard work of actually implementing this rpc command.
SEE ALSO
--------
FIXME:
RESOURCES
---------
Main web site: < https: / / github . com / ElementsProject / lightning >
