History

Nick Mathewson cec6d0ce33 Run add_warnings on all files.		2023-08-04 07:45:04 -04:00
..
src	Run add_warnings on all files.	2023-08-04 07:45:04 -04:00
tests	tor-hspow: Shorten the solve_effort1k_aa_41_01 test	2023-08-01 19:31:23 -07:00
Cargo.toml	Run "fixup features" in preparation for a release.	2023-08-01 08:32:20 -04:00
README.md	Start implementing Proposal 327	2023-07-27 07:20:14 -07:00

README.md

tor-hspow

Tor supports optional proof-of-work client puzzles, for mitigating denial of service attacks on onion services. This crate implements the specific puzzle algorithms we use, and infrastructure for solving puzzles asynchronously.

Proposal 327 introduced our first algorithm variant, named v1. It is based on the Equi-X asymmetric puzzle and an adjustable effort check using a Blake2b hash of the proof. The underlying algorithm is provided by the [equix] crate.

EXPERIMENTAL DRAFT

Just here as a proof-of-concept and to test the algorithms. None of the API here is final, the current status is that lower layers are exposed unnecessarily and upper layers are unwritten.

For Tor client puzzle support in Arti. (#889)