acryptohashnet

A pure managed C# implementation of cryptographic hash functions for .Net Standard 2.0 compatible platforms (.Net Framework, .Net Core, Mono, Xamarin, UWP, Unity).

Features

• Pure managed C# implementation,
• Compatible with System.Security.Cryptography.HashAlgorithm and can be used everywhere as a simple drop replacement for the target hash algorithm,
• Extremely fast, highly optimized with low memory footprint (less GC time).

Supported hash functions

• MD family: MD2, MD4, MD5,
• SHA family: SHA0, SHA1,
• SHA2 family: SHA224, SHA256, SHA384, SHA512,
• SHA3 family: SHA3-224, SHA3-256, SHA3-384, SHA3-512,
• RIPEMD family: RIPEMD128, RIPEMD160,
• Haval family: Haval128, Haval160, Haval192, Haval224, Haval256,
• Snefru, Snefru256,
• Tiger and Tiger2 (192 bits output)

Usage examples

MD5

using System;
using System.Linq;
using System.Text;

static class Program
{
    static void Main(string[] args)
    {
        var message = "Test Message";

        var hashAlgorithm = new acryptohashnet.MD5();
        Console.WriteLine("MD5: {0}", hashAlgorithm.ComputeHash(message.ToUtf8Bytes()).ToHexString());
    }

    static byte[] ToUtf8Bytes(this string input) => Encoding.UTF8.GetBytes(input);
    static string ToHexString(this byte[] input) => string.Join("", input.Select(x => x.ToString("x2")));
}

SHA256 (SHA2-256 bits)

using System;
using System.Linq;
using System.Text;

static class Program
{
    static void Main(string[] args)
    {
        var message = "Test Message";

        var hashAlgorithm = new acryptohashnet.Sha2_256();
        Console.WriteLine("SHA256: {0}", hashAlgorithm.ComputeHash(message.ToUtf8Bytes()).ToHexString());
    }

    static byte[] ToUtf8Bytes(this string input) => Encoding.UTF8.GetBytes(input);
    static string ToHexString(this byte[] input) => string.Join("", input.Select(x => x.ToString("x2")));
}

Compute string message hash via HashAlgorithm interface (MD5, SHA1, SHA256, SHA3-512)

static class Program
{
    static void Main(string[] args)
    {
        var md5 = new acryptohashnet.MD5();
        var sha1 = new acryptohashnet.SHA1();
        var sha2_256 = new acryptohashnet.Sha2_256();
        var sha3_512 = new acryptohashnet.Sha3_512();

        var message = "Lorem ipsum is placeholder text commonly used in the graphic, " +
                  "print, and publishing industries for previewing layouts and visual mockups.";

        Console.WriteLine("MD5: {0}", md5.ComputeHash(message.ToUtf8Bytes()).ToHexString());
        Console.WriteLine("SHA1: {0}", sha1.ComputeHash(message.ToUtf8Bytes()).ToHexString());
        Console.WriteLine("SHA256: {0}", sha2_256.ComputeHash(message.ToUtf8Bytes()).ToHexString());
        Console.WriteLine("SHA3-512: {0}", sha3_512.ComputeHash(message.ToUtf8Bytes()).ToHexString());
    }

    static byte[] ToUtf8Bytes(this string input) => System.Text.Encoding.UTF8.GetBytes(input);
    static string ToHexString(this byte[] input) => string.Join("", input.Select(x => x.ToString("x2")));
}

Compute hash of file via HashAlgorithm interface (MD5, SHA1, SHA256, SHA3-512)

static class Program
{
    static void Main(string[] args)
    {
        var md5 = new acryptohashnet.MD5();
        var sha1 = new acryptohashnet.SHA1();
        var sha2_256 = new acryptohashnet.Sha2_256();
        var sha3_512 = new acryptohashnet.Sha3_512();

        using (var file = File.OpenRead(@"C:\Windows\explorer.exe"))
        {
            Console.WriteLine("MD5: {0}", md5.ComputeHash(file).ToHexString());

            file.Position = 0; // Rewind stream to beginning
            Console.WriteLine("SHA1: {0}", sha1.ComputeHash(file).ToHexString());

            file.Position = 0; // Rewind stream to beginning
            Console.WriteLine("SHA256: {0}", sha2_256.ComputeHash(file).ToHexString());

            file.Position = 0; // Rewind stream to beginning
            Console.WriteLine("SHA3-512: {0}", sha3_512.ComputeHash(file).ToHexString());
        }
    }

    static string ToHexString(this byte[] input) => string.Join("", input.Select(x => x.ToString("x2")));
}

Implemented hash algorithms

MD Family

All functions designed and specified by Ron Rivest.

• MD2, specification: RFC 1319.
• MD4, specification: RFC 1320.
• MD5, specification: RFC 1321.

SHA0 & SHA1

Secure Hash Standard [pdf]

SHA2 Family

Secure Hash Standard [pdf]

Published as standard by "National Institute of Standards and Technology".

• SHA-0,
• SHA-1,
• SHA2-224 (also known as SHA224),
• SHA2-256 (also known as SHA256),
• SHA2-384 (also known as SHA384),
• SHA2-512 (also known as SHA512)

SHA3 Family

SHA-3 Standard: Permutation-Based Hash and Extendable-Output Functions [pdf]

Published as standard by "National Institute of Standards and Technology".

• SHA3-224,
• SHA3-256,
• SHA3-384,
• SHA3-512

RIPEMD

RIPEMD-160: A Strengthened Version of RIPEMD [pdf]

Designed by Hans Dobbertin, Antoon Bosselaers, Bart Preneel

Haval

HAVAL — A One-Way Hashing Algorithm with Variable Length of Output [pdf]

Designed by Yuliang Zheng, Josef Pieprzyk and Jennifer Seberry.

Snefru

A Fast Software One-Way Hash Function [pdf]

Designed and specified by Ralph C. Merkle.

Tiger and Tiger2

Tiger: A Fast New Hash Function [ps] [pdf]

Designed and specified by Ross Anderson and Eli Biham.

History

Originally project was developed between 2006-2009 as an open source project and was hosted on SourceForge: https://sourceforge.net/projects/acryptohashnet/. In 2020 was migrated to Github and modernized for support .Net Core platform.

Used by commercial and open source software

• Motorola RM Software
• Quest Software Metalogix Archive Manager for Exchange
• Soft EtherConfig Password Node Generator https://github.com/SecretNest/SoftEtherConfigPasswordNodeGenerate
• Microsoft .NET wrapper for connecting to EMC Atmos Storage Service https://github.com/EMCECS/atmos-dotnet
• iTextSharp unofficial .Net Core port https://github.com/VahidN/iTextSharp.LGPLv2.Core
• UnityClassNameHasher https://github.com/OptoCloud/UnityClassNameHasher