39 releases (23 breaking)

0.27.0 Feb 7, 2025
0.25.0 Dec 2, 2024
0.24.0 Oct 31, 2024
0.20.0 Jun 27, 2024
0.0.0 Jun 24, 2021

#1888 in Network programming

Download history 1805/week @ 2024-10-29 1428/week @ 2024-11-05 1692/week @ 2024-11-12 2111/week @ 2024-11-19 2070/week @ 2024-11-26 1964/week @ 2024-12-03 2620/week @ 2024-12-10 1860/week @ 2024-12-17 729/week @ 2024-12-24 902/week @ 2024-12-31 1615/week @ 2025-01-07 1811/week @ 2025-01-14 1369/week @ 2025-01-21 1096/week @ 2025-01-28 3153/week @ 2025-02-04 1486/week @ 2025-02-11

7,372 downloads per month
Used in 47 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–33MB
~499K SLoC