跳转至

/wallet/listnodes

列出节点已发现的对等节点。

  • 源码:framework/src/main/java/org/tron/core/services/http/ListNodesServlet.java
  • Method:GET / POST
  • 别名路径:/net/listnodes
  • Response:api.NodeList

请求参数

GET 和 POST 都从 URL 查询参数读取以下字段;servlet 不解析 POST 请求体。

字段 方法 类型 必填 说明
visible GET / POST bool 否 文本字段格式(仅影响 Address.host):为 true 时,合法的 UTF-8 字节以文本返回;其他情况均使用 hex

示例:

curl --request POST \
     --url https://nile.trongrid.io/wallet/listnodes \
     --header 'accept: application/json'

响应

字段 类型 说明
nodes repeated Node 已知节点
nodes[].address.host string IP 地址;当 visible=true 且字节是合法 UTF-8 时,以文本返回(如 "176.9.148.236");否则返回对应字节的 hex(如 "3137362e392e3134382e323336")
nodes[].address.port int32 端口

响应示例(默认;以下截取前 3 项,实际响应包含数十个节点):

{
  "nodes": [
    { "address": { "host": "3137362e392e3134382e323336", "port": 18888 } },
    { "address": { "host": "35382e3133362e3130332e3833", "port": 18889 } },
    { "address": { "host": "31352e3233352e3233332e313239", "port": 18888 } }
  ]
}

响应示例(visible=true,相同节点对应的 UTF-8 输出):

{
  "nodes": [
    { "address": { "host": "176.9.148.236", "port": 18888 } },
    { "address": { "host": "58.136.103.83", "port": 18889 } },
    { "address": { "host": "15.235.233.129", "port": 18888 } }
  ]
}

如需 UTF-8 格式的 host 字符串,请在 GET 或 POST 请求的 URL 中添加 ?visible=true。节点的 servlet 会忽略 POST JSON 请求体,因此仅在请求体中设置 visible 不会生效,自有节点也是如此。

无节点时返回 {}。

异常响应

方法 触发条件 响应
GET / POST 请求体超过 node.http.maxMessageSize 通常由 SizeLimitHandler 返回 HTTP 413 Payload Too Large
GET / POST 节点内部异常(拉取节点列表或序列化失败) {"Error": "<exceptionClass> : <message>"}