SauceControl.Blake2Fast
0.1.0
Prefix Reserved
See the version list below for details.
dotnet add package SauceControl.Blake2Fast --version 0.1.0
NuGet\Install-Package SauceControl.Blake2Fast -Version 0.1.0
<PackageReference Include="SauceControl.Blake2Fast" Version="0.1.0" />
paket add SauceControl.Blake2Fast --version 0.1.0
#r "nuget: SauceControl.Blake2Fast, 0.1.0"
// Install SauceControl.Blake2Fast as a Cake Addin
#addin nuget:?package=SauceControl.Blake2Fast&version=0.1.0
// Install SauceControl.Blake2Fast as a Cake Tool
#tool nuget:?package=SauceControl.Blake2Fast&version=0.1.0
These RFC 7693-compliant BLAKE2 implementations have been tuned for high speed and low memory usage. The .NET Core 2.1 build supports the new X86 SIMD Intrinsics for even greater speed and Span{T}
for even lower memory usage.
Usage
All-at-Once Hashing
The simplest and lightest-weight way to calculate a hash is the all-at-once ComputeHash
method.
Blake2b.ComputeHash(data);
BLAKE2 supports variable digest lengths from 1 to 32 bytes for Blake2s
or 1 to 64 bytes for Blake2b
.
Blake2b.ComputeHash(42, data);
BLAKE2 also natively supports keyed hashing.
Blake2b.ComputeHash(key, data);
Incremental Hashing
BLAKE2 hashes can be incrementally updated if you do not have the data available all at once.
async Task<byte[]> CalculateHashAsync(Stream data)
{
var incHash = Blake2b.CreateIncrementalHasher();
var buffer = new byte[4096];
int bytesRead;
while ((bytesRead = await data.ReadAsync(buffer, 0, buffer.Length)) > 0)
{
// Use Span<T> for .NET Core 2.1 or ArraySegment<T> for others
incHash.Update(new ArraySegment<byte>(buffer, 0, bytesRead));
}
return incHash.Finish();
}
System.Security.Cryptography Interop
For interoperating with code that uses System.Security.Cryptography
primitives, Blake2Fast can create a HashAlgorithm
wrapper. The wrapper inherits from HMAC
in case keyed hashing is required.
HashAlgorithm
is less efficient than the above methods, so use it only when necessary for compatibility.
byte[] WriteDataAndCalculateHash(byte[] data)
{
using (var hashAlg = Blake2b.CreateHashAlgorithm())
using (var fileStream = new FileStream(@"c:\data\output.bin", FileMode.Create))
using (var cryptoStream = new CryptoStream(fileStream, hashAlg, CryptoStreamMode.Write))
{
cryptoStream.Write(data, 0, data.Length);
cryptoStream.FlushFinalBlock();
return hashAlg.Hash;
}
}
SIMD Intrinsics Warning
The X86 SIMD Intrinsics used in the .NET Core 2.1 build are not officially supported by Microsoft. Although the specific SSE Intrinsics used by Blake2Fast have been well-tested, the JIT support for the X86 Intrinsics in general is experimental in .NET Core 2.1. Please test with your specific hardware and report any issues here or in the CoreCLR repo as appropriate.
If you are uncomfortable using unsupported functionality, you can make a custom build of Blake2Fast by removing the USE_INTRINSICS
define constant in the project file. This applies only to .NET Core 2.1; the older build targets use only the scalar code.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp1.0 was computed. netcoreapp1.1 was computed. netcoreapp2.0 is compatible. netcoreapp2.1 is compatible. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard1.0 is compatible. netstandard1.1 was computed. netstandard1.2 was computed. netstandard1.3 is compatible. netstandard1.4 was computed. netstandard1.5 was computed. netstandard1.6 was computed. netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net45 is compatible. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen30 was computed. tizen40 was computed. tizen60 was computed. |
Universal Windows Platform | uap was computed. uap10.0 was computed. |
Windows Phone | wp8 was computed. wp81 was computed. wpa81 was computed. |
Windows Store | netcore was computed. netcore45 was computed. netcore451 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETCoreApp 2.0
- System.Runtime.CompilerServices.Unsafe (>= 4.5.0)
-
.NETCoreApp 2.1
- System.Runtime.CompilerServices.Unsafe (>= 4.5.0)
- System.Runtime.Intrinsics.Experimental (>= 4.5.0-rc1)
-
.NETFramework 4.5
- System.Runtime.CompilerServices.Unsafe (>= 4.5.0)
-
.NETStandard 1.0
- NETStandard.Library (>= 1.6.1)
- System.Runtime.CompilerServices.Unsafe (>= 4.5.0)
-
.NETStandard 1.3
- NETStandard.Library (>= 1.6.1)
- System.Runtime.CompilerServices.Unsafe (>= 4.5.0)
-
.NETStandard 2.0
- System.Runtime.CompilerServices.Unsafe (>= 4.5.0)
NuGet packages (14)
Showing the top 5 NuGet packages that depend on SauceControl.Blake2Fast:
Package | Downloads |
---|---|
CardanoSharp.Wallet
Package Description |
|
Orion.CardanoSharp.Wallet
Package Description |
|
FleetSharp
Package Description |
|
NextGenSoftware.Holochain.HoloNET.Client
The world's first .NET & Unity client for Holochain. |
|
NextGenSoftware.Holochain.HoloNET.Client.Embedded
The world's first .NET & Unity client for Holochain. This version comes with the Holochain binaries built in. |
GitHub repositories (2)
Showing the top 2 popular GitHub repositories that depend on SauceControl.Blake2Fast:
Repository | Stars |
---|---|
baking-bad/tzkt
😼 Awesome Tezos blockchain indexer and API
|
|
xoofx/Blake3.NET
Blake3.NET is a fast managed wrapper around the SIMD Rust implementations of the BLAKE3 cryptographic hash function.
|