An implementation of the Noise Protocol by Trevor Perrin that is designed to be Hard To Fuck Up™.
See the documentation at https://docs.rs/snow.
🔥 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.
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).
See examples/simple.rs
for a more complete TCP client/server example.
```rust let noise = NoiseBuilder::new("NoiseNNChaChaPolyBLAKE2s".parse().unwrap()) .buildinitiator() .unwrap();
let mut buf = [0u8; 65535];
// write first handshake message noise.write_message(&[0u8; 0], &mut buf).unwrap();
// receive response message let incoming = receivemessagefromthemysteriousether(); noise.readmessage(&incoming, &mut buf).unwrap();
// complete handshake, and transition the state machine into transport mode let noise = noise.intotransportmode(); ```
Work in progress. Unreviewed. Unaudited. All APIs are unstable. Don't use for security critical purposes. Side effects may include nausea, heart palpatations, yolocryptosis, and permanent sexual dysfunction.