lc_dilithium.h File Reference

#include "ext_headers.h"

Include dependency graph for lc_dilithium.h:

Go to the source code of this file.

Data Structures
struct	lc_dilithium_sk
	Dilithium secret key. More...
struct	lc_dilithium_pk
	Dilithium public key. More...
struct	lc_dilithium_sig
	Dilithium signature. More...
struct	lc_dilithium_ed25519_sk
	Dilithium secret key. More...
struct	lc_dilithium_ed25519_pk
	Dilithium public key. More...
struct	lc_dilithium_ed25519_sig
	Dilithium signature. More...
struct	lc_dilithium_ed448_sk
	Dilithium secret key. More...
struct	lc_dilithium_ed448_pk
	Dilithium public key. More...
struct	lc_dilithium_ed448_sig
	Dilithium signature. More...
union	lc_dilithium_sk.key
union	lc_dilithium_pk.key
union	lc_dilithium_sig.sig
union	lc_dilithium_ed25519_sk.key
union	lc_dilithium_ed25519_pk.key
union	lc_dilithium_ed25519_sig.sig
union	lc_dilithium_ed448_sk.key
union	lc_dilithium_ed448_pk.key
union	lc_dilithium_ed448_sig.sig

Enumerations
enum	lc_dilithium_type { LC_DILITHIUM_UNKNOWN , LC_DILITHIUM_87 , LC_DILITHIUM_65 , LC_DILITHIUM_44 }

Functions
int	lc_dilithium_ctx_alloc (struct lc_dilithium_ctx **ctx)
	Allocate stack memory for the Dilithium stream context and additional parameter relevant for the signature operation.
int	lc_dilithium_ctx_alloc_ahat (struct lc_dilithium_ctx **ctx)
	Allocates Dilithium context on heap with support to keep the internal representation of the key.
void	lc_dilithium_ctx_zero_free (struct lc_dilithium_ctx *ctx)
	Zeroizes and frees Dilithium context on heap.
void	lc_dilithium_ctx_zero (struct lc_dilithium_ctx *ctx)
	Zeroizes Dilithium context either on heap or on stack.
void	lc_dilithium_ctx_internal (struct lc_dilithium_ctx *ctx)
	Mark the Dilithium context to execute ML-DSA.Sign_internal / ML-DSA.Verify_internal.
void	lc_dilithium_ctx_hash (struct lc_dilithium_ctx *ctx, const struct lc_hash *hash)
	Set the hash type that was used for pre-hashing the message. The message digest is used with the HashML-DSA. The message digest is to be provided via the message pointer in the sign/verify APIs.
void	lc_dilithium_ctx_userctx (struct lc_dilithium_ctx *ctx, const uint8_t *userctx, size_t userctxlen)
	Specify the optional user context string to be applied with the Dilithium signature operation.
void	lc_dilithium_ctx_external_mu (struct lc_dilithium_ctx *ctx, const uint8_t *external_mu, size_t external_mu_len)
	Specify the optional external mu value.
void	lc_dilithium_ctx_drop_ahat (struct lc_dilithium_ctx *ctx)
	Invalidate the expanded key that potentially is stored in the context.
enum lc_dilithium_type	lc_dilithium_sk_type (const struct lc_dilithium_sk *sk)
	Obtain Dilithium type from secret key.
enum lc_dilithium_type	lc_dilithium_pk_type (const struct lc_dilithium_pk *pk)
	Obtain Dilithium type from public key.
enum lc_dilithium_type	lc_dilithium_sig_type (const struct lc_dilithium_sig *sig)
	Obtain Dilithium type from signature.
LC_PURE unsigned int	lc_dilithium_sk_size (enum lc_dilithium_type dilithium_type)
	Return the size of the Dilithium secret key.
LC_PURE unsigned int	lc_dilithium_pk_size (enum lc_dilithium_type dilithium_type)
	Return the size of the Dilithium public key.
LC_PURE unsigned int	lc_dilithium_sig_size (enum lc_dilithium_type dilithium_type)
	Return the size of the Dilithium signature.
int	lc_dilithium_sk_load (struct lc_dilithium_sk *sk, const uint8_t *src_key, size_t src_key_len)
	Load a Dilithium secret key provided with a buffer into the leancrypto data structure.
int	lc_dilithium_pk_load (struct lc_dilithium_pk *pk, const uint8_t *src_key, size_t src_key_len)
	Load a Dilithium public key provided with a buffer into the leancrypto data structure.
