2 JSON-RPC API
2.9 节点管理类接口
节点管理类接口包括节点的运行状态server_info，节点的联网情况peers等。
2.9.1 获取节点运行状态
请求：
{
"method": "server_info",
"params": [
{
}
]
}
| 字段名称 | 类型 | 说明 |
|---|---|---|
| method | String | RPC接口名称，server_info |
响应：
{
"result": {
"info": {
"build_version": "0.1.5",
"complete_ledgers": "1-2475370",
"hostid": "iZbp11cebhr7k0wvvt5av5Z",
"io_latency_ms": 1,
"last_close": {
"converge_time_s": 9.997999999999999,
"proposers": 2
},
"load": {
"job_types": [
{
"in_progress": 1,
"job_type": "clientCommand"
},
{
"job_type": "peerCommand",
"per_second": 4
},
{
"job_type": "WriteNode",
"per_second": 1
}
],
"threads": 4
},
"load_factor": 1,
"peers": 4,
"pubkey_node": "n9MD6S4mceiimH1kXmLaZCD7HLhJGjUpuEpHtRMQ3UuWT81mZ2RB",
"pubkey_validator": "n9K63QHvPb4YPVpit4ALFRFCszUWtD41eUbyeAHi94RUitzNvSmk",
"server_state": "proposing",
"state_accounting": {
"connected": {
"duration_us": "10001708",
"transitions": 2
},
"disconnected": {
"duration_us": "361113991",
"transitions": 1
},
"full": {
"duration_us": "5686201570507",
"transitions": 260
},
"syncing": {
"duration_us": "2960205089",
"transitions": 261
},
"tracking": {
"duration_us": "569943923",
"transitions": 261
}
},
"uptime": 5689752,
"validated_ledger": {
"age": 4,
"base_fee_hwt": 0.01,
"hash": "A684B8DBBD8BA7E6F7D1CA868AC5CE6C841A33B7A6390B49C4239B5DD25D283B",
"reserve_base_hwt": 30,
"reserve_inc_hwt": 5,
"seq": 2475370
},
"validation_quorum": 3
},
"status": "success"
}
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| build_version | string | 节点程序版本号 |
| complete_ledgers | string | 本地账本区间 |
| hostid | string | 节点主机的标识 |
| last_close | object | 最新关闭账本的信息 |
| load | object | 当前节点的负载状态 |
| peers | unsigned int | 建立连接的节点数量 |
| pubkey_node | string | 节点的公钥 |
| pubkey_validator | string | 验证节点的公钥 |
| server_state | object | 节点的状态。可能出现的值包括：disconnected，表示已经断开网络连接。connected，，表示与已经建立网络连接。syncing，表示正在同步账本。tracking，表示正在校验账本。full，表示已经完成账本同步，本地账本是最新的账本。 |
| state_accounting | object | 账户集的统计信息 |
| uptime | unsigned int | 节点的已经运行的时间，单位s。 |
| validated_ledger | object | 最新被验证节点的信息 |
| validation_quorum | unsigned int | 达成共识的验证节点数最低门槛 |
2.9.2 获取节点联网状态
请求：
{
"method": "peers",
"params": [
{
}
]
}
| 字段名称 | 类型 | 说明 |
|---|---|---|
| method | String | RPC接口名称，peers |
响应：
{
"result": {
"peers": [
{
"address": "172.16.0.10:35562",
"complete_ledgers": "1 - 2475376",
"inbound": true,
"latency": 16,
"load": 64,
"public_key": "n94MvDvyWp5NywVLKGX9SjY87hrhChE2DTvPv2AMgTHFm7kFMUEA",
"uptime": 494873,
"version": "hwchaind-0.1.5"
},
{
"address": "172.16.0.13:51266",
"complete_ledgers": "1 - 2475376",
"latency": 0,
"ledger": "B9702E26A5A585A5B0A2CEEFAB9F6A25884443EE4C34FF278A98B966B5AB507D",
"load": 67,
"public_key": "n94UPqxKhpyuvJ6UYGTvJ6mVHHefCbmhcBHpsJBuSQqRzSy5YHYz",
"uptime": 5689816,
"version": "hwchaind-0.1.5"
},
{
"address": "172.16.0.11:40084",
"complete_ledgers": "1 - 2475376",
"inbound": true,
"latency": 0,
"ledger": "B9702E26A5A585A5B0A2CEEFAB9F6A25884443EE4C34FF278A98B966B5AB507D",
"load": 54,
"public_key": "n9KFPLi468MbvHaU7Rj8Gcm9x1Mdp2ZVS2oMpu6xKbbT1jb6Vkqt",
"uptime": 5688020,
"version": "hwchaind-0.1.5"
},
{
"address": "103.120.227.152:51266",
"complete_ledgers": "1429258 - 2475376",
"latency": 33,
"load": 55,
"public_key": "n9M3BmgFFVmk8FQniCKNChJ1FGe8nzhqN8MYGa3GTEjz3vDJJ1G9",
"uptime": 905452,
"version": "hwchaind-0.1.5"
}
],
"status": "success"
}
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| peers | object | 已经建立网络连接的节点列表 |
| address | object | 当前节点的负载状态 |
| complete_ledgers | unsigned int | 节点账本的区间 |
| latency | object | 网络延时，单位ms |
| ledger | string | 最新账本的Hash |
| load | unsigned int | 节点的负载信息。 |
| public_key | string | 节点的公钥 |
| uptime | unsigned int | 节点的已经运行的时间，单位s。 |
| version | string | 节点程序的版本号 |