Class FrodoKeyGenSpec

java.lang.Object

zeroecho.core.alg.frodo.FrodoKeyGenSpec

All Implemented Interfaces:

Describable, AlgorithmKeySpec

public final class FrodoKeyGenSpec
extends Object
implements AlgorithmKeySpec, Describable

Key generation specification for FrodoKEM

FrodoKeyGenSpec defines the parameters required to generate a FrodoKEM key pair. It encapsulates the choice of Frodo variant, which determines security level, performance, and key sizes.

Variants

Each FrodoKeyGenSpec.Variant corresponds to a standardized FrodoKEM parameter set:

• FrodoKeyGenSpec.Variant.FRODO_640_AES - 128-bit security level using AES-based pseudorandomness.
• FrodoKeyGenSpec.Variant.FRODO_640_SHAKE - 128-bit security level using SHAKE instead of AES.
• FrodoKeyGenSpec.Variant.FRODO_976_AES - ~192-bit security level with AES-based pseudorandomness.
• FrodoKeyGenSpec.Variant.FRODO_976_SHAKE - ~192-bit security level with SHAKE.
• FrodoKeyGenSpec.Variant.FRODO_1344_AES - ~256-bit security level with AES-based pseudorandomness.
• FrodoKeyGenSpec.Variant.FRODO_1344_SHAKE - ~256-bit security level with SHAKE.

AES-based and SHAKE-based variants differ only in the pseudorandom generator used internally. Security levels are defined against both classical and quantum adversaries under the Learning With Errors (LWE) assumption.

Thread-safety

This class is immutable and therefore safe to share across threads.

Since:

1.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	FrodoKeyGenSpec.Variant	Enumerates the standardized FrodoKEM parameter sets.

Method Summary

Modifier and Type	Method	Description
String	description()	Human-readable description of this spec.
static FrodoKeyGenSpec	frodo1344aes()	Convenience factory for the FrodoKeyGenSpec.Variant.FRODO_1344_AES parameter set.
static FrodoKeyGenSpec	frodo1344shake()	Convenience factory for the FrodoKeyGenSpec.Variant.FRODO_1344_SHAKE parameter set.
static FrodoKeyGenSpec	frodo640aes()	Convenience factory for the FrodoKeyGenSpec.Variant.FRODO_640_AES parameter set.
static FrodoKeyGenSpec	frodo640shake()	Convenience factory for the FrodoKeyGenSpec.Variant.FRODO_640_SHAKE parameter set.
static FrodoKeyGenSpec	frodo976aes()	Convenience factory for the FrodoKeyGenSpec.Variant.FRODO_976_AES parameter set.
static FrodoKeyGenSpec	frodo976shake()	Convenience factory for the FrodoKeyGenSpec.Variant.FRODO_976_SHAKE parameter set.
static FrodoKeyGenSpec	of(FrodoKeyGenSpec.Variant v)	Creates a spec from a given variant.
FrodoKeyGenSpec.Variant	variant()	Returns the Frodo variant.

Methods inherited from class Object

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

Method Details

of

public static FrodoKeyGenSpec of(FrodoKeyGenSpec.Variant v)

Creates a spec from a given variant.

Parameters:

v - Frodo variant to select

Returns:

new key generation spec

frodo640aes

public static FrodoKeyGenSpec frodo640aes()

Convenience factory for the FrodoKeyGenSpec.Variant.FRODO_640_AES parameter set.

Returns:

spec targeting 128-bit security with AES PRG

frodo640shake

public static FrodoKeyGenSpec frodo640shake()

Convenience factory for the FrodoKeyGenSpec.Variant.FRODO_640_SHAKE parameter set.

Returns:

spec targeting 128-bit security with SHAKE PRG

frodo976aes

public static FrodoKeyGenSpec frodo976aes()

Convenience factory for the FrodoKeyGenSpec.Variant.FRODO_976_AES parameter set.

Returns:

spec targeting ~192-bit security with AES PRG

frodo976shake

public static FrodoKeyGenSpec frodo976shake()

Convenience factory for the FrodoKeyGenSpec.Variant.FRODO_976_SHAKE parameter set.

Returns:

spec targeting ~192-bit security with SHAKE PRG

frodo1344aes

public static FrodoKeyGenSpec frodo1344aes()

Convenience factory for the FrodoKeyGenSpec.Variant.FRODO_1344_AES parameter set.

Returns:

spec targeting ~256-bit security with AES PRG

frodo1344shake

public static FrodoKeyGenSpec frodo1344shake()

Convenience factory for the FrodoKeyGenSpec.Variant.FRODO_1344_SHAKE parameter set.

Returns:

spec targeting ~256-bit security with SHAKE PRG

variant

public FrodoKeyGenSpec.Variant variant()

Returns the Frodo variant.

Returns:

selected parameter set

description

public String description()

Human-readable description of this spec.

The value is simply the Enum.toString() of the chosen parameter set (e.g., "FRODO_640_AES").

Specified by:

description in interface Describable

Returns:

string description of the variant