History

Nick Mathewson 37fe255fda Try refactoring build.rs for testability. I'm adding a local "Buildable" trait here so I can swap out Circuits for something else. This also lets me refactor Builder<> to be parameterized on TimeoutEstimator again, and lets us get rid of the first_hop() accessor on paths.		2021-07-19 12:25:26 -04:00
..
src	Try refactoring build.rs for testability.	2021-07-19 12:25:26 -04:00
Cargo.toml	Implement a circuit timeout estimator backend.	2021-07-19 12:25:26 -04:00
README.md	Add automatically generated README.md files to each crate.	2021-05-25 15:41:23 -04:00

README.md

tor-circmgr

tor-circmgr: circuits through the Tor network on demand.

Limitations

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

In Tor, a circuit is an encrypted multi-hop tunnel over multiple relays. This crate's purpose, long-term, is to manage a set of circuits for a client. It should construct circuits in response to a client's needs, and preemptively construct circuits so as to anticipate those needs. If a client request can be satisfied with an existing circuit, it should return that circuit instead of constructing a new one.

But for now, this tor-circmgr code is extremely preliminary; its data structures are all pretty bad, and it's likely that the API is wrong too.

The path generation code in this crate is missing a colossal number of features that you'd probably want in production: the paths it generates should not be considered secure.

License: MIT OR Apache-2.0