Blake3.Native 3.0.2

Blake3.NET

<img align="right" width="160px" height="160px" src="img/logo.svg" alt="Blake3.NET logo">

Blake3.NET provides two fast, SIMD-accelerated implementations of the BLAKE3 cryptographic hash function: the fully managed Blake3 package and the native Blake3.Native package, which wraps the official Rust implementation.

The version of the native BLAKE3 implementation used by Blake3.Native is 1.8.2.

Features

• Compatible with .NET 8+.
• Span-friendly API with either a fully managed or native implementation.
• API similar to the Blake3 Rust API.
• CPU SIMD Hardware accelerated with dynamic CPU feature detection.
  • Multiple platforms supported.
• Incremental update API via Hasher.
• Fully managed regular, keyed, derive-key, incremental, and XOF hashing in the Blake3 package.
• Support for multi-threaded hashing via Hasher.UpdateWithJoin in both Blake3 and Blake3.Native.

Packages

Starting with version 3.0, choose one of the two packages. Both expose the same hashing API and type names in the Blake3 namespace, including Blake3.Hasher, Blake3.Hash, Blake3HashAlgorithm, and Blake3Stream:

dotnet add package Blake3
# or, to use the Rust implementation through native interop:
dotnet add package Blake3.Native

The Blake3 package uses runtime-selected scalar and 128/256/512-bit SIMD code implemented entirely in .NET and has no native library dependency. Blake3.Native uses the optimized Rust implementation through native interop. Switching packages does not require source changes. A project should reference only one package because both intentionally define the same fully qualified public types.

Usage

Hash a buffer directly:

var hash = Blake3.Hasher.Hash(Encoding.UTF8.GetBytes("BLAKE3"));
Console.WriteLine(hash);
// Prints f890484173e516bfd935ef3d22b912dc9738de38743993cfedf2c9473b3216a4

Or use the disposable Hasher type for incremental updates:

using var hasher = Blake3.Hasher.New();
hasher.Update(Encoding.UTF8.GetBytes("BLAKE3"));
var hash = hasher.Finalize();

With either package, Hasher.UpdateWithJoin hashes large aligned subtrees in parallel and preserves the exact incremental semantics of Update; smaller inputs stay on the serial path to avoid scheduling overhead.

Or seek in the output "stream" to any position:

using var hasher = Blake3.Hasher.New();
hasher.Update(Encoding.UTF8.GetBytes("BLAKE3"));
var hashAtPosition = new byte[1024];
hasher.Finalize(4242, hashAtPosition);

Or hash a stream on the go with Blake3Stream:

using var blake3Stream = new Blake3Stream(new MemoryStream());
blake3Stream.Write(Encoding.UTF8.GetBytes("BLAKE3"));
var hash = blake3Stream.ComputeHash();

Or produce a message authentication code using a 256-bit key:

using var blake3 = Hasher.NewKeyed(macKey);
blake3.UpdateWithJoin(message);
var tag = blake3.Finalize();
byte[] authenticationTag = tag.AsSpan().ToArray();

Or derive a subkey from a master key:

const string context = "[application] [commit timestamp] [purpose]";
using var blake3 = Hasher.NewDeriveKey(Encoding.UTF8.GetBytes(context));
blake3.Update(inputKeyingMaterial);
var derivedKey = blake3.Finalize();
byte[] subkey = derivedKey.AsSpan().ToArray();

Platforms

The Blake3.Native package is supported on the following platforms:

• win-x64, win-x86, win-arm64
• linux-x64, linux-arm64, linux-arm, linux-musl-x64, linux-musl-arm64
• osx-x64, osx-arm64

The Blake3 package has no native runtime dependency and can run on any platform supported by .NET 10. Hardware intrinsics are selected at runtime, with a scalar fallback when SIMD is unavailable.

Benchmarks

Starting with version 3.0, the Blake3 package delivers near-native BLAKE3 performance without shipping or loading a native library. Benchmarks on an AMD Ryzen 9 9950X (x64) and an Apple M4 Pro (ARM64) show that:

• Serial Blake3 performance ranges from about 11% faster to 22% slower than the SIMD-optimized native Rust implementation across inputs from 4 bytes to 10 MB.
• On ARM64 it is 5% faster at 4 bytes and about 13% to 20% slower from 1 KB to 10 MB; on x64 it is 11% faster at 100 bytes and about 12% to 22% slower from 1 KB to 10 MB.
• At 64 KiB on x64, serial Blake3 is about 2.4x faster than the external Blake3.Managed package, 3.9x faster than SHA256, and 9.9x faster than Blake2Fast in these runs.
• Hasher.UpdateWithJoin substantially improves throughput for multi-megabyte inputs. At 10 MB on x64 it is about 4.4x faster than serial Blake3; the exact parallel crossover depends on the CPU, available cores, runtime, and input shape.
• The serial Blake3 and Blake3.Native paths perform these benchmarks without managed allocations.

See the full benchmark methodology and results for the x64 and ARM64 environments, comparisons with other hash implementations, and explicit parallel measurements.

How to Build?

You need to install the .NET 10 SDK or latest Visual Studio 2026. Then from the root folder:

$ dotnet build src -c Release

In order to rebuild the native binaries, you need to run the build scripts from lib/blake3_dotnet

License

This software is released under the BSD-Clause 2 license.

Author

Alexandre Mutel aka xoofx.