36 releases (20 breaking)

0.24.0 Oct 31, 2024
0.22.0 Sep 3, 2024
0.20.0 Jun 27, 2024
0.12.1 Mar 4, 2024
0.0.0 Jun 24, 2021

#1887 in Network programming

Download history 1467/week @ 2024-07-29 1328/week @ 2024-08-05 843/week @ 2024-08-12 1462/week @ 2024-08-19 1464/week @ 2024-08-26 1727/week @ 2024-09-02 1305/week @ 2024-09-09 1211/week @ 2024-09-16 1706/week @ 2024-09-23 1547/week @ 2024-09-30 729/week @ 2024-10-07 877/week @ 2024-10-14 1312/week @ 2024-10-21 1407/week @ 2024-10-28 1847/week @ 2024-11-04 1345/week @ 2024-11-11

5,952 downloads per month
Used in 41 crates (12 directly)

MIT/Apache and maybe LGPL-3.0-only

2MB
23K SLoC

tor-netdir

Represents a clients'-eye view of the Tor network.

Overview

The tor-netdir crate wraps objects from tor-netdoc, and combines them to provide a unified view of the relays on the network. It is responsible for representing a client's knowledge of the network's state and who is on it.

This crate is part of Arti, a project to implement Tor in Rust. Its purpose is to expose an abstract view of a Tor network and the relays in it, so that higher-level crates don't need to know about the particular documents that describe the network and its properties.

There are two intended users for this crate. First, producers like tor-dirmgr create NetDir objects fill them with information from the Tor network directory. Later, consumers like tor-circmgr use NetDirs to select relays for random paths through the Tor network.

Limitations

Only modern consensus methods and microdescriptor consensuses are supported.

License: MIT OR Apache-2.0

Dependencies

~21–32MB
~484K SLoC