int	lc_dilithium_sig_load (struct lc_dilithium_sig *sig, const uint8_t *src_sig, size_t src_sig_len)
	Load a Dilithium signature provided with a buffer into the leancrypto data structure.
int	lc_dilithium_sk_ptr (uint8_t **dilithium_key, size_t *dilithium_key_len, struct lc_dilithium_sk *sk)
	Obtain the reference to the Dilithium key and its length.
int	lc_dilithium_pk_ptr (uint8_t **dilithium_key, size_t *dilithium_key_len, struct lc_dilithium_pk *pk)
	Obtain the reference to the Dilithium key and its length.
int	lc_dilithium_sig_ptr (uint8_t **dilithium_sig, size_t *dilithium_sig_len, struct lc_dilithium_sig *sig)
	Obtain the reference to the Dilithium signature and its length.
int	lc_dilithium_keypair (struct lc_dilithium_pk *pk, struct lc_dilithium_sk *sk, struct lc_rng_ctx *rng_ctx, enum lc_dilithium_type dilithium_type)
	Generates Dilithium public and private key.
int	lc_dilithium_keypair_from_seed (struct lc_dilithium_pk *pk, struct lc_dilithium_sk *sk, const uint8_t *seed, size_t seedlen, enum lc_dilithium_type dilithium_type)
	Generates Dilithium public and private key from a given seed.
int	lc_dilithium_pct (const struct lc_dilithium_pk *pk, const struct lc_dilithium_sk *sk)
	Pairwise consistency check as per FIPS 140 IG.
int	lc_dilithium_sign (struct lc_dilithium_sig *sig, const uint8_t *m, size_t mlen, const struct lc_dilithium_sk *sk, struct lc_rng_ctx *rng_ctx)
	Computes signature in one shot.
int	lc_dilithium_sign_ctx (struct lc_dilithium_sig *sig, struct lc_dilithium_ctx *ctx, const uint8_t *m, size_t mlen, const struct lc_dilithium_sk *sk, struct lc_rng_ctx *rng_ctx)
	Computes signature woth user context in one shot.
int	lc_dilithium_sign_init (struct lc_dilithium_ctx *ctx, const struct lc_dilithium_sk *sk)
	Initializes a signature operation.
int	lc_dilithium_sign_update (struct lc_dilithium_ctx *ctx, const uint8_t *m, size_t mlen)
	Add more data to an already initialized signature state.
int	lc_dilithium_sign_final (struct lc_dilithium_sig *sig, struct lc_dilithium_ctx *ctx, const struct lc_dilithium_sk *sk, struct lc_rng_ctx *rng_ctx)
	Computes signature.
int	lc_dilithium_verify (const struct lc_dilithium_sig *sig, const uint8_t *m, size_t mlen, const struct lc_dilithium_pk *pk)
	Verifies signature in one shot.
int	lc_dilithium_verify_ctx (const struct lc_dilithium_sig *sig, struct lc_dilithium_ctx *ctx, const uint8_t *m, size_t mlen, const struct lc_dilithium_pk *pk)
	Verifies signature with Dilithium context in one shot.
int	lc_dilithium_verify_init (struct lc_dilithium_ctx *ctx, const struct lc_dilithium_pk *pk)
	Initializes a signature verification operation.
int	lc_dilithium_verify_update (struct lc_dilithium_ctx *ctx, const uint8_t *m, size_t mlen)
	Add more data to an already initialized signature state.
int	lc_dilithium_verify_final (const struct lc_dilithium_sig *sig, struct lc_dilithium_ctx *ctx, const struct lc_dilithium_pk *pk)
	Verifies signature.
int	lc_dilithium_ed25519_ctx_alloc (struct lc_dilithium_ed25519_ctx **ctx)
	Allocates Dilithium-ED25519 context on heap.
void	lc_dilithium_ed25519_ctx_zero_free (struct lc_dilithium_ed25519_ctx *ctx)
	Zeroizes and frees Dilithium-ED25519 context on heap.
void	lc_dilithium_ed25519_ctx_zero (struct lc_dilithium_ed25519_ctx *ctx)
	Zeroizes Dilithium-ED25519 context either on heap or on stack.
void	lc_dilithium_ed25519_ctx_hash (struct lc_dilithium_ed25519_ctx *ctx, const struct lc_hash *hash)
	Set the hash type that was used for pre-hashing the message. The message digest ist used with the HashML-DSA. The message digest is to be provided via the message pointer in the sign/verify APIs.
