[tor-bugs] #28664 [Core Tor/Tor]: Describe consensus digest calculation

[Tor Bug Tracker & Wiki]

#28664: Describe consensus digest calculation
---------------------------+------------------------------------
 Reporter:  atagar         |          Owner:  (none)
     Type:  defect         |         Status:  new
 Priority:  Medium         |      Milestone:  Tor: 0.4.0.x-final
Component:  Core Tor/Tor   |        Version:
 Severity:  Normal         |     Resolution:
 Keywords:  tor-spec, doc  |  Actual Points:
Parent ID:                 |         Points:
 Reviewer:                 |        Sponsor:
---------------------------+------------------------------------

Comment (by atagar):

 Thanks teor, sounds good! For me the operative bit I needed was the
 digested range. Section 3.1 tells us quite a bit but my eyes glazed over
 the 'final "Signature Item"' bit (and in re-reading that it seems to say
 the last signature, not the first). I'm delighted for us to make the fixes
 you mention but how do you feel about adjusting the
 [https://gitweb.torproject.org/torspec.git/tree/dir-spec.txt#n3309
 detached signature description] to something like the following?

 From:

 {{{
     "consensus-digest" SP Digest NL

         [At start, at most once.]

         The digest of the consensus being signed.
 }}}

 To:

 {{{
     "consensus-digest" SP Digest NL

         [At start, at most once.]

         The digest of the consensus being signed. This is the uppercase
         hex encoded sha1 digest of the next hour's consensus document
         from it beginning up through its first 'directory-signature '
         line (space included).

         For more information see Section 3.1.
 }}}

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/28664#comment:4>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online