Class TurboShake128

Namespace

CryptoHives.Foundation.Security.Cryptography.Hash

Assembly

CryptoHives.Foundation.Security.Cryptography.dll

Computes a variable-length output using TurboSHAKE128 (XOF) per RFC 9861.

public sealed class TurboShake128 : KeccakXofCore, ICryptoTransform, IDisposable, IResettable, IExtendableOutput

Inheritance

object

HashAlgorithm

HashAlgorithm

KeccakCore

KeccakXofCore

TurboShake128

Implements

ICryptoTransform

IDisposable

IResettable

IExtendableOutput

Inherited Members

KeccakXofCore.Initialize()

KeccakXofCore.ResetWithDomainSeparator(byte)

KeccakXofCore.Squeeze(Span<byte>)

KeccakXofCore.Absorb(ReadOnlySpan<byte>)

KeccakXofCore.Reset()

KeccakXofCore.TransformBlock(ReadOnlySpan<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.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 TurboSHAKE128 based on the reduced-round Keccak permutation. It does not rely on OS or hardware cryptographic APIs, ensuring deterministic behavior across all platforms and runtimes.

TurboSHAKE128 is an extendable-output function (XOF) based on a reduced-round Keccak-p[1600, n_r=12] permutation with 12 rounds instead of 24 used in SHAKE. It provides 128-bit security strength and is approximately twice as fast as SHAKE128.

TurboSHAKE128 uses a rate of 168 bytes (1344 bits) and a capacity of 32 bytes (256 bits).

The domain separation byte D must be in the range [0x01, 0x7F]. The default value is 0x1F.

Constructors

TurboShake128()

Initializes a new instance of the TurboShake128 class with default output size.

public TurboShake128()

TurboShake128(int)

Initializes a new instance of the TurboShake128 class with specified output size.

public TurboShake128(int outputBytes)

Parameters

outputBytes int

The desired output size in bytes.

TurboShake128(int, byte)

Initializes a new instance of the TurboShake128 class with specified output size and domain separator.

public TurboShake128(int outputBytes, byte domainSeparator)

Parameters

outputBytes int

The desired output size in bytes.

domainSeparator byte

The domain separation byte (must be in range [0x01, 0x7F]).

Fields

CapacityBytes

The capacity in bytes (256 bits for TurboShake128).

public const int CapacityBytes = 32

Field Value

int

DefaultOutputBits

The default output size in bits.

public const int DefaultOutputBits = 256

Field Value

int

DomainSeparator

The TurboShake domain separation byte.

public const byte DomainSeparator = 31

Field Value

byte

RateBytes

The rate in bytes (1344 bits for TurboShake128).

public const int RateBytes = 168

Field Value

int

StartRound

The start round for the sponge construction.

public const int StartRound = 12

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

Creates a new instance of the TurboShake128 class with default output size.

public static TurboShake128 Create()

Returns

TurboShake128

A new TurboShake128 instance.

Create(int)

Creates a new instance of the TurboShake128 class with specified output size.

public static TurboShake128 Create(int outputBytes)

Parameters

outputBytes int

The desired output size in bytes.

Returns

TurboShake128

A new TurboShake128 instance.

Create(int, byte)

Creates a new instance of the TurboShake128 class with specified output size and domain separator.

public static TurboShake128 Create(int outputBytes, byte domainSeparator)

Parameters

outputBytes int

The desired output size in bytes.

domainSeparator byte

The domain separation byte.

Returns

TurboShake128

A new TurboShake128 instance.

HashData(in ReadOnlySequence<byte>)

Computes the TurboSHAKE128 hash of source using the default output size 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 TurboSHAKE128 hash.

HashData(ReadOnlySpan<byte>)

Computes the TurboSHAKE128 hash of source using the default output size 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 TurboSHAKE128 hash.

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

Computes the TurboSHAKE128 hash of source using the default output size 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 32 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 TurboSHAKE128 hash of source using the default output size 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 32 bytes.

bytesWritten int

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

Returns

bool

true if destination was large enough; otherwise, false.