diff options
Diffstat (limited to 'spec/rend-spec/hsdesc-encrypt.md')
-rw-r--r-- | spec/rend-spec/hsdesc-encrypt.md | 31 |
1 files changed, 30 insertions, 1 deletions
diff --git a/spec/rend-spec/hsdesc-encrypt.md b/spec/rend-spec/hsdesc-encrypt.md index 06713a2..09aacbd 100644 --- a/spec/rend-spec/hsdesc-encrypt.md +++ b/spec/rend-spec/hsdesc-encrypt.md @@ -239,13 +239,42 @@ list of intro points etc. The plaintext has the following format: "single-onion-service" - [None or at most once] + [At most once] If present, this line indicates that the service is a Single Onion Service (see prop260 for more details about that type of service). This field has been introduced in 0.3.0 meaning 0.2.9 service don't include this. + "pow-params" SP type SP seed-b64 SP suggested-effort + SP expiration-time NL + + [At most once per "type"] + + If present, this line provides parameters for an optional proof-of-work + client puzzle. A client that supports an offered scheme can include a + corresponding solution in its introduction request to improve priority + in the service's processing queue. + + Only version 1 is currently defined. + Other versions may have a different format. + Introduced in tor-0.4.8.1-alpha. + + type: The type of PoW system used. We call the one specified here "v1". + + seed-b64: A random seed that should be used as the input to the PoW + hash function. Should be 32 random bytes encoded in base64 + without trailing padding. + + suggested-effort: An unsigned integer specifying an effort value that + clients should aim for when contacting the service. Can be + zero to mean that PoW is available but not currently + suggested for a first connection attempt. + + expiration-time: A timestamp in "YYYY-MM-DDTHH:MM:SS" format (iso time + with no space) after which the above seed expires and + is no longer valid as the input for PoW. + Followed by zero or more introduction points as follows (see section [NUM_INTRO_POINT] below for accepted values): |