iaik.security.pq.mldsa

Class SettingsMLDSAAlgorithmParameterSpec

java.lang.Object

iaik.security.pq.mldsa.SettingsMLDSAAlgorithmParameterSpec

All Implemented Interfaces:

AlgorithmParameterSpec

public class SettingsMLDSAAlgorithmParameterSpec
extends Object
implements AlgorithmParameterSpec

This class is used change how the MLDSA signing operation behaves.

Use useRandomizedSigning(boolean) to switch between randomized and deterministic signing.

Use setContext(byte[]) to set the context used for the sign/verify operation

Call Signature.setParameter(AlgorithmParameterSpec) before the init() method

  Signature mldsa = Signature.getInstance("MLDSA", IaikPq.getInstance());
  mldsa.setParameter(new SettingsMLDSAAlgorithmParameterSpec());
  mldsa.initSign(...);
      

Constructor Summary

Constructors

Constructor and Description
SettingsMLDSAAlgorithmParameterSpec() Creates a default parameter spec with randomized signing enabled and no context set.
SettingsMLDSAAlgorithmParameterSpec(boolean randomizedSigning) Creates a parameter spec with the specified randomized signing setting.
SettingsMLDSAAlgorithmParameterSpec(byte[] context) Creates a parameter spec with the specified context.
SettingsMLDSAAlgorithmParameterSpec(byte[] context, boolean randomizedSigning) Creates a parameter spec with both the specified context and randomized signing setting.

Method Summary

Modifier and Type	Method and Description
byte[]	getContext() Retrieves the currently set context.
boolean	isRandomizedSigning() Checks if the current configuration uses randomized signing.
void	setContext(byte[] ctx) Sets the context for MLDSA operations.
void	useRandomizedSigning(boolean randomizedSigning) Configures whether signatures should be randomized (true, default) or deterministic (false).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SettingsMLDSAAlgorithmParameterSpec

public SettingsMLDSAAlgorithmParameterSpec()

Creates a default parameter spec with randomized signing enabled and no context set.

SettingsMLDSAAlgorithmParameterSpec

public SettingsMLDSAAlgorithmParameterSpec(byte[] context)
                                    throws PQException

Creates a parameter spec with the specified context. Randomized signing is enabled by default.

Parameters:

context - The context to be used during signing, up to 255 bytes.

Throws:

PQException - If the context length exceeds 255 bytes or is null.

SettingsMLDSAAlgorithmParameterSpec

public SettingsMLDSAAlgorithmParameterSpec(boolean randomizedSigning)

Creates a parameter spec with the specified randomized signing setting. Context remains unset initially.

Parameters:

randomizedSigning - Whether to use randomized signing (true, default) or deterministic (false).

SettingsMLDSAAlgorithmParameterSpec

public SettingsMLDSAAlgorithmParameterSpec(byte[] context,
                                           boolean randomizedSigning)
                                    throws PQException

Creates a parameter spec with both the specified context and randomized signing setting.

Parameters:

context - The context to be used during signing, up to 255 bytes.

randomizedSigning - Whether to use randomized signing (true, default) or deterministic (false).

Throws:

PQException - If the context length exceeds 255 bytes or is null.

Method Detail

setContext

public void setContext(byte[] ctx)
                throws PQException

Sets the context for MLDSA operations. The context must be a non-null byte array with a maximum length of 255 bytes.

Parameters:

ctx - The context to set, up to 255 bytes.

Throws:

PQException - If the context is null or exceeds the maximum allowed length.

getContext

public byte[] getContext()

Retrieves the currently set context. Returns null if no context has been set.

Returns:

The current context or null if not set.

useRandomizedSigning

public void useRandomizedSigning(boolean randomizedSigning)

Configures whether signatures should be randomized (true, default) or deterministic (false).

Parameters:

randomizedSigning - Whether to use randomized signing.

isRandomizedSigning

public boolean isRandomizedSigning()

Checks if the current configuration uses randomized signing.

Returns:

true if randomized signing is enabled, false otherwise.