void	lc_dilithium_ed25519_ctx_internal (struct lc_dilithium_ed25519_ctx *ctx)
	Mark the Dilithium context to execute ML-DSA.Sign_internal / ML-DSA.Verify_internal.
void	lc_dilithium_ed25519_ctx_userctx (struct lc_dilithium_ed25519_ctx *ctx, const uint8_t *userctx, size_t userctxlen)
	Specify the optional user context string to be applied with the Dilithium-ED25519 signature operation.
void	lc_dilithium_ed25519_ctx_randomizer (struct lc_dilithium_ed25519_ctx *ctx, const uint8_t *randomizer, size_t randomizerlen)
	Specify the optional randomizer to be applied with the Dilithium-ED25519 signature operation.
enum lc_dilithium_type	lc_dilithium_ed25519_sk_type (const struct lc_dilithium_ed25519_sk *sk)
	Obtain Dilithium type from secret key.
enum lc_dilithium_type	lc_dilithium_ed25519_pk_type (const struct lc_dilithium_ed25519_pk *pk)
	Obtain Dilithium type from public key.
enum lc_dilithium_type	lc_dilithium_ed25519_sig_type (const struct lc_dilithium_ed25519_sig *sig)
	Obtain Dilithium type from signature.
LC_PURE unsigned int	lc_dilithium_ed25519_sk_size (enum lc_dilithium_type dilithium_type)
	Return the size of the Dilithium secret key.
LC_PURE unsigned int	lc_dilithium_ed25519_pk_size (enum lc_dilithium_type dilithium_type)
	Return the size of the Dilithium public key.
LC_PURE unsigned int	lc_dilithium_ed25519_sig_size (enum lc_dilithium_type dilithium_type)
	Return the size of the Dilithium signature.
int	lc_dilithium_ed25519_sk_load (struct lc_dilithium_ed25519_sk *sk, const uint8_t *dilithium_src_key, size_t dilithium_src_key_len, const uint8_t *ed25519_src_key, size_t ed25519_src_key_len)
	Load a Dilithium secret key provided with a buffer into the leancrypto data structure.
int	lc_dilithium_ed25519_pk_load (struct lc_dilithium_ed25519_pk *pk, const uint8_t *dilithium_src_key, size_t dilithium_src_key_len, const uint8_t *ed25519_src_key, size_t ed25519_src_key_len)
	Load a Dilithium public key provided with a buffer into the leancrypto data structure.
int	lc_dilithium_ed25519_sig_load (struct lc_dilithium_ed25519_sig *sig, const uint8_t *dilithium_src_sig, size_t dilithium_src_sig_len, const uint8_t *ed25519_src_sig, size_t ed25519_src_sig_len)
	Load a Dilithium signature provided with a buffer into the leancrypto data structure.
int	lc_dilithium_ed25519_sk_ptr (uint8_t **dilithium_key, size_t *dilithium_key_len, uint8_t **ed25519_key, size_t *ed25519_key_len, struct lc_dilithium_ed25519_sk *sk)
	Obtain the reference to the Dilithium key and its length.
int	lc_dilithium_ed25519_pk_ptr (uint8_t **dilithium_key, size_t *dilithium_key_len, uint8_t **ed25519_key, size_t *ed25519_key_len, struct lc_dilithium_ed25519_pk *pk)
	Obtain the reference to the Dilithium key and its length.
int	lc_dilithium_ed25519_sig_ptr (uint8_t **dilithium_sig, size_t *dilithium_sig_len, uint8_t **ed25519_sig, size_t *ed25519_sig_len, struct lc_dilithium_ed25519_sig *sig)
	Obtain the reference to the Dilithium signature and its length.
int	lc_dilithium_ed25519_keypair (struct lc_dilithium_ed25519_pk *pk, struct lc_dilithium_ed25519_sk *sk, struct lc_rng_ctx *rng_ctx, enum lc_dilithium_type dilithium_type)
	Generates Dilithium public and private key.
int	lc_dilithium_ed25519_sign (struct lc_dilithium_ed25519_sig *sig, const uint8_t *m, size_t mlen, const struct lc_dilithium_ed25519_sk *sk, struct lc_rng_ctx *rng_ctx)
	Computes signature in one shot.
int	lc_dilithium_ed25519_sign_ctx (struct lc_dilithium_ed25519_sig *sig, struct lc_dilithium_ed25519_ctx *ctx, const uint8_t *m, size_t mlen, const struct lc_dilithium_ed25519_sk *sk, struct lc_rng_ctx *rng_ctx)
	Computes signature with Dilithium context in one shot.
