mirror of
https://github.com/logos-co/logos-messaging-module.git
synced 2026-08-27 18:51:09 +00:00
66 lines
1.9 KiB
Markdown
66 lines
1.9 KiB
Markdown
# Query a running node
|
|
|
|
A delivery node exposes no HTTP/REST API. All node info — identity, version,
|
|
and Prometheus metrics — is read through the `logoscore` CLI talking to the
|
|
daemon. Assumes a node started per [`run-node.md`](./run-node.md).
|
|
|
|
Run the commands inside the container (`docker exec logos-node ...`) or
|
|
directly if you have `logoscore` on the host.
|
|
|
|
## List available info
|
|
|
|
```bash
|
|
logoscore call delivery_module getAvailableNodeInfoIDs --json | jq
|
|
```
|
|
|
|
```json
|
|
{
|
|
"method": "getAvailableNodeInfoIDs",
|
|
"module": "delivery_module",
|
|
"result": {
|
|
"error": null,
|
|
"success": true,
|
|
"value": "@[Version, Metrics, MyMultiaddresses, MyENR, MyPeerId]"
|
|
},
|
|
"status": "ok"
|
|
}
|
|
```
|
|
|
|
## Read a specific value
|
|
|
|
```bash
|
|
logoscore call delivery_module getNodeInfo MyENR --json | jq
|
|
```
|
|
|
|
```json
|
|
{
|
|
"method": "getNodeInfo",
|
|
"module": "delivery_module",
|
|
"result": {
|
|
"error": null,
|
|
"success": true,
|
|
"value": "enr:-LW4QItc5tHj3rWoFaaQIUWvaBYijDf2TJKW83SNdyylJVAYVoUlBl1h5..."
|
|
},
|
|
"status": "ok"
|
|
}
|
|
```
|
|
|
|
The value lives at `.result.value`. Extract it with `jq -r`:
|
|
|
|
```bash
|
|
logoscore call delivery_module getNodeInfo MyPeerId --json | jq -r '.result.value'
|
|
```
|
|
|
|
## Info IDs
|
|
|
|
| ID | Command | Returns |
|
|
| ------------------ | ------------------------------ | ----------------------------- |
|
|
| `MyPeerId` | `getNodeInfo MyPeerId` | libp2p peer ID |
|
|
| `MyENR` | `getNodeInfo MyENR` | discv5 ENR URI |
|
|
| `MyMultiaddresses` | `getNodeInfo MyMultiaddresses` | Listen multiaddresses |
|
|
| `Metrics` | `getNodeInfo Metrics` | Prometheus text exposition |
|
|
| `Version` | `getNodeInfo Version` | `liblogosdelivery` version |
|
|
|
|
The `logoscore` binary version is in `logoscore status --json` →
|
|
`.daemon.version`.
|