Class KMac128

Namespace

CryptoHives.Foundation.Security.Cryptography.Mac

Assembly

CryptoHives.Foundation.Security.Cryptography.dll

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

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

Inheritance

object

HashAlgorithm

HashAlgorithm

KeccakCore

KeccakKMacCore

KMac128

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 KMAC128 based on the Keccak sponge construction. It does not rely on OS or hardware cryptographic APIs, ensuring deterministic behavior across all platforms and runtimes.

KMAC128 is a MAC function based on Keccak (cSHAKE128) defined in NIST SP 800-185. It provides 128-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

KMac128(byte[], int, byte[])

Initializes a new instance of the KMac128 class.

public KMac128(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.

KMac128(byte[], int, string?)

Initializes a new instance of the KMac128 class.

public KMac128(byte[] key, int outputBytes = 32, 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 = 256

Field Value

int

RateBytes

The rate in bytes (1344 bits for KMAC128).

public const int RateBytes = 168

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 KMac128 class.

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

Parameters

key byte[]

The secret key.

outputBytes int

The desired output size in bytes.

customization string

Optional customization string S.

Returns

KMac128

A new KMAC128 instance.