aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/api.md9
1 files changed, 5 insertions, 4 deletions
diff --git a/docs/api.md b/docs/api.md
index 0d96dde..302df5d 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -283,10 +283,11 @@ the signatures entirely. A swarm whose policy requires signatures
`none` too: every change must arrive vouched for.
Signatures travel with the changes, in the sync messages that carry them, along the
-same paths: a node passes on, for each node's writes, the latest signature it checked,
-and checks one it receives once it holds the change (a signature costs about 30 µs to
-check, and one vouches for its node's changes before it). A message carrying no
-changes carries no signatures. A node that stopped with changes it never sent, nor
+same paths: a message carries the signatures of the changes it carries, whatever the
+peer was sent before, so changes sent again (a message lost on the way) arrive
+vouched for as the first time; and a node checks one it receives once it holds the
+change (a signature costs about 30 µs to check, and one vouches for its node's changes
+before it). A message carrying no changes carries no signatures. A node that stopped with changes it never sent, nor
signed, signs them as it starts, before anything leaves.
The signatures a node has are kept in its document file (`--document-file`) with the
document.