Class SHA256

Namespace

CryptoHives.Foundation.Security.Cryptography.Hash

Assembly

CryptoHives.Foundation.Security.Cryptography.dll

Computes the SHA-256 hash for the input data.

public sealed class SHA256 : Sha2HashAlgorithm<uint>, ICryptoTransform, IDisposable, IResettable

Inheritance

object

HashAlgorithm

HashAlgorithm

Sha2HashAlgorithm<uint>

SHA256

Implements

ICryptoTransform

IDisposable

IResettable

Inherited Members

Sha2HashAlgorithm<uint>.StateSizeWords

Sha2HashAlgorithm<uint>.Initialize()

HashAlgorithm.Create(string, bool)

HashAlgorithm.Create(string)

HashAlgorithm.TryComputeHash(ReadOnlySpan<byte>, Span<byte>, out int)

HashAlgorithm.AppendData(ReadOnlySpan<byte>)

HashAlgorithm.AppendData(in ReadOnlySequence<byte>)

HashAlgorithm.TryGetHashAndReset(Span<byte>, out int)

HashAlgorithm.TryReset()

HashAlgorithm.ComputeHash(Stream)

HashAlgorithm.ComputeHash(byte[])

HashAlgorithm.ComputeHash(byte[], int, int)

HashAlgorithm.TransformBlock(byte[], int, int, byte[], int)

HashAlgorithm.TransformFinalBlock(byte[], int, int)

HashAlgorithm.Dispose()

HashAlgorithm.Clear()

HashAlgorithm.HashSize

HashAlgorithm.Hash

HashAlgorithm.InputBlockSize

HashAlgorithm.OutputBlockSize

HashAlgorithm.CanTransformMultipleBlocks

HashAlgorithm.CanReuseTransform

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

object.GetType()

Examples

using CryptoHives.Foundation.Security.Cryptography.Hash;

byte[] data = Encoding.UTF8.GetBytes("Hello, World!");
using var sha256 = SHA256.Create();
byte[] hash = sha256.ComputeHash(data);

Remarks

This is a fully managed implementation of SHA-256 that does not rely on OS or hardware cryptographic APIs, ensuring deterministic behavior across all platforms and runtimes.

SHA-256 produces a 256-bit (32-byte) hash value.

Constructors

SHA256()

Initializes a new instance of the SHA256 class.

public SHA256()

Fields

HashSizeBits

The hash size in bits.

public const int HashSizeBits = 256

Field Value

int

HashSizeBytes

The hash size in bytes.

public const int HashSizeBytes = 32

Field Value

int

Properties

AlgorithmName

Gets the name of the hash algorithm.

public override string AlgorithmName { get; }

Property Value

string

BlockSize

Gets the block size in bytes used by the hash algorithm.

public override int BlockSize { get; }

Property Value

int

BlockSizeBytes

Gets the block size in bytes for this algorithm.

protected override int BlockSizeBytes { get; }

Property Value

int

OutputSizeBytes

Gets the hash output size in bytes.

protected override int OutputSizeBytes { get; }

Property Value

int

Methods

Create()

Creates a new instance of the SHA256 class.

public static SHA256 Create()

Returns

SHA256

A new SHA-256 hash algorithm instance.

HashData(in ReadOnlySequence<byte>)

Computes the SHA-256 hash of source and returns it as a new byte array.

public static byte[] HashData(in ReadOnlySequence<byte> source)

Parameters

source ReadOnlySequence<byte>

The (possibly multi-segment) input sequence to hash.

Returns

byte[]

A new byte array containing the SHA-256 hash.

HashData(ReadOnlySpan<byte>)

Computes the SHA-256 hash of source and returns it as a new byte array.

public static byte[] HashData(ReadOnlySpan<byte> source)

Parameters

source ReadOnlySpan<byte>

The input data to hash.

Returns

byte[]

A new byte array containing the SHA-256 hash.

InitializeState()

Initializes the hash state with algorithm-specific initial values.

protected override void InitializeState()

OutputHash(Span<byte>, uint[])

Writes the final hash output from the state to the destination.

protected override void OutputHash(Span<byte> destination, uint[] state)

Parameters

destination Span<byte>

The destination span for the hash output.

state uint[]

The state array containing the hash values.

PadAndFinalize(Span<byte>, int, long, Span<uint>)

Pads and finalizes the hash computation.

protected override void PadAndFinalize(Span<byte> buffer, int bufferLength, long bytesProcessed, Span<uint> state)

Parameters

buffer Span<byte>

The buffer containing remaining unprocessed bytes.

bufferLength int

The number of valid bytes in the buffer.

bytesProcessed long

Total bytes processed before this finalization.

state Span<uint>

The state array to update.

ProcessBlock(ReadOnlySpan<byte>, Span<uint>)

Processes a single block, updating the state.

protected override void ProcessBlock(ReadOnlySpan<byte> block, Span<uint> state)

Parameters

block ReadOnlySpan<byte>

The block data to process.

state Span<uint>

The state array to update.

TryHashData(in ReadOnlySequence<byte>, Span<byte>, out int)

Computes the SHA-256 hash of source and writes it into destination.

public static bool TryHashData(in ReadOnlySequence<byte> source, Span<byte> destination, out int bytesWritten)

Parameters

source ReadOnlySequence<byte>

The (possibly multi-segment) input sequence to hash.

destination Span<byte>

The buffer to receive the hash value. Must be at least HashSizeBytes bytes.

bytesWritten int

When this method returns, the number of bytes written into destination.

Returns

bool

true if destination was large enough; otherwise, false.

TryHashData(ReadOnlySpan<byte>, Span<byte>, out int)

Computes the SHA-256 hash of source and writes it into destination.

public static bool TryHashData(ReadOnlySpan<byte> source, Span<byte> destination, out int bytesWritten)

Parameters

source ReadOnlySpan<byte>

The input data to hash.

destination Span<byte>

The buffer to receive the hash value. Must be at least HashSizeBytes bytes.

bytesWritten int

When this method returns, the number of bytes written into destination.

Returns

bool

true if destination was large enough; otherwise, false.