Honeycluster Docs – Get server information (human-readable)

Server Methods

Get server information (human-readable)

wss://honeycluster.io

rpc method: server_info

Returns a variety of information about the server state in human-readable format. Includes version, uptime, peers, and ledger info.

Try it now

Response · server_info WS Response

{
  "result": {
    "info": {
      "build_version": "2.3.0",
      "complete_ledgers": "32570-89012345",
      "hostid": "HAL",
      "initial_sync_duration_us": "10500000",
      "io_latency_ms": 1,
      "jq_trans_overflow": "0",
      "last_close": {
        "converge_time_s": 3.002,
        "proposers": 41
      },
      "load_factor": 1,
      "network_id": 0,
      "peer_disconnects": "0",
      "peer_disconnects_resources": "0",
      "peers": 216,
      "pubkey_node": "n9MSTfmkKPcSmMFJFasaLAoc3SzMnHNqJQrDBkfrGMn9WUXQ8TTU",
      "server_state": "full",
      "server_state_duration_us": "1234567890",
      "state_accounting": {},
      "time": "2023-Oct-15 12:05:01.123456 UTC",
      "uptime": 86400,
      "validated_ledger": {
        "base_fee_xrp": 0.00001,
        "hash": "4BC50C9B0D8515D3EAAE1E74B29A95804346C491EE1A95BF25E4AAB854A6A652",
        "reserve_base_xrp": 10,
        "reserve_inc_xrp": 2,
        "seq": 89012345
      },
      "validation_quorum": 33
    }
  },
  "status": "success",
  "type": "response",
  "id": 1
}

Request Message

server_info WS Request

application/json

Get server information (human-readable)

Field	Type	Description
`command` required	string	WebSocket command name
`id`	object	Client-supplied identifier to correlate requests with responses.
`api_version`	object	API version for the response format. Version 2 is the default for rippled 2.0+.

Example

Json

{
  "command": "server_info",
  "id": 1
}

Response Message

server_info WS Response

application/json

WebSocket response for server_info

Field	Type	Description
`result`	object
`status`	enum<string>	Available `successerror`
`type`	string
`id`	stringnumber	Echo of the client-provided correlation ID

Example

Json

{
  "result": {
    "info": {
      "build_version": "2.3.0",
      "complete_ledgers": "32570-89012345",
      "hostid": "HAL",
      "initial_sync_duration_us": "10500000",
      "io_latency_ms": 1,
      "jq_trans_overflow": "0",
      "last_close": {
        "converge_time_s": 3.002,
        "proposers": 41
      },
      "load_factor": 1,
      "network_id": 0,
      "peer_disconnects": "0",
      "peer_disconnects_resources": "0",
      "peers": 216,
      "pubkey_node": "n9MSTfmkKPcSmMFJFasaLAoc3SzMnHNqJQrDBkfrGMn9WUXQ8TTU",
      "server_state": "full",
      "server_state_duration_us": "1234567890",
      "state_accounting": {},
      "time": "2023-Oct-15 12:05:01.123456 UTC",
      "uptime": 86400,
      "validated_ledger": {
        "base_fee_xrp": 0.00001,
        "hash": "4BC50C9B0D8515D3EAAE1E74B29A95804346C491EE1A95BF25E4AAB854A6A652",
        "reserve_base_xrp": 10,
        "reserve_inc_xrp": 2,
        "seq": 89012345
      },
      "validation_quorum": 33
    }
  },
  "status": "success",
  "type": "response",
  "id": 1
}

Request

Payload · JSON

const ws = new WebSocket('wss://honeycluster.io');

ws.addEventListener('open', () => {
  const request = {
    "command": "server_info",
    "id": 1
  };
  ws.send(JSON.stringify(request));
});

ws.addEventListener('message', (event: MessageEvent<string>) => {
  const response: unknown = JSON.parse(event.data);
  console.log(response);
  ws.close();
});

Response · server_info WS Response

{
  "result": {
    "info": {
      "build_version": "2.3.0",
      "complete_ledgers": "32570-89012345",
      "hostid": "HAL",
      "initial_sync_duration_us": "10500000",
      "io_latency_ms": 1,
      "jq_trans_overflow": "0",
      "last_close": {
        "converge_time_s": 3.002,
        "proposers": 41
      },
      "load_factor": 1,
      "network_id": 0,
      "peer_disconnects": "0",
      "peer_disconnects_resources": "0",
      "peers": 216,
      "pubkey_node": "n9MSTfmkKPcSmMFJFasaLAoc3SzMnHNqJQrDBkfrGMn9WUXQ8TTU",
      "server_state": "full",
      "server_state_duration_us": "1234567890",
      "state_accounting": {},
      "time": "2023-Oct-15 12:05:01.123456 UTC",
      "uptime": 86400,
      "validated_ledger": {
        "base_fee_xrp": 0.00001,
        "hash": "4BC50C9B0D8515D3EAAE1E74B29A95804346C491EE1A95BF25E4AAB854A6A652",
        "reserve_base_xrp": 10,
        "reserve_inc_xrp": 2,
        "seq": 89012345
      },
      "validation_quorum": 33
    }
  },
  "status": "success",
  "type": "response",
  "id": 1
}