21 unstable releases (8 breaking)
|0.8.3||Sep 5, 2023|
|0.8.1||Jun 30, 2023|
|0.6.3||Mar 31, 2023|
|0.6.0||Nov 30, 2022|
|0.0.0||Jun 24, 2021|
#1995 in Network programming
1,032 downloads per month
Used in 24 crates (12 directly)
Descriptions of Tor relays, as used to connect to them.
tor-linkspec crate provides traits and data structures that
describe how to connect to Tor relays.
When describing the location of a Tor relay on the network, the
Tor protocol uses a set of "link specifiers", each of which
corresponds to a single aspect of the relay's location or
identity—such as its IP address and port, its Ed25519 identity
key, its (legacy) RSA identity fingerprint, or so on. This
LinkSpec type encodes these structures.
When a client is building a circuit through the Tor network, it
needs to know certain information about the relays in that
circuit. This crate's
represent objects that describe a relay on the network that a
client can use as the first hop, or as any hop, in a circuit.
This crate is part of Arti, a project to implement Tor in Rust. Several other crates in Arti depend on it. You will probably not need this crate yourself unless you are interacting with the Tor protocol at a fairly low level.
tor-linkspec is a separate crate so that it can be used by other
crates that expose link specifiers and by crates that consume
TODO: Possibly we should rename this crate. "Linkspec" is a pretty esoteric term in the Tor protocols.
TODO: Possibly the link specifiers and the
*Target traits belong in different crates.
pt-client-- Build with enhanced data types to support pluggable transports.
full-- Build with all the features above.
Experimental and unstable features
Note that the APIs enabled by these features are NOT covered by semantic versioning[^1] guarantees: we might break them or remove them between patch versions.
experimental-- Build with all experimental features above. (Currently, there are no experimental features in this crate, but there may be in the future.)
[^1]: Remember, semantic versioning is what makes various
features work reliably. To be explicit: if you want
to only make safe changes, then you cannot enable these
License: MIT OR Apache-2.0