aboutsummaryrefslogtreecommitdiffstats
path: root/docs/guides
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-19 18:57:54 +0000
committertv <tv@krebsco.de>2026-11-19 20:13:11 +0100
commit2a8575ce6562e1579f9c9bd9c9964e3ef36d08f1 (patch)
tree39347d78deb93b431258109b8d943cc10c29c723 /docs/guides
parentb710146b9e17d844a1e2647a2b43eeadd62893aa (diff)
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.
Diffstat (limited to 'docs/guides')
-rw-r--r--docs/guides/federation/watching.md4
-rw-r--r--docs/guides/federation/writing-and-reading.md8
2 files changed, 12 insertions, 0 deletions
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;