FastHashes 5.0.0

FastHashes

FastHashes is a suite of .NET non-cryptographic hash functions.

Main Features

• High Performing: optimized implementations make extensive use of method inlining and efficient memory access to maximize hashing throughput.
• Hardware Accelerated: selected algorithms leverage SIMD and hardware intrinsics (SSE2, AVX2, PCLMULQDQ) when available, with portable scalar fallbacks.
• Allocation Free: hashing computations avoid unnecessary intermediate allocations, minimizing garbage collection overhead.
• Endian-Agnostic: all hashes produce consistent results regardless of the machine's byte order.
• Platform-Agnostic: the library targets .NET Standard and modern .NET, with support for both x86 and x64 architectures.
• Fully Managed: since version 3.0.0, the library no longer requires unsafe memory access.

Hashes

The library includes the following non-cryptographic hashes:

• A5Hash
  • 32/64/128 Bits Output
  • Reference Implementation: https://github.com/avaneev/a5hash
• ChibiHash
  • 64 Bits Output
  • V2 Version
  • Reference Implementation: https://github.com/N-R-K/ChibiHash
• FarmHash
  • 32/64/128 Bits Output
  • Fingerprint Versions
  • Reference Implementation: https://github.com/google/farmhash
• FastHash
  • 32/64 Bits Output
  • Reference Implementation: https://github.com/ztanml/fast-hash
• FastPositiveHash (T1HA)
  • 64/128 Bits Output
  • 0/1/2 Variants
  • Reference Implementation: https://github.com/erthink/t1ha
• HalfSipHash
  • 32/64 Bits Output
  • Reference Implementation: https://github.com/veorq/SipHash
• HalftimeHash
  • 64 Bits Output
  • 64/128/256/512 Bits Processing Styles
  • Reference Implementation: https://github.com/jbapple/HalftimeHash
• HighwayHash
  • 64/128/256 Bits Output
  • Reference Implementation: https://github.com/google/highwayhash
• KomiHash
  • 64 Bits Output
  • Version 5.34
  • Reference Implementation: https://github.com/avaneev/komihash
• LaneHash
  • 64/128 Bits Output
  • Reference Implementation: https://github.com/ccipherx/lanehash
• MetroHash
  • 64/128 Bits Output
  • 1/2 Variants
  • Reference Implementation: https://github.com/jandrewrogers/MetroHash
• MirHash
  • 64 Bits Output
  • Strict Version
  • Reference Implementation: https://github.com/vnmakarov/mir
• MumHash
  • 64 Bits Output
  • V4 Quality Version
  • Reference Implementation: https://github.com/vnmakarov/mum-hash
• MurmurHash
  • 32/64/128 Bits Output
  • x86/x64 Variants
  • Reference Implementation: https://github.com/aappleby/smhasher
• Mx3Hash
  • 64 Bits Output
  • Reference Implementation: https://github.com/jonmaiga/mx3
• NmHash
  • 32 Bits Output
  • Standard/X Variants
  • Reference Implementation: https://github.com/gzm55/hash-garage
• PengyHash
  • 64 Bits Output
  • Reference Implementation: https://github.com/tinypeng/pengyhash
• PolymurHash
  • 64 Bits Output
  • Reference Implementation: https://github.com/orlp/polymur-hash
• RapidHash
  • 64 Bits Output
  • 1/2/3 Variants
  • Reference Implementation: https://github.com/Nicoshev/rapidhash
• SipHash
  • 64/128 Bits Output
  • 1-3/2-4 Variants
  • Reference Implementation: https://github.com/veorq/SipHash
• SpookyHash
  • 32/64/128 Bits Output
  • Reference Implementation: http://burtleburtle.net/bob/hash/spooky.html
• Umash
  • 64/128 Bits Output
  • Reference Implementation: https://github.com/backtrace-labs/umash
• W1Hash
  • 64 Bits Output
  • Reference Implementation: https://github.com/PeterRK/w1hash
• WyHash
  • 32/64 Bits Output
  • Reference Implementation: https://github.com/wangyi-fudan/wyhash
• XxHash
  • 32/64 Bits Output
  • Reference Implementation: https://github.com/Cyan4973/xxHash
• XxHash3
  • 64/128 Bits Output
  • Reference Implementation: https://github.com/Cyan4973/xxHash

Compatibility

FastHashes produces deterministic outputs for explicitly selected algorithms, variants, seeds, and inputs.
Algorithm upgrades or corrections may change computed hash values.
Applications that persist hash values or depend on reproducible results across library versions should verify output compatibility before upgrading.

Installation & Requirements

FastHashes is available on NuGet and can be installed as follows:

dotnet add package FastHashes

The following frameworks are supported:

• Library: .NET Standard 2.0, .NET Standard 2.1, .NET 10.0
• Auxiliary Projects: .NET 10.0

The following NuGet packages are used by the unit testing project:

• xunit.v3.mtp-v2
• Microsoft.Testing.Platform
• coverlet.MTP

Usage

FastHashes supports strongly typed, byte-array, and formatted string hash outputs.

The generic Hash<T> API provides strongly typed results through ComputeHashValue method:

using System;
using FastHashes;

Hash<UInt64> hash = new XxHash64();

UInt64 result = hash.ComputeHashValue("Hello World");

The non-generic Hash API supports dynamic algorithm selection and provides byte-array and formatted string outputs:

using System;
using FastHashes;

Hash hash = Hash.Create("XxHash64");

Byte[] resultBytes = hash.ComputeHashBytes("Hello World");
String resultString = hash.ComputeHashString("Hello World", HashFormat.Hexadecimal);

The generic API also inherits ComputeHashBytes and ComputeHashString methods from the non-generic base class.

Performance Benchmarks

The benchmarks above were conducted using the following hardware and software configuration:

• CPU: Intel Core i9-13900K @3.00 GHz (24 Cores, 32 Threads, 32 MB L2 Cache, 36 MB L3 Cache)
• RAM: 32 GB DDR5-6000 (2×16 GB Corsair DIMM @3000 MHz)
• OS: Microsoft Windows 11 Home 64-Bit
• Runtime: .NET 10.0

Performance may vary depending on the runtime, processor architecture, input size and execution environment.