aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorIan Jackson <ijackson@chiark.greenend.org.uk>2024-03-05 19:14:14 +0000
committerIan Jackson <ijackson@chiark.greenend.org.uk>2024-03-05 19:14:14 +0000
commit6b230e48fa1cf594f0e84be344d6ac03d7f774cd (patch)
tree784decaebc276b07f3877ad85fae78c7c46c047f
parentbb4c14168cae145f8a651bf50288ff64390d517e (diff)
downloadtorspec-6b230e48fa1cf594f0e84be344d6ac03d7f774cd.tar.gz
torspec-6b230e48fa1cf594f0e84be344d6ac03d7f774cd.zip
Completely ignore unknown hspow-params
-rw-r--r--spec/rend-spec/hsdesc-encrypt.md12
1 files changed, 7 insertions, 5 deletions
diff --git a/spec/rend-spec/hsdesc-encrypt.md b/spec/rend-spec/hsdesc-encrypt.md
index 531c70a..3d2117e 100644
--- a/spec/rend-spec/hsdesc-encrypt.md
+++ b/spec/rend-spec/hsdesc-encrypt.md
@@ -255,17 +255,19 @@ list of intro points etc. The plaintext has the following format:
"pow-params" SP scheme SP seed-b64 SP suggested-effort
SP expiration-time NL
- [At most once per "scheme"]
-
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 scheme `v1` is currently defined.
- Unknown schemes found in a descriptor should be ignored by clients.
- Other schemes may have a different format (in the parts of the
- Item after the "scheme"; this could even include an Object).
+ 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.
scheme: The PoW system used. We call the one specified here "v1".