[tor-commits] [torspec/master] prop284: Extend HSPOST to accept an onion address

[nickm at torproject.org]

commit 7ad96f18a09021a1531ab67f640216537c85c099
Author: David Goulet <dgoulet at torproject.org>
Date:   Wed Nov 15 13:29:33 2017 -0500

    prop284: Extend HSPOST to accept an onion address
    
    Signed-off-by: David Goulet <dgoulet at torproject.org>
---
 proposals/284-hsv3-control-port.txt | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/proposals/284-hsv3-control-port.txt b/proposals/284-hsv3-control-port.txt
index e8788e0..85167d7 100644
--- a/proposals/284-hsv3-control-port.txt
+++ b/proposals/284-hsv3-control-port.txt
@@ -73,7 +73,24 @@ Status: Open
 
 3.1.5. HSPOST
 
-   No change. This command can support v3 hidden service without changes.
+   To support version 3, the command needs an extra parameter that is the
+   onion address of the given descriptor. With v2, the address could have been
+   deduced from the given descriptor but with v3, this is not possible.  In
+   order to fire up the HS_DESC event correctly, we need the address so the
+   request can be linked on the control port.
+
+   Furthermore, the given descriptor will be validated with the given address
+   and an error will be returned if they are not matching.
+
+   The syntax becomes:
+
+     "+HSPOST" *[SP "SERVER=" Server] [SP "HSADDRESS=" HSAddress]
+               CRLF Descriptor CRLF "." CRLF
+
+     HSAddress = 56*Base32Character
+
+   The "HSAddress" key is optional and only applies for v3 descriptors. A 513
+   error is returned if used with v2.
 
 3.1.3. ADD_ONION