Class KMac256

Namespace

CryptoHives.Foundation.Security.Cryptography.Mac

Assembly

CryptoHives.Foundation.Security.Cryptography.dll

Computes the KMAC256 (Keccak Message Authentication Code) for the input data.

public sealed class KMac256 : KeccakKMacCore, ICryptoTransform, IDisposable, IResettable, IExtendableOutput

Inheritance

object

HashAlgorithm

HashAlgorithm

KeccakCore

KeccakKMacCore

KMac256

Implements

ICryptoTransform

IDisposable

IResettable

IExtendableOutput

Inherited Members

KeccakKMacCore.Initialize()

KeccakKMacCore.Absorb(ReadOnlySpan<byte>)

KeccakKMacCore.Reset()

KeccakKMacCore.Squeeze(Span<byte>)

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.Create()

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()

Remarks

This is a fully managed implementation of KMAC256 based on the Keccak sponge construction. It does not rely on OS or hardware cryptographic APIs, ensuring deterministic behavior across all platforms and runtimes.

KMAC256 is a MAC function based on Keccak (cSHAKE256) defined in NIST SP 800-185. It provides 256-bit security strength and supports variable-length output.

KMAC can be used as both a traditional MAC (fixed output length) or as a pseudorandom function (XOF mode with arbitrary output length).

Constructors

KMac256(byte[], int, byte[])

Initializes a new instance of the KMac256 class.

public KMac256(byte[] key, int outputBytes, byte[] customization)

Parameters

key byte[]

The secret key.

outputBytes int

The desired output size in bytes.

customization byte[]

Optional customization bytes S.

KMac256(byte[], int, string?)

Initializes a new instance of the KMac256 class.

public KMac256(byte[] key, int outputBytes = 64, string? customization = null)

Parameters

key byte[]

The secret key.

outputBytes int

The desired output size in bytes.

customization string

Optional customization string S.

Fields

DefaultOutputBits

The default output size in bits.

public const int DefaultOutputBits = 512

Field Value

int

RateBytes

The rate in bytes (1088 bits for KMAC256).

public const int RateBytes = 136

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

Methods

Create(byte[], int, string?)

Creates a new instance of the KMac256 class.

public static KMac256 Create(byte[] key, int outputBytes = 64, string? customization = null)

Parameters

key byte[]

The secret key.

outputBytes int

The desired output size in bytes.

customization string

Optional customization string S.

Returns

KMac256

A new KMAC256 instance.