Skip to content

Latest commit

 

History

History
62 lines (41 loc) · 2.4 KB

CRATES.IO-README.md

File metadata and controls

62 lines (41 loc) · 2.4 KB

This is the new fastest portable hash: immune to blinding multiplication, even faster then wyhash, SMHasher3 passed.

See repository for details.

Usage

let seed: u64 = 42;

let one_shot = museair::hash_128("MuseAir hash!".as_bytes(), seed);
let streamed = {
    let mut hasher = museair::Hasher::with_seed(seed);
    hasher.write("MuseAir".as_bytes());
    hasher.write(" hash!".as_bytes());
    hasher.finish_128()
};

assert_eq!(one_shot, streamed);

Benchmarks

Hash Digest length Throughput
MuseAir 64-bit 29.1 GiB/s (0.88)
MuseAir-128 128-bit 29.0 GiB/s (0.88)
MuseAir-BFast 64-bit 33.0 GiB/s (1.00)
MuseAir-BFast-128 128-bit 33.0 GiB/s (1.00)
WyHash 64-bit 29.0 GiB/s (0.88)
WyHash-condom 64-bit 24.3 GiB/s (0.74)
KomiHash 64-bit 27.7 GiB/s (0.84)

(These results are obtained by running cargo bench on AMD Ryzen 7 5700G 4.6GHz Desktop.)

Security

MuseAir is NOT intended for cryptographic security.

  • To resist HashDoS, your hash must comes with a private seed.
  • To ensure the protection of your data, it is recommended to use a well-established algorithm, such as SHA-3.

Versioning policy

The -Standard variant (functions listed in the crate root) is not scheduled to be stable until version 1.0.0 is released. That is, the result of the hash may change from minor version to minor version. Don't use it for persistent storage yet.

The -BFast variant will never be stable, you should only use this on local sessions. For persistent storage, you should always use the -Standard variant (after it is stable).