iaik.security.pq.hqc

Class HQCKeyPairGeneratorSpi

java.lang.Object

java.security.KeyPairGeneratorSpi

iaik.security.pq.hqc.HQCKeyPairGeneratorSpi

public class HQCKeyPairGeneratorSpi
extends KeyPairGeneratorSpi

This class extends the KeyPairGenerator and serves as an interface for users to create KeyPairs for the HQC [0] Algorithm.

[0] Carlos Aguilar Melchor, Nicolas Aragon, Slim Bettaieb, Loïc Bidoux, Olivier Blazy, Jurjen Bos, Jean-Christophe Deneuville, Arnaud Dion, Philippe Gaborit, Jérôme Lacan, Edoardo Persichetti, Jean-Marc Robert, Pascal Véron and Gilles Zémor HQC (30.04.2023) – Submission to round 4 of the NIST post-quantum project.

Constructor Summary

Constructors

Constructor and Description
HQCKeyPairGeneratorSpi()

Method Summary

Modifier and Type	Method and Description
KeyPair	generateKeyPair() Generates a KeyPair consisting of a HQCPrivateKey and HQCPublicKey depending on the initialization of this object.
void	initialize(AlgorithmParameterSpec params, SecureRandom random) Initializes the key pair generator using the specified parameter set and source of randomness.
void	initialize(int securityLevel, SecureRandom random) Initializes the key pair generator using the specified NIST security level and source of randomness.

Methods inherited from class java.lang.Object

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

Constructor Detail

HQCKeyPairGeneratorSpi

public HQCKeyPairGeneratorSpi()

Method Detail

initialize

public void initialize(int securityLevel,
                       SecureRandom random)

Initializes the key pair generator using the specified NIST security level and source of randomness. If the security level is valid, the implementation defaults to the respective HQCParameterSpec. Furthermore, if source random is null, the implementation defaults to the SecureRandom implementation of the JCE Provider.

Specified by:

initialize in class KeyPairGeneratorSpi

Parameters:

securityLevel - the NIST security level, defining the parameter set, to generate the keys.

random - a source of random

Throws:

IllegalArgumentException - if the given security level is inappropriate for this key pair generator.

initialize

public void initialize(AlgorithmParameterSpec params,
                       SecureRandom random)
                throws InvalidAlgorithmParameterException

Initializes the key pair generator using the specified parameter set and source of randomness. If source of random is null, the implementation defaults to the SecureRandom implementation of the JCE Provider.

Overrides:

initialize in class KeyPairGeneratorSpi

Parameters:

params - the parameter set used to generate the keys.

random - a source of random

Throws:

InvalidAlgorithmParameterException - if the given this.params are inappropriate for this key pair generator.

generateKeyPair

public KeyPair generateKeyPair()

Generates a KeyPair consisting of a HQCPrivateKey and HQCPublicKey depending on the initialization of this object. If the KeyPairGenerator has not been initialized, the implementation defaults to SecurityLevel 3.

Specified by:

generateKeyPair in class KeyPairGeneratorSpi

Returns:

a KeyPair consisting of a HQCPublicKey and a HQCPrivateKey.