diff options
| author | tv <tv@krebsco.de> | 2026-11-19 21:19:38 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-19 22:30:20 +0100 |
| commit | 5e93c28c963224ce89901b813c06598bcc84f8c7 (patch) | |
| tree | ef082939fbbb37f6e5c7910c36851ffe564a5735 /docs | |
| parent | edb4443510d7c8e4957e953093a25f9e7876493e (diff) | |
events/counts: when this node last heard from each listed node
Each party in GET /events/counts gives `heard` now: by node ID, how many
seconds ago this node last heard from each node the party lists (its
peer state's last_seen), 0 for itself, left out where it never heard
from it since it started. A party's client reads from it whether nodes
are cut off, where a vote may be held back, and a party's session, which
reads no /peers, has it.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/openapi.yaml | 10 |
1 files changed, 8 insertions, 2 deletions
diff --git a/docs/openapi.yaml b/docs/openapi.yaml index af17d69..8dfbc88 100644 --- a/docs/openapi.yaml +++ b/docs/openapi.yaml @@ -1587,7 +1587,9 @@ paths: What counts, as the store reads now (docs/federation.md): the current version (its number, its hash, its revision, by number and ID and as people read it, and the version itself), each party's keys and nodes, the names those nodes gave - themselves (`names`, by node ID, `--alias`, of those that did), what each said + themselves (`names`, by node ID, `--alias`, of those that did), how many seconds + ago this node last heard from each (`heard`, by node ID; 0 for itself; left out + for one it never heard from since it started), what each said it speaks and knows (`knows`, by node ID: the wire versions it speaks, the oldest and the newest, and the newest revision of the federation it knows, by number and ID and as people read it, its number null where this node doesn't know it; @@ -1623,7 +1625,7 @@ paths: type: object additionalProperties: type: object - required: [keys, nodes, names, knows] + required: [keys, nodes, names, heard, knows] properties: keys: type: array @@ -1637,6 +1639,10 @@ paths: type: object additionalProperties: type: string + heard: + type: object + additionalProperties: + type: integer knows: type: object additionalProperties: |
