aboutsummaryrefslogtreecommitdiff
path: root/proposals/284-hsv3-control-port.txt
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2017-12-05 19:45:29 -0500
committerNick Mathewson <nickm@torproject.org>2017-12-05 19:45:29 -0500
commitaac4775ffd25d454eb451596e8835998e926109d (patch)
tree097f7978116a6db741bea90c82a1ce4384008ee2 /proposals/284-hsv3-control-port.txt
parent48e41c559f5b5438838d15c4fd9a1b46c7296310 (diff)
parent7ad96f18a09021a1531ab67f640216537c85c099 (diff)
downloadtorspec-aac4775ffd25d454eb451596e8835998e926109d.tar.gz
torspec-aac4775ffd25d454eb451596e8835998e926109d.zip
Merge remote-tracking branch 'dgoulet/ticket20699_02'
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