int	lc_dilithium_ed25519_sign_init (struct lc_dilithium_ed25519_ctx *ctx, const struct lc_dilithium_ed25519_sk *sk)
	Initializes signature operation in stream mode.
int	lc_dilithium_ed25519_sign_update (struct lc_dilithium_ed25519_ctx *ctx, const uint8_t *m, size_t mlen)
	Updates signature in stream mode.
int	lc_dilithium_ed25519_sign_final (struct lc_dilithium_ed25519_sig *sig, struct lc_dilithium_ed25519_ctx *ctx, const struct lc_dilithium_ed25519_sk *sk, struct lc_rng_ctx *rng_ctx)
	Computes signature in stream mode.
int	lc_dilithium_ed25519_verify (const struct lc_dilithium_ed25519_sig *sig, const uint8_t *m, size_t mlen, const struct lc_dilithium_ed25519_pk *pk)
	Verifies signature in one shot.
int	lc_dilithium_ed25519_verify_ctx (const struct lc_dilithium_ed25519_sig *sig, struct lc_dilithium_ed25519_ctx *ctx, const uint8_t *m, size_t mlen, const struct lc_dilithium_ed25519_pk *pk)
	Verifies signature with Dilithium context in one shot.
int	lc_dilithium_ed25519_verify_init (struct lc_dilithium_ed25519_ctx *ctx, const struct lc_dilithium_ed25519_pk *pk)
	Initializes signature verification operation in stream mode.
int	lc_dilithium_ed25519_verify_update (struct lc_dilithium_ed25519_ctx *ctx, const uint8_t *m, size_t mlen)
	Updates signature verification in stream mode.
int	lc_dilithium_ed25519_verify_final (const struct lc_dilithium_ed25519_sig *sig, struct lc_dilithium_ed25519_ctx *ctx, const struct lc_dilithium_ed25519_pk *pk)
	Verifies signature in stream mode.
int	lc_dilithium_ed448_ctx_alloc (struct lc_dilithium_ed448_ctx **ctx)
	Allocates Dilithium-ED448 context on heap.
void	lc_dilithium_ed448_ctx_zero_free (struct lc_dilithium_ed448_ctx *ctx)
	Zeroizes and frees Dilithium-ED448 context on heap.
void	lc_dilithium_ed448_ctx_zero (struct lc_dilithium_ed448_ctx *ctx)
	Zeroizes Dilithium-ED448 context either on heap or on stack.
void	lc_dilithium_ed448_ctx_hash (struct lc_dilithium_ed448_ctx *ctx, const struct lc_hash *hash)
	Set the hash type that was used for pre-hashing the message. The message digest ist used with the HashML-DSA. The message digest is to be provided via the message pointer in the sign/verify APIs.
void	lc_dilithium_ed448_ctx_internal (struct lc_dilithium_ed448_ctx *ctx)
	Mark the Dilithium context to execute ML-DSA.Sign_internal / ML-DSA.Verify_internal.
void	lc_dilithium_ed448_ctx_userctx (struct lc_dilithium_ed448_ctx *ctx, const uint8_t *userctx, size_t userctxlen)
	Specify the optional user context string to be applied with the Dilithium-ED448 signature operation.
void	lc_dilithium_ed448_ctx_randomizer (struct lc_dilithium_ed448_ctx *ctx, const uint8_t *randomizer, size_t randomizerlen)
	Specify the optional randomizer to be applied with the Dilithium-ED25519 signature operation.
enum lc_dilithium_type	lc_dilithium_ed448_sk_type (const struct lc_dilithium_ed448_sk *sk)
	Obtain Dilithium type from secret key.
enum lc_dilithium_type	lc_dilithium_ed448_pk_type (const struct lc_dilithium_ed448_pk *pk)
	Obtain Dilithium type from public key.
enum lc_dilithium_type	lc_dilithium_ed448_sig_type (const struct lc_dilithium_ed448_sig *sig)
	Obtain Dilithium type from signature.
LC_PURE unsigned int	lc_dilithium_ed448_sk_size (enum lc_dilithium_type dilithium_type)
	Return the size of the Dilithium secret key.
LC_PURE unsigned int	lc_dilithium_ed448_pk_size (enum lc_dilithium_type dilithium_type)
	Return the size of the Dilithium public key.
LC_PURE unsigned int	lc_dilithium_ed448_sig_size (enum lc_dilithium_type dilithium_type)
	Return the size of the Dilithium signature.
