40 releases (24 breaking)

0.28.0 Mar 3, 2025
0.26.0 Jan 7, 2025
0.25.0 Dec 2, 2024
0.24.0 Oct 31, 2024
0.0.0 Jun 24, 2021

#2086 in Network programming

Download history 2025/week @ 2024-12-04 2488/week @ 2024-12-11 1637/week @ 2024-12-18 703/week @ 2024-12-25 1196/week @ 2025-01-01 1472/week @ 2025-01-08 1816/week @ 2025-01-15 1337/week @ 2025-01-22 1031/week @ 2025-01-29 3194/week @ 2025-02-05 1484/week @ 2025-02-12 1138/week @ 2025-02-19 1521/week @ 2025-02-26 1286/week @ 2025-03-05 1642/week @ 2025-03-12 994/week @ 2025-03-19

5,659 downloads per month
Used in 47 crates (11 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

~22–33MB
~521K SLoC