museair
| Crates.io | museair |
| lib.rs | museair |
| version | 0.3.0-rc6 |
| source | src |
| created_at | 2024-08-14 16:58:54.181707 |
| updated_at | 2024-11-20 07:40:52.437131 |
| description | Blazingly™ fast portable hash function designed by K--Aethiax. |
| homepage | |
| repository | https://github.com/eternal-io/museair |
| max_upload_size | |
| id | 1337754 |
| size | 177,744 |
K--Aethiax (eternal-io)
documentation
README
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).