noise-rust's Introduction

Noise-Rust

Implementation of the Noise Protocol Framework in Rust.

Status

Revision 34 is implemented.

Test vectors from cacophony and snow are successfully verified.

Philosophy

Simple: straightforward implementation, small amount of code, almost no dependencies, supports no_std. Feature use_alloc can optionallly be used as an alternative to std.
Fast: static dispatch, no heap allocation necessary.
Unopinionated: flexible, primitive API, does not dictate how it should be used.

Documentation

Crates

This repository contains several crates. The noise-protocol crate contains the abstract implementation of the protocol framework. noise-rust-crypto provides concrete implementations of the needed crypto primitives. It is a wrapper for x25519-dalek and RustCrypto crates.

The following table shows what primitives each of these crates supports:

	X25519	AES-256-GCM	Chacha20-Poly1305	SHA-256	SHA-512	BLAKE2s	BLAKE2b
rust-ring		✔	✔	✔	✔
rust-crypto	✔	✔	✔	✔	✔	✔	✔

You can also plug in other primitive implementations by implementing the DH, Cipher and Hash traits.

`no_std` usage

The noise-protocol crate supports no_std, if default features are disabled.

License

Unlicense.

noise-rust's People

Contributors

Stargazers

Watchers

noise-rust's Issues

Maximum message size

The protocol hard-codes a fixed noise message size of up to 65535 bytes. However, I could not find any code which enforces that in this library.

RUSTSEC-2023-0037: crate has been renamed to crypto_secretbox

xsalsa20poly1305 has been renamed / forked to crypto_secretbox and is now unmaintained. See https://rustsec.org/advisories/RUSTSEC-2023-0037.html

Bump dependencies and make release

The last release for the noise-rust crate is two years old. It still requires some older version of some dependencies, which creates conflicts. Please update all dependencies, and then make a new release. Thank you.