aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMicah Elizabeth Scott <beth@torproject.org>2023-11-07 18:59:58 -0800
committerMicah Elizabeth Scott <beth@torproject.org>2023-11-09 14:16:27 -0800
commitdbf045b6d38fa99f19041c926a988a7bc08f59e6 (patch)
treef152da6b64f2afbc49b6388aca6b8ea91d82ff90
parent93fed8bb455d1d09a4cf0fb6c79e3ed67c302f6e (diff)
downloadtorspec-dbf045b6d38fa99f19041c926a988a7bc08f59e6.tar.gz
torspec-dbf045b6d38fa99f19041c926a988a7bc08f59e6.zip
Index text and links for the new hspow-spec
-rw-r--r--spec/SUMMARY.md1
-rw-r--r--spec/dos-spec/overview.md2
-rw-r--r--spec/hspow-spec/index.md12
3 files changed, 8 insertions, 7 deletions
diff --git a/spec/SUMMARY.md b/spec/SUMMARY.md
index 9cd0933..562a371 100644
--- a/spec/SUMMARY.md
+++ b/spec/SUMMARY.md
@@ -128,6 +128,7 @@
- [Appendix G: Managing authorized client data \[CLIENT-AUTH-MGMT\]](./rend-spec/client-authorization.md)
- [Appendix F: Two methods for managing revision counters.](./rend-spec/revision-counter-mgt.md)
- [Appendix G: Text vectors](./rend-spec/text-vectors.md)
+- [`Proof of Work for onion service introduction`](./hspow-spec/index.md)
# Anticensorship tools and protocols
diff --git a/spec/dos-spec/overview.md b/spec/dos-spec/overview.md
index d715b51..e159014 100644
--- a/spec/dos-spec/overview.md
+++ b/spec/dos-spec/overview.md
@@ -73,6 +73,6 @@ Based on the queue behavior, servers will continuously provide an updated effort
Queue backlogs cause the effort to rise, and an idle server will cause the effort to decay.
If the queue is never overfull the effort decays to zero, asking clients not to include a proof-of-work solution at all.
-We may support multiple cryptographic algorithms for this puzzle in the future, but currently we support one type. It's called `v1` in our protocol, and it's based on the Equi-X algorithm developed for this purpose. See `327-pow-over-intro.txt` for more information.
+We may support multiple cryptographic algorithms for this puzzle in the future, but currently we support one type. It's called `v1` in our protocol, and it's based on the Equi-X algorithm developed for this purpose. See the document on [`Proof of Work for onion service introduction`](../hspow-spec/index.md).
This defense is configured by an operator using the `HiddenServicePoW` configuration options. Additionally, it requires both the client and the onion service to be compiled with the `pow` module (`--enable-gpl` mode) available. Current versions of the Tor Browser do include `pow` support.
diff --git a/spec/hspow-spec/index.md b/spec/hspow-spec/index.md
index d728781..aea9c46 100644
--- a/spec/hspow-spec/index.md
+++ b/spec/hspow-spec/index.md
@@ -1,10 +1,10 @@
-```
-Filename: 327-pow-over-intro.txt
-Title: A First Take at PoW Over Introduction Circuits
-Author: George Kadianakis, Mike Perry, David Goulet, tevador
-Created: 2 April 2020
-Status: Closed
+# Proof of Work for onion service introduction
+
+The overall denial-of-service prevention strategies in Tor are described in the [Denial-of-service prevention mechanisms in Tor](../dos-spec/index.md) document. This document describes one specific mitigation, the proof-of-work client puzzle for onion service introduction.
+
+This was originally [proposal 327, A First Take at PoW Over Introduction Circuits](../proposals/327-pow-over-intro.txt) authored by George Kadianakis, Mike Perry, David Goulet, and tevador.
+```text
0. Abstract
This proposal aims to thwart introduction flooding DoS attacks by introducing