aboutsummaryrefslogtreecommitdiff
path: root/proposals/284-hsv3-control-port.txt
diff options
context:
space:
mode:
authorDavid Goulet <dgoulet@torproject.org>2017-11-15 13:29:33 -0500
committerDavid Goulet <dgoulet@torproject.org>2017-11-15 14:42:44 -0500
commit7ad96f18a09021a1531ab67f640216537c85c099 (patch)
tree766c920651d8e679e9e3764b5ae00bfb95f0febf /proposals/284-hsv3-control-port.txt
parent53b7dee30b1044ae401338a9ce4b6c76e1c431e1 (diff)
downloadtorspec-7ad96f18a09021a1531ab67f640216537c85c099.tar.gz
torspec-7ad96f18a09021a1531ab67f640216537c85c099.zip
prop284: Extend HSPOST to accept an onion address
Signed-off-by: David Goulet <dgoulet@torproject.org>
Diffstat (limited to 'proposals/284-hsv3-control-port.txt')
-rw-r--r--proposals/284-hsv3-control-port.txt19
1 files changed, 18 insertions, 1 deletions
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