int	lc_dilithium_ed448_sk_load (struct lc_dilithium_ed448_sk *sk, const uint8_t *dilithium_src_key, size_t dilithium_src_key_len, const uint8_t *ed448_src_key, size_t ed448_src_key_len)
	Load a Dilithium secret key provided with a buffer into the leancrypto data structure.
int	lc_dilithium_ed448_pk_load (struct lc_dilithium_ed448_pk *pk, const uint8_t *dilithium_src_key, size_t dilithium_src_key_len, const uint8_t *ed448_src_key, size_t ed448_src_key_len)
	Load a Dilithium public key provided with a buffer into the leancrypto data structure.
int	lc_dilithium_ed448_sig_load (struct lc_dilithium_ed448_sig *sig, const uint8_t *dilithium_src_sig, size_t dilithium_src_sig_len, const uint8_t *ed448_src_sig, size_t ed448_src_sig_len)
	Load a Dilithium signature provided with a buffer into the leancrypto data structure.
int	lc_dilithium_ed448_sk_ptr (uint8_t **dilithium_key, size_t *dilithium_key_len, uint8_t **ed448_key, size_t *ed448_key_len, struct lc_dilithium_ed448_sk *sk)
	Obtain the reference to the Dilithium key and its length.
int	lc_dilithium_ed448_pk_ptr (uint8_t **dilithium_key, size_t *dilithium_key_len, uint8_t **ed448_key, size_t *ed448_key_len, struct lc_dilithium_ed448_pk *pk)
	Obtain the reference to the Dilithium key and its length.
int	lc_dilithium_ed448_sig_ptr (uint8_t **dilithium_sig, size_t *dilithium_sig_len, uint8_t **ed448_sig, size_t *ed448_sig_len, struct lc_dilithium_ed448_sig *sig)
	Obtain the reference to the Dilithium signature and its length.
int	lc_dilithium_ed448_keypair (struct lc_dilithium_ed448_pk *pk, struct lc_dilithium_ed448_sk *sk, struct lc_rng_ctx *rng_ctx, enum lc_dilithium_type dilithium_type)
	Generates Dilithium public and private key.
int	lc_dilithium_ed448_sign (struct lc_dilithium_ed448_sig *sig, const uint8_t *m, size_t mlen, const struct lc_dilithium_ed448_sk *sk, struct lc_rng_ctx *rng_ctx)
	Computes signature in one shot.
int	lc_dilithium_ed448_sign_ctx (struct lc_dilithium_ed448_sig *sig, struct lc_dilithium_ed448_ctx *ctx, const uint8_t *m, size_t mlen, const struct lc_dilithium_ed448_sk *sk, struct lc_rng_ctx *rng_ctx)
	Computes signature with Dilithium context in one shot.
int	lc_dilithium_ed448_sign_init (struct lc_dilithium_ed448_ctx *ctx, const struct lc_dilithium_ed448_sk *sk)
	Initializes signature operation in stream mode.
int	lc_dilithium_ed448_sign_update (struct lc_dilithium_ed448_ctx *ctx, const uint8_t *m, size_t mlen)
	Updates signature in stream mode.
int	lc_dilithium_ed448_sign_final (struct lc_dilithium_ed448_sig *sig, struct lc_dilithium_ed448_ctx *ctx, const struct lc_dilithium_ed448_sk *sk, struct lc_rng_ctx *rng_ctx)
	Computes signature in stream mode.
int	lc_dilithium_ed448_verify (const struct lc_dilithium_ed448_sig *sig, const uint8_t *m, size_t mlen, const struct lc_dilithium_ed448_pk *pk)
	Verifies signature in one shot.
int	lc_dilithium_ed448_verify_ctx (const struct lc_dilithium_ed448_sig *sig, struct lc_dilithium_ed448_ctx *ctx, const uint8_t *m, size_t mlen, const struct lc_dilithium_ed448_pk *pk)
	Verifies signature with Dilithium context in one shot.
int	lc_dilithium_ed448_verify_init (struct lc_dilithium_ed448_ctx *ctx, const struct lc_dilithium_ed448_pk *pk)
	Initializes signature verification operation in stream mode.
int	lc_dilithium_ed448_verify_update (struct lc_dilithium_ed448_ctx *ctx, const uint8_t *m, size_t mlen)
	Updates signature verification in stream mode.
int	lc_dilithium_ed448_verify_final (const struct lc_dilithium_ed448_sig *sig, struct lc_dilithium_ed448_ctx *ctx, const struct lc_dilithium_ed448_pk *pk)
	Verifies signature in stream mode.

