From 9de825bac3a50b6f60e8bfec2fb3a1e63292f757 Mon Sep 17 00:00:00 2001
From: YoshiRulz <OSSYoshiRulz+git@gmail.com>
Date: Thu, 15 May 2025 16:21:31 +1000
Subject: [PATCH] Add `SHA512Checksum` helper

---
 src/BizHawk.Common/checksums/CRC32Checksum.cs |  1 +
 src/BizHawk.Common/checksums/MD5Checksum.cs   |  1 +
 src/BizHawk.Common/checksums/SHA1Checksum.cs  |  1 +
 .../checksums/SHA256Checksum.cs               |  1 +
 .../checksums/SHA512Checksum.cs               | 58 +++++++++++++++++++
 5 files changed, 62 insertions(+)
 create mode 100644 src/BizHawk.Common/checksums/SHA512Checksum.cs

diff --git a/src/BizHawk.Common/checksums/CRC32Checksum.cs b/src/BizHawk.Common/checksums/CRC32Checksum.cs
index 44c2eafd7c..2da38d834d 100644
--- a/src/BizHawk.Common/checksums/CRC32Checksum.cs
+++ b/src/BizHawk.Common/checksums/CRC32Checksum.cs
@@ -6,6 +6,7 @@ namespace BizHawk.Common
 	/// <seealso cref="MD5Checksum"/>
 	/// <seealso cref="SHA1Checksum"/>
 	/// <seealso cref="SHA256Checksum"/>
+	/// <seealso cref="SHA512Checksum"/>
 	public static class CRC32Checksum
 	{
 		/// <remarks>in bits</remarks>
diff --git a/src/BizHawk.Common/checksums/MD5Checksum.cs b/src/BizHawk.Common/checksums/MD5Checksum.cs
index 20aa7939b5..80de6d4bb1 100644
--- a/src/BizHawk.Common/checksums/MD5Checksum.cs
+++ b/src/BizHawk.Common/checksums/MD5Checksum.cs
@@ -9,6 +9,7 @@ namespace BizHawk.Common
 	/// <seealso cref="CRC32Checksum"/>
 	/// <seealso cref="SHA1Checksum"/>
 	/// <seealso cref="SHA256Checksum"/>
+	/// <seealso cref="SHA512Checksum"/>
 	public static class MD5Checksum
 	{
 		/// <remarks>in bits</remarks>
diff --git a/src/BizHawk.Common/checksums/SHA1Checksum.cs b/src/BizHawk.Common/checksums/SHA1Checksum.cs
index 74c1fc5c88..a1131137ef 100644
--- a/src/BizHawk.Common/checksums/SHA1Checksum.cs
+++ b/src/BizHawk.Common/checksums/SHA1Checksum.cs
@@ -11,6 +11,7 @@ namespace BizHawk.Common
 	/// <seealso cref="CRC32Checksum"/>
 	/// <seealso cref="MD5Checksum"/>
 	/// <seealso cref="SHA256Checksum"/>
+	/// <seealso cref="SHA512Checksum"/>
 	public static class SHA1Checksum
 	{
 		/// <remarks>in bits</remarks>
diff --git a/src/BizHawk.Common/checksums/SHA256Checksum.cs b/src/BizHawk.Common/checksums/SHA256Checksum.cs
index b999e02c48..a0e38f7b73 100644
--- a/src/BizHawk.Common/checksums/SHA256Checksum.cs
+++ b/src/BizHawk.Common/checksums/SHA256Checksum.cs
@@ -9,6 +9,7 @@ namespace BizHawk.Common
 	/// <seealso cref="CRC32Checksum"/>
 	/// <seealso cref="MD5Checksum"/>
 	/// <seealso cref="SHA1Checksum"/>
+	/// <seealso cref="SHA512Checksum"/>
 	public static class SHA256Checksum
 	{
 		/// <remarks>in bits</remarks>
diff --git a/src/BizHawk.Common/checksums/SHA512Checksum.cs b/src/BizHawk.Common/checksums/SHA512Checksum.cs
new file mode 100644
index 0000000000..4a84436e34
--- /dev/null
+++ b/src/BizHawk.Common/checksums/SHA512Checksum.cs
@@ -0,0 +1,58 @@
+using System.Diagnostics;
+using System.Security.Cryptography;
+
+using BizHawk.Common.BufferExtensions;
+
+namespace BizHawk.Common
+{
+	/// <summary>uses <see cref="SHA512"/> implementation from BCL</summary>
+	/// <seealso cref="CRC32Checksum"/>
+	/// <seealso cref="MD5Checksum"/>
+	/// <seealso cref="SHA1Checksum"/>
+	/// <seealso cref="SHA256Checksum"/>
+	public static class SHA512Checksum
+	{
+		/// <remarks>in bits</remarks>
+		internal const int EXPECTED_LENGTH = 512;
+
+		internal const string PREFIX = "SHA512";
+
+#if NET7_0_OR_GREATER
+		public static byte[] Compute(ReadOnlySpan<byte> data)
+			=> SHA512.HashData(data);
+#else
+		private static SHA512? _sha512Impl;
+
+		private static SHA512 SHA512Impl
+		{
+			get
+			{
+				if (_sha512Impl == null)
+				{
+					_sha512Impl = SHA512.Create();
+					Debug.Assert(_sha512Impl.CanReuseTransform && _sha512Impl.HashSize is EXPECTED_LENGTH, "nonstandard implementation?");
+				}
+				return _sha512Impl;
+			}
+		}
+
+		public static byte[] Compute(byte[] data)
+			=> SHA512Impl.ComputeHash(data);
+
+		public static string ComputeDigestHex(byte[] data)
+			=> Compute(data).BytesToHexString();
+
+		public static string ComputePrefixedHex(byte[] data)
+			=> $"{PREFIX}:{ComputeDigestHex(data)}";
+
+		public static byte[] Compute(ReadOnlySpan<byte> data)
+			=> Compute(data.ToArray());
+#endif
+
+		public static string ComputeDigestHex(ReadOnlySpan<byte> data)
+			=> Compute(data).BytesToHexString();
+
+		public static string ComputePrefixedHex(ReadOnlySpan<byte> data)
+			=> $"{PREFIX}:{ComputeDigestHex(data)}";
+	}
+}