Snow
An implementation of Trevor Perrin's Noise Protocol that is designed to be Hard To Fuck Up™.
🔥 This library is in the state of preview - do everyone a favor and only use this for fun or criticizing the author's code for now.
What's it look like?
See examples/simple.rs
for a more complete TCP client/server example.
let mut noise = new
.build_initiator
.unwrap;
let mut buf = ;
// write first handshake message
noise.write_message.unwrap;
// receive response message
let incoming = receive_message_from_the_mysterious_ether;
noise.read_message.unwrap;
// complete handshake, and transition the state machine into transport mode
let mut noise = noise.into_transport_mode;
See the full documentation at https://docs.rs/snow.
Implemented
Snow is currently feature-frozen on its current rev32 implementation, since revision 33 will be releasing shortly.
- Rekey()
-
pskN
modifier - specifying PSKs after building
Session
-
fallback
modifier
Crypto
Cryptographic providers are swappable through NoiseBuilder::with_provider()
, but by default it chooses select, artisanal
pure-Rust implementations (see Cargo.toml
for a quick overview).
Acceleration
If you enable the ring-accelerated
feature, Snow will default to choosing ring
's much faster crypto implementations when supported.
If you enable the ring-resolver
feature, Snow will include a ring_wrapper module as well as a RingAcceleratedResolver
available to be used with NoiseBuilder::with_resolver()
.