From 7d91c37ec1c606f70ec7a90ce9be4b0aa5c518c4 Mon Sep 17 00:00:00 2001 From: tv Date: Thu, 19 Nov 2026 13:50:25 +0000 Subject: peers: what each peer said it speaks and knows, in GET /peers GET /peers shows, of each peer, what it said with its handshakes (SPEAKS): its `knows`, the wire versions it speaks, the oldest and the newest, and the newest revision of the federation it knows; null where it said nothing, a build from before SPEAKS or no handshake from it since the node started. `localKnows` is the node's own. So every swarm, federated or not, shows which builds its nodes run, as far as each heard. `swarm::speaking::shown` shapes it, for GET /events/counts too, whose `knows` is the same; docs/openapi.yaml has it once, as `Knows`. Without the federation feature, a revision reads as one this continuum doesn't know. `Speaking::of` is now used in every build, not only federated ones, which warned of it as dead code. --- src/api/peers.rs | 14 ++++++++++++++ 1 file changed, 14 insertions(+) (limited to 'src/api/peers.rs') diff --git a/src/api/peers.rs b/src/api/peers.rs index 2bdde96..1f7af21 100644 --- a/src/api/peers.rs +++ b/src/api/peers.rs @@ -17,6 +17,7 @@ use crate::document::store; use crate::locks::MutexExt; use crate::state::{AppState, HelloState, Incidents, Liveness}; use crate::swarm::peer::forgotten_path; +use crate::swarm::speaking; use crate::transport::Destination; use crate::transport::paths::ClockOffset; use crate::transport::traffic::PeerTraffic; @@ -67,6 +68,11 @@ pub(crate) struct PeerStatus { /// absent before it said so in this session. Keys of members not in our member /// list are left out. pub(crate) reaches: Option>, + /// What it said it speaks and knows with its handshakes (SPEAKS, + /// `swarm::speaking::shown`): the wire versions, the newest revision of the + /// federation. Null where it said nothing: a build from before SPEAKS, or no + /// handshake from it since we started. + pub(crate) knows: serde_json::Value, /// Messages and payload bytes exchanged with it, by kind, since we started (or /// since it was last listed). pub(crate) traffic: PeerTraffic, @@ -139,6 +145,8 @@ pub(crate) struct PeerListResponse { pub(crate) local_addresses: Vec, /// The members we reach (`swarm::reach`), as we last told our neighbours. pub(crate) local_reaches: Vec, + /// What we tell peers we speak and know, as `PeerStatus::knows`. + pub(crate) local_knows: serde_json::Value, /// By node ID. pub(crate) peers: BTreeMap, } @@ -228,6 +236,10 @@ pub(crate) async fn peer_list(state: &AppState) -> PeerListResponse { .effective(&peer, now, state.timing.rtt_fresh_for()) .map(|rtt| rtt.as_millis() as u64 / 2), }); + let knows = state + .speaking + .of(&peer) + .map_or(serde_json::Value::Null, speaking::shown); peers.insert( peer, PeerStatus { @@ -254,6 +266,7 @@ pub(crate) async fn peer_list(state: &AppState) -> PeerListResponse { heads: ps.reported_heads, neighbour, reaches: crate::swarm::reach::of(ps.reaches.as_ref()).map(&named), + knows, traffic, incidents: ps.incidents, sync_throughput, @@ -269,6 +282,7 @@ pub(crate) async fn peer_list(state: &AppState) -> PeerListResponse { local_addresses: state.transport.local_addresses(), local_epoch: local_epoch.into(), local_reaches: named(crate::swarm::reach::published(&state)), + local_knows: speaking::shown(speaking::own()), local_heads, peers, } -- cgit v1.3.1