From 9d3350f996ddba2a8e4636dd3705d9bd1c7aa4fb Mon Sep 17 00:00:00 2001 From: tv Date: Thu, 19 Nov 2026 16:15:42 +0000 Subject: continuum-party: hashes named by their prefixes, the shortest marked MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The guides wrote `vote 8d02… yes`, and the client took a whole hash only. It takes a proposal's hash by a prefix of four digits or more that no other proposal on the current version starts with (`client::named`), and says which proposals a prefix names where it names several; a whole hash is itself, as before. Heads given to `fork` are named so too, among the heads the node shows. Four digits at least, so that a prefix read a moment ago doesn't come to name a proposal made since, as one or two soon would. Where it shows a proposal's hash (`proposals`, `propose`), the client marks the shortest prefix that names it, in bold, on a terminal unless NO_COLOR is set; elsewhere the hash is printed as it was. --- docs/guides/federation/proposing-and-voting.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) (limited to 'docs/guides') diff --git a/docs/guides/federation/proposing-and-voting.md b/docs/guides/federation/proposing-and-voting.md index e91806c..739552b 100644 --- a/docs/guides/federation/proposing-and-voting.md +++ b/docs/guides/federation/proposing-and-voting.md @@ -81,9 +81,15 @@ another proposal on it passed. ```sh continuum-party --node http://tv:secret@localhost:3000 --key tv.key --record tv.record \ - vote 8d02… yes + vote 8d02 yes ``` +A proposal is named by its hash, or by a prefix of it, four digits or more, that no other +proposal on the current version starts with: the client says which proposals a prefix +names where it names several. On a terminal, it marks the shortest such prefix in bold +wherever it shows a proposal's hash (`proposals`, `propose`). Heads given to `fork` are +named so too, among the heads the node shows. + The client votes by the party's record, never by what a node shows, and writes the record before it sends the vote. It casts no vote that would make its party vote twice: -- cgit v1.3.1