Support for Blake3

Adding native support for Blake3 through https://github.com/xoofx/Blake3.NET

Author: LordOfXen

src/OpenSource.Data.HashFunction.Blake3/Blake3Config.cs

@@ -0,0 +1,37 @@
+using System.Collections.Generic;
+using System.Linq;
+
+namespace OpenSource.Data.HashFunction.Blake3
+{
+    /// <summary>
+    /// Defines a configuration for a Blake2B hash function implementation.
+    /// </summary>
+    public class Blake3Config
+        : IBlake3Config
+    {
+        /// <summary>
+        /// The default hash size, in bits.
+        /// </summary>
+        public const int DefaultHashSizeInBits = 32;
+
+        /// <summary>
+        /// Gets the desired hash size, in bits.
+        /// </summary>
+        /// <value>
+        /// The desired hash size, in bits.
+        /// </value>
+        /// <remarks>
+        /// Defaults to <c>32</c>.
+        /// </remarks>
+        public int HashSizeInBits { get; set; } = DefaultHashSizeInBits;
+
+        /// <summary>
+        /// Makes a deep clone of current instance.
+        /// </summary>
+        /// <returns>A deep clone of the current instance.</returns>
+        public IBlake3Config Clone() =>
+            new Blake3Config() {
+                HashSizeInBits = HashSizeInBits
+            };
+    }
+}

src/OpenSource.Data.HashFunction.Blake3/Blake3Factory.cs

@@ -0,0 +1,51 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace OpenSource.Data.HashFunction.Blake3
+{
+    /// <summary>
+    /// Provides instances of implementations of <see cref="IBlake3"/>.
+    /// </summary>
+    public sealed class Blake3Factory
+        : IBlake3Factory
+    {
+        /// <summary>
+        /// Gets the singleton instance of this factory.
+        /// </summary>
+        public static IBlake3Factory Instance { get; } = new Blake3Factory();
+
+
+        private Blake3Factory()
+        {
+
+        }
+
+        /// <summary>
+        /// Creates a new <see cref="IBlake3" /> instance with the default configuration.
+        /// </summary>
+        /// <returns>
+        /// A <see cref="IBlake3" /> instance.
+        /// </returns>
+        public IBlake3 Create()
+        {
+            return Create(new Blake3Config());
+        }
+
+        /// <summary>
+        /// Creates a new <see cref="IBlake3" /> instance with given configuration.
+        /// </summary>
+        /// <param name="config">The configuration to use.</param>
+        /// <returns>
+        /// A <see cref="IBlake3" /> instance.
+        /// </returns>
+        /// <exception cref="ArgumentNullException"><paramref name="config"/></exception>
+        public IBlake3 Create(IBlake3Config config)
+        {
+            if (config == null)
+                throw new ArgumentNullException(nameof(config));
+
+            return new Blake3_Implementation(config);
+        }
+    }
+}

src/OpenSource.Data.HashFunction.Blake3/Blake3_Implementation.cs

@@ -0,0 +1,48 @@
+using OpenSource.Data.HashFunction.Core;
+using OpenSource.Data.HashFunction.Core.Utilities;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Runtime.InteropServices;
+using System.Security.Cryptography;
+using System.Threading;
+
+namespace OpenSource.Data.HashFunction.Blake3
+{
+	internal partial class Blake3_Implementation
+		: HashFunctionBase,
+			IBlake3
+	{
+		private readonly IBlake3Config _config;
+		public IBlake3Config Config => _config.Clone();
+
+		public const int MinHashSizeInBits = 8;
+		public const int MaxHashSizeInBits = 4096;
+
+		public Blake3_Implementation(IBlake3Config config)
+		{
+			if (config == null)
+				throw new ArgumentNullException(nameof(config));
+
+			_config = config.Clone();
+
+			if (_config.HashSizeInBits < MinHashSizeInBits || _config.HashSizeInBits > MaxHashSizeInBits)
+				throw new ArgumentOutOfRangeException($"{nameof(config)}.{nameof(config.HashSizeInBits)}", _config.HashSizeInBits, $"Expected: {MinHashSizeInBits} >= {nameof(config)}.{nameof(config.HashSizeInBits)} <= {MaxHashSizeInBits}");
+
+			if (_config.HashSizeInBits % 8 != 0)
+				throw new ArgumentOutOfRangeException($"{nameof(config)}.{nameof(config.HashSizeInBits)}", _config.HashSizeInBits, $"{nameof(config)}.{nameof(config.HashSizeInBits)} must be a multiple of 8.");
+		}
+
+		public override int HashSizeInBits => _config.HashSizeInBits;
+
+		protected override IHashValue ComputeHashInternal(ArraySegment<byte> data, CancellationToken cancellationToken)
+		{
+			byte[] outputBuffer = new byte[Config.HashSizeInBits];
+
+			Span<byte> output = new Span<byte>(outputBuffer);
+			Hasher.Hash(data.AsSpan(), output);
+
+			return new HashValue(outputBuffer, Config.HashSizeInBits);
+		}
+	}
+}