6 releases (3 breaking)
new 0.4.1 | Nov 20, 2024 |
---|---|
0.4.0 | Nov 20, 2024 |
0.3.0-alpha | Mar 30, 2023 |
0.2.0-alpha | Nov 25, 2022 |
0.1.1-alpha | Nov 24, 2022 |
#2247 in Network programming
250 downloads per month
46KB
287 lines
libp2p Tor
Tor based transport for libp2p. Connect through the Tor network to TCP listeners.
Build on top of Arti.
⚠️ Misuse warning ⚠️ - read carefully before using
Although the sound of "Tor" might convey a sense of security it is very easy to misuse this crate and leaking private information while using. Study libp2p carefully and try to make sure you fully understand it's current limits regarding privacy. I.e. using identify might already render this transport obsolete.
This transport explicitly doesn't provide any enhanced privacy if it's just used like a regular transport. Use with caution and at your own risk. Don't just blindly advertise Tor without fully understanding what you are dealing with.
Add to your dependencies
cargo add libp2p-community-tor
This crate uses tokio with rustls for its runtime and TLS implementation. No other combinations are supported.
Example
let address = "/dns/www.torproject.org/tcp/1000".parse()?;
let mut transport = libp2p_community_tor::TorTransport::bootstrapped().await?;
// we have achieved tor connection
let _conn = transport.dial(address)?.await?;
About
This crate originates in a PR to bring Tor support too rust-libp2p. Read more about it here: libp2p/rust-libp2p#2899
License: MIT
Dependencies
~64–100MB
~2M SLoC