#chacha20-poly1305 #chacha20 #poly1305 #libsodium #key-exchange #shared-key #nacl

no-std crypto_secretstream

Pure Rust implementation of libsodium's crypto_secretstream secret-key using ChaCha20 and Poly1305

4 releases (2 breaking)

0.2.0 Jul 22, 2023
0.1.1 Dec 1, 2022
0.1.0 Aug 14, 2022
0.0.1 Aug 30, 2021

#2747 in Cryptography

Download history 2311/week @ 2024-08-12 1692/week @ 2024-08-19 1498/week @ 2024-08-26 1794/week @ 2024-09-02 1759/week @ 2024-09-09 1879/week @ 2024-09-16 1736/week @ 2024-09-23 1533/week @ 2024-09-30 1737/week @ 2024-10-07 2042/week @ 2024-10-14 2844/week @ 2024-10-21 3327/week @ 2024-10-28 1558/week @ 2024-11-04 1322/week @ 2024-11-11 1998/week @ 2024-11-18 983/week @ 2024-11-25

5,880 downloads per month
Used in 4 crates (2 directly)

Apache-2.0 OR MIT

25KB
403 lines

RustCrypto: crypto_secretstream

crate Docs Apache2/MIT licensed Rust Version Project Chat Build Status

Pure Rust implementation of libsodium's crypto_secretstream primitive, providing an AEAD using ChaCha20 and Poly1305.

It is tested against sodiumoxide, a Rust libsodium bindings.

Documentation

About

Imagine Alice wants to open a safe channel of communication with Bob, one that can't be read or modified by anyone else.

One way she can do this is by first agreeing with Bob on a shared secret key (such as one generated via a key exchange protocol), then she opens a normal/unsafe channel of communication and sends her messages, encrypted under this shared key. Then, when Bob receives these messages, he can decrypt each one and the mere knowledge of this shared key ensures that it was indeed sent by Alice.

Under the hood, the first message is postfixed with a random number, called a nonce, generated by Alice, which is taken into account during encryption and decryption. It is then incremented for each new message.

It also allows for additional data to be sent with each message. This data is not encrypted but used in the encryption process thus it is needed to be known in advance by the receiver. It can be useful for adding another layer of security, and is not of a fixed size as the key is.

License

Licensed under either of:

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Caveats

  • auto-rekeying on counter overflow is not tested
  • Tag::Final doesn't actually do anything, as libsodium does but not sodiumoxide
  • Key and Nonce aren't zeroize, maybe it should
  • MAC check in PullStream is not constant time

Dependencies

~0.7–1.2MB
~23K SLoC