summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGeorge Kadianakis <desnacked@riseup.net>2016-12-23 14:18:18 +0200
committerGeorge Kadianakis <desnacked@riseup.net>2016-12-23 14:18:18 +0200
commit0cc7ce31977c513a941d87c502db064c570bdc99 (patch)
tree02d1ff562a1d83364d0ab59bd87852e41d05eb53
parent13196900102ff5fb28aa4a5458a53a04971b0adf (diff)
Move shared-rand vote/consensus fields to the right place.bug21059_v2
This patch only moves text, it does not alter it.
-rw-r--r--dir-spec.txt136
1 files changed, 68 insertions, 68 deletions
diff --git a/dir-spec.txt b/dir-spec.txt
index c701842..6b38b5a 100644
--- a/dir-spec.txt
+++ b/dir-spec.txt
@@ -1696,74 +1696,6 @@
enough votes were counted for the consensus for an authoritative
opinion to have been formed about their status.
- "shared-rand-participate" NL
-
- [At most once for votes; does not occur in consensuses.]
-
- Denotes that the directory authority supports and can participate in the
- shared random protocol.
-
- "shared-rand-commit" SP Version SP AlgName SP Identity SP Commit [SP Reveal] NL
-
- [Any number for votes; does not occur in consensuses.]
-
- Version ::= An integer greater or equal to 0.
- AlgName ::= 1*(ALPHA / DIGIT / "_" / "-")
- Identity ::= 40 * HEXDIG
- Commit ::= Base64-encoded-data
- Reveal ::= Base64-encoded-data
-
- Denotes a directory authority commit for the shared randomness
- protocol, containing the commitment value and potentially also the
- reveal value. See sections [COMMITREVEAL] and [VALIDATEVALUES] of
- proposal 250 on how to generate and validate these values.
-
- Version is the current shared randomness protocol version. AlgName is
- the hash algorithm that is used (e.g. "sha3-256") and Identity is the
- authority's SHA1 v3 identity fingerprint. Commit is the encoded
- commitment value in base64. Reveal is optional and if it's set, it
- contains the reveal value in base64.
-
- If a vote contains multiple commits from the same authority, the
- receiver MUST only consider the first commit listed.
-
- "shared-rand-previous-value" SP NumReveals SP Value NL
-
- [At most once.]
-
- NumReveals ::= An integer greater or equal to 0.
- Value ::= Base64-encoded-data
-
- The shared random value that was generated during the second-to-last
- shared randomness protocol run. For example, if this document was
- created on the 5th of November, this field carries the shared random
- value generated during the protocol run of the 3rd of November.
-
- See section [SRCALC] of proposal 250 for instructions on how to compute
- this value, and see section [CONS] for why we include old shared random
- values in votes and consensus.
-
- Value is the actual shared random value encoded in base64. NumReveals
- is the number of commits used to generate this SRV.
-
- "shared-rand-current-value" SP NumReveals SP Value NL
-
- [At most once.]
-
- NumReveals ::= An integer greater or equal to 0.
- Value ::= Base64-encoded-data
-
- The shared random value that was generated during the latest shared
- randomness protocol run. For example, if this document was created on
- the 5th of November, this field carries the shared random value
- generated during the protocol run of the 4th of November
-
- See section [SRCALC] of proposal 250 for instructions on how to compute
- this value given the active commits.
-
- Value is the actual shared random value encoded in base64. NumReveals
- is the number of commits used to generate this SRV.
-
"recommended-relay-protocols" SP Entries NL
"required-relay-protocols" SP Entries NL
"recommended-client-protocols" SP Entries NL
@@ -1944,6 +1876,74 @@
server's administrator. Administrators should include at least an
email address and a PGP fingerprint.
+ "shared-rand-participate" NL
+
+ [At most once for votes; does not occur in consensuses.]
+
+ Denotes that the directory authority supports and can participate in the
+ shared random protocol.
+
+ "shared-rand-commit" SP Version SP AlgName SP Identity SP Commit [SP Reveal] NL
+
+ [Any number for votes; does not occur in consensuses.]
+
+ Version ::= An integer greater or equal to 0.
+ AlgName ::= 1*(ALPHA / DIGIT / "_" / "-")
+ Identity ::= 40 * HEXDIG
+ Commit ::= Base64-encoded-data
+ Reveal ::= Base64-encoded-data
+
+ Denotes a directory authority commit for the shared randomness
+ protocol, containing the commitment value and potentially also the
+ reveal value. See sections [COMMITREVEAL] and [VALIDATEVALUES] of
+ proposal 250 on how to generate and validate these values.
+
+ Version is the current shared randomness protocol version. AlgName is
+ the hash algorithm that is used (e.g. "sha3-256") and Identity is the
+ authority's SHA1 v3 identity fingerprint. Commit is the encoded
+ commitment value in base64. Reveal is optional and if it's set, it
+ contains the reveal value in base64.
+
+ If a vote contains multiple commits from the same authority, the
+ receiver MUST only consider the first commit listed.
+
+ "shared-rand-previous-value" SP NumReveals SP Value NL
+
+ [At most once.]
+
+ NumReveals ::= An integer greater or equal to 0.
+ Value ::= Base64-encoded-data
+
+ The shared random value that was generated during the second-to-last
+ shared randomness protocol run. For example, if this document was
+ created on the 5th of November, this field carries the shared random
+ value generated during the protocol run of the 3rd of November.
+
+ See section [SRCALC] of proposal 250 for instructions on how to compute
+ this value, and see section [CONS] for why we include old shared random
+ values in votes and consensus.
+
+ Value is the actual shared random value encoded in base64. NumReveals
+ is the number of commits used to generate this SRV.
+
+ "shared-rand-current-value" SP NumReveals SP Value NL
+
+ [At most once.]
+
+ NumReveals ::= An integer greater or equal to 0.
+ Value ::= Base64-encoded-data
+
+ The shared random value that was generated during the latest shared
+ randomness protocol run. For example, if this document was created on
+ the 5th of November, this field carries the shared random value
+ generated during the protocol run of the 4th of November
+
+ See section [SRCALC] of proposal 250 for instructions on how to compute
+ this value given the active commits.
+
+ Value is the actual shared random value encoded in base64. NumReveals
+ is the number of commits used to generate this SRV.
+
"legacy-dir-key" SP FINGERPRINT NL
[At most once]