#tor #tor-networking #async #download #tor-arti

tor-dirclient

Downloads specific Tor network directory objects over the Tor network

41 releases (27 breaking)

0.29.0 Apr 1, 2025
0.28.0 Mar 3, 2025
0.27.0 Feb 7, 2025
0.25.0 Dec 2, 2024
0.0.0 Jun 24, 2021

#1288 in Network programming

Download history 772/week @ 2024-12-22 840/week @ 2024-12-29 1551/week @ 2025-01-05 1722/week @ 2025-01-12 1228/week @ 2025-01-19 1382/week @ 2025-01-26 2201/week @ 2025-02-02 2165/week @ 2025-02-09 1287/week @ 2025-02-16 1246/week @ 2025-02-23 1593/week @ 2025-03-02 1422/week @ 2025-03-09 1180/week @ 2025-03-16 916/week @ 2025-03-23 1359/week @ 2025-03-30 834/week @ 2025-04-06

4,517 downloads per month
Used in 44 crates (4 directly)

MIT/Apache and maybe LGPL-3.0-only

3MB
49K SLoC

tor-dirclient

Implements a minimal directory client for Tor.

Overview

Tor makes its directory requests as HTTP/1.0 requests tunneled over Tor circuits. For most objects, Tor uses a one-hop tunnel. Tor also uses a few strange and ad-hoc HTTP headers to select particular functionality, such as asking for diffs, compression, or multiple documents.

This crate provides an API for downloading Tor directory resources over a Tor circuit.

This crate is part of Arti, a project to implement Tor in Rust.

Features

xz -- enable XZ compression. This can be expensive in RAM and CPU, but it saves a lot of bandwidth. (On by default.)

zstd -- enable ZSTD compression. (On by default.)

routerdesc -- Add support for downloading router descriptors.

License: MIT OR Apache-2.0

Dependencies

~27–39MB
~621K SLoC