aboutsummaryrefslogtreecommitdiff
path: root/spec/rend-spec/hsdesc-encrypt.md
diff options
context:
space:
mode:
Diffstat (limited to 'spec/rend-spec/hsdesc-encrypt.md')
-rw-r--r--spec/rend-spec/hsdesc-encrypt.md16
1 files changed, 10 insertions, 6 deletions
diff --git a/spec/rend-spec/hsdesc-encrypt.md b/spec/rend-spec/hsdesc-encrypt.md
index 3e91172..3d2117e 100644
--- a/spec/rend-spec/hsdesc-encrypt.md
+++ b/spec/rend-spec/hsdesc-encrypt.md
@@ -252,21 +252,25 @@ list of intro points etc. The plaintext has the following format:
```
```text
- "pow-params" SP type SP seed-b64 SP suggested-effort
+ "pow-params" SP scheme 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.
+ Only scheme `v1` is currently defined.
+ It may appear only once.
+
+ Unknown schemes found in a descriptor must be completely ignored:
+ future schemes might have a different format (in the parts of the
+ Item after the "scheme"; this could even include an Object); and
+ future schemes might allow repetition, and might appear in any order.
+
Introduced in tor-0.4.8.1-alpha.
- type: The type of PoW system used. We call the one specified here "v1".
+ scheme: The 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