aboutsummaryrefslogtreecommitdiffstats
path: root/docs/guides/federation/running-a-node.md
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-18 11:47:42 +0000
committertv <tv@krebsco.de>2026-11-18 12:58:42 +0100
commitaa77c10a8a20356c277e511e9c6e33c98c9b4104 (patch)
tree78db95e6a178d78746ef7be42166c3591c4a0e15 /docs/guides/federation/running-a-node.md
parent257ad0391ff8eba437108e1885c45314e9fd5833 (diff)
guides: a party writes its node list without a vote
Where a reader adding a node looks (getting started, proposing a version, who syncs), the guides say that a party writes its node list itself, signed with a key its version names, and link to how; a version names a list anew only where its party can't.
Diffstat (limited to 'docs/guides/federation/running-a-node.md')
-rw-r--r--docs/guides/federation/running-a-node.md8
1 files changed, 7 insertions, 1 deletions
diff --git a/docs/guides/federation/running-a-node.md b/docs/guides/federation/running-a-node.md
index af16594..371bd10 100644
--- a/docs/guides/federation/running-a-node.md
+++ b/docs/guides/federation/running-a-node.md
@@ -15,7 +15,8 @@ what its API lets in, and joining.
Joining with an empty document, the node takes as its root that store's genesis change
only.
* `--store-party NAME`, which both need: the party the node is of, named in its entry
- and its handshakes. It is a member once that party's node list names it.
+ and its handshakes. It is a member once that party's node list names it
+ ([Who syncs](#who-syncs)).
* `--store-file PATH`: what is the node's own, written whenever it changes: the events
it refused by what it took before (of two versions changing one, the second it judged)
and those its operator had it drop. A node reads its store anew from its document
@@ -50,6 +51,11 @@ its log (`This node isn't a member of its store`); once it is listed, the others
with it (`This node is a member of its store`). A party that takes a node off its list
takes it out of the swarm.
+A party writes its node list itself, without a vote, signed with a key its version names
+(`continuum-party nodes`,
+[`common-changes.md`](common-changes.md#what-a-party-does-by-itself)): a node it adds
+is a member as soon as the list is taken.
+
Of a node's neighbours (`--neighbours`), some are kept among the members of its own
party and of the parties in `--store-neighbour-parties`, by the graph among those
alone, so that a party listing many nodes can't be all of a node's neighbours.