---

Data Structure Documentation

lc_dilithium_sk

struct lc_dilithium_sk

Dilithium secret key.

Definition at line 106 of file lc_dilithium.h.

Data Fields
enum lc_dilithium_type	dilithium_type
union lc_dilithium_sk.key	key

lc_dilithium_pk

struct lc_dilithium_pk

Dilithium public key.

Definition at line 124 of file lc_dilithium.h.

Data Fields
enum lc_dilithium_type	dilithium_type
union lc_dilithium_pk.key	key

lc_dilithium_sig

struct lc_dilithium_sig

Dilithium signature.

Definition at line 142 of file lc_dilithium.h.

Data Fields
enum lc_dilithium_type	dilithium_type
union lc_dilithium_sig.sig	sig

lc_dilithium_ed25519_sk

struct lc_dilithium_ed25519_sk

Dilithium secret key.

Definition at line 746 of file lc_dilithium.h.

Data Fields
enum lc_dilithium_type	dilithium_type
union lc_dilithium_ed25519_sk.key	key

lc_dilithium_ed25519_pk

struct lc_dilithium_ed25519_pk

Dilithium public key.

Definition at line 764 of file lc_dilithium.h.

Data Fields
enum lc_dilithium_type	dilithium_type
union lc_dilithium_ed25519_pk.key	key

lc_dilithium_ed25519_sig

struct lc_dilithium_ed25519_sig

Dilithium signature.

Definition at line 782 of file lc_dilithium.h.

Data Fields
enum lc_dilithium_type	dilithium_type
union lc_dilithium_ed25519_sig.sig	sig

lc_dilithium_ed448_sk

struct lc_dilithium_ed448_sk

Dilithium secret key.

Definition at line 1314 of file lc_dilithium.h.

Data Fields
enum lc_dilithium_type	dilithium_type
union lc_dilithium_ed448_sk.key	key

lc_dilithium_ed448_pk

struct lc_dilithium_ed448_pk

Dilithium public key.

Definition at line 1332 of file lc_dilithium.h.

Data Fields
enum lc_dilithium_type	dilithium_type
union lc_dilithium_ed448_pk.key	key

lc_dilithium_ed448_sig

struct lc_dilithium_ed448_sig

Dilithium signature.

Definition at line 1350 of file lc_dilithium.h.

Data Fields
enum lc_dilithium_type	dilithium_type
union lc_dilithium_ed448_sig.sig	sig

lc_dilithium_sk.key

union lc_dilithium_sk.key

Definition at line 108 of file lc_dilithium.h.

lc_dilithium_pk.key

union lc_dilithium_pk.key

Definition at line 126 of file lc_dilithium.h.

lc_dilithium_sig.sig

union lc_dilithium_sig.sig

Definition at line 144 of file lc_dilithium.h.

lc_dilithium_ed25519_sk.key

union lc_dilithium_ed25519_sk.key

Definition at line 748 of file lc_dilithium.h.

lc_dilithium_ed25519_pk.key

union lc_dilithium_ed25519_pk.key

Definition at line 766 of file lc_dilithium.h.

lc_dilithium_ed25519_sig.sig

union lc_dilithium_ed25519_sig.sig

Definition at line 784 of file lc_dilithium.h.

lc_dilithium_ed448_sk.key

union lc_dilithium_ed448_sk.key

Definition at line 1316 of file lc_dilithium.h.

lc_dilithium_ed448_pk.key

union lc_dilithium_ed448_pk.key

Definition at line 1334 of file lc_dilithium.h.

lc_dilithium_ed448_sig.sig

union lc_dilithium_ed448_sig.sig

Definition at line 1352 of file lc_dilithium.h.

Enumeration Type Documentation

lc_dilithium_type

enum lc_dilithium_type

Enumerator
LC_DILITHIUM_UNKNOWN	Unknown key type
LC_DILITHIUM_87	Dilithium 87
LC_DILITHIUM_65	Dilithium 65
LC_DILITHIUM_44	Dilithium 44

Definition at line 58 of file lc_dilithium.h.

Function Documentation

lc_dilithium_pct()

int lc_dilithium_pct	(	const struct lc_dilithium_pk *	pk,
		const struct lc_dilithium_sk *	sk )

Pairwise consistency check as per FIPS 140 IG.

This call should be invoked after generating a key pair in FIPS mode

Parameters

[in]	pk	Public key
[in]	sk	Secret key

Returns

0 on success, < 0 on error