From 2a8575ce6562e1579f9c9bd9c9964e3ef36d08f1 Mon Sep 17 00:00:00 2001 From: tv Date: Thu, 19 Nov 2026 18:57:54 +0000 Subject: continuum-party: status and values `status` says at a glance where the party and its node stand, from the node's /events, /events/counts and /events/refused and the party's record where there is one: the store, its checkpoint and heads; the current version, its federation, revision and parties, and how many pass a change; the party's keys (by fingerprint) and nodes as they count, and whether the version names --key; the node's party, whether it votes by itself, and its stop; each proposal on the current version as `show` begins (ballot_line, shared with it); the versions the node refused of its own; and how many of the party's events a move refused, which `again` signs again. `values [PATH]` shows the values that count, all or under a place, each with who writes there by the current version's rules; --json as one object, by place. --- docs/guides/federation/watching.md | 4 ++++ docs/guides/federation/writing-and-reading.md | 8 ++++++++ 2 files changed, 12 insertions(+) (limited to 'docs/guides/federation') diff --git a/docs/guides/federation/watching.md b/docs/guides/federation/watching.md index 9db3399..d99d36c 100644 --- a/docs/guides/federation/watching.md +++ b/docs/guides/federation/watching.md @@ -7,6 +7,10 @@ store, through its API and its log. ## Through the API +`continuum-party status` says most of what follows at a glance: the store and its +version, the party's keys and nodes, the node's stop, the proposals on the current version, +the versions the node refused of its own, and what the party signs again after a move. + * **A version the node refused** (`own` in `GET /events/refused` not empty): keys voted twice, and nodes may be apart. Act on it at once ([`when-things-go-wrong.md`](when-things-go-wrong.md)). diff --git a/docs/guides/federation/writing-and-reading.md b/docs/guides/federation/writing-and-reading.md index d45bf0d..abd5221 100644 --- a/docs/guides/federation/writing-and-reading.md +++ b/docs/guides/federation/writing-and-reading.md @@ -94,6 +94,14 @@ Votes and proposals aren't signed again: their version is behind. ## Reading +The client shows the values that count, each with who writes there, all or under a +place (`--json` as one object, by place): + +```sh +continuum-party --node http://lass:secret@localhost:3000 values home/tv +# home/tv/motd "hello" (tv) +``` + `GET /events/counts` is what counts, as the node reads it now: * `version`: the current version, its `number`, its `hash`, and the version itself; -- cgit v1.3.1