[tor-commits] [torspec/master] Add version 3 HSFETCH to control-spec.txt

[nickm at torproject.org]

commit 34518e19b796281deeaf0aeb65c42f91df967e9f
Author: Neel Chauhan <neel at neelc.org>
Date:   Mon Jan 14 14:20:21 2019 -0500

    Add version 3 HSFETCH to control-spec.txt
---
 control-spec.txt | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/control-spec.txt b/control-spec.txt
index 6b63679..dce1c0e 100644
--- a/control-spec.txt
+++ b/control-spec.txt
@@ -1537,14 +1537,18 @@
     "HSFETCH" SP (HSAddress / "v" Version "-" DescId)
               *[SP "SERVER=" Server] CRLF
 
-    HSAddress = 16*Base32Character
-    Version = "2"
+    HSAddress = 16*Base32Character / 56*Base32Character
+    Version = "2" / "3"
     DescId = 32*Base32Character
     Server = LongName
 
   This command launches hidden service descriptor fetch(es) for the given
   HSAddress or DescId.
 
+  HSAddress can be version 2 or version 3 addresses. DescIDs can only be
+  version 2 IDs. Version 2 addresses consist of 16*Base32Character and
+  version 3 addresses consist of 56*Base32Character.
+
   If a DescId is specified, at least one Server MUST also be provided,
   otherwise a 512 error is returned. If no DescId and Server(s) are specified,
   it behaves like a normal Tor client descriptor fetch. If one or more
@@ -1570,7 +1574,11 @@
      C: HSFETCH ajkhdsfuygaesfaa
      S: 250 OK
 
+     C: HSFETCH vww6ybal4bd7szmgncyruucpgfkqahzddi37ktceo3ah7ngmcopnpyyd
+     S: 250 OK
+
   [HSFETCH was added in Tor 0.2.7.1-alpha]
+  [HS v3 support added 0.4.1.1-alpha]
 
 3.27. ADD_ONION