diff options
Diffstat (limited to 'spec/srv-spec/overview.md')
-rw-r--r-- | spec/srv-spec/overview.md | 10 |
1 files changed, 8 insertions, 2 deletions
diff --git a/spec/srv-spec/overview.md b/spec/srv-spec/overview.md index 728aad2..6da4599 100644 --- a/spec/srv-spec/overview.md +++ b/spec/srv-spec/overview.md @@ -1,4 +1,5 @@ <a id="srv-spec.txt-2"></a> + # Overview This proposal alters the Tor consensus protocol such that a random number is @@ -10,6 +11,7 @@ The proposal also specifies how the final shared random value is embedded in consensus documents so that clients who need it can get it. <a id="srv-spec.txt-2.1"></a> + ## Introduction to our commit-and-reveal protocol Every day, before voting for the consensus at 00:00UTC each authority @@ -23,6 +25,7 @@ commitment value you should not be able to derive the underlying reveal value. The construction of these values is specified in section [COMMITREVEAL]. <a id="srv-spec.txt-2.1"></a> + ## Ten thousand feet view of the protocol Our commit-and-reveal protocol aims to produce a fresh shared random value @@ -58,6 +61,7 @@ Commit phase: ``` <a id="srv-spec.txt-2.3"></a> + ## How we use the consensus [CONS] The produced shared random values need to be readily available to @@ -81,6 +85,7 @@ For this, a new SR consensus method will be needed to indicate which authorities support this new protocol. <a id="srv-spec.txt-2.3.1"></a> + ### Inserting Shared Random Values in the consensus After voting happens, we need to be careful on how we pick which shared @@ -118,6 +123,7 @@ this because changing SRVs in the middle of the day has terrible reachability consequences for hidden service clients. <a id="srv-spec.txt-2.4"></a> + ## Persistent State of the Protocol [STATE] A directory authority needs to keep a persistent state on disk of the on @@ -133,11 +139,12 @@ previous time period must also be present in the state at all times if they are available. <a id="srv-spec.txt-2.5"></a> + ## Protocol Illustration An illustration for better understanding the protocol can be found here: -https://people.torproject.org/~asn/hs_notes/shared_rand.jpg +<https://people.torproject.org/~asn/hs_notes/shared_rand.jpg> It reads left-to-right. @@ -155,4 +162,3 @@ example, the SRV was computed with 3 authority contributions and its value is "a56fg39h". We advice you to revisit this after you have read the whole document. - |