mlkem1024.c File Reference

ML-KEM-1024 key encapsulation mechanism. More...

#include "core/crypto.h"
#include "pqc/mlkem1024.h"
#include <oqs/oqs.h>

Go to the source code of this file.

Macros
#define	TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Functions
error_t	mlkem1024GenerateKeyPair (const PrngAlgo *prngAlgo, void *prngContext, uint8_t *pk, uint8_t *sk)
	Key pair generation. More...
error_t	mlkem1024Encapsulate (const PrngAlgo *prngAlgo, void *prngContext, uint8_t *ct, uint8_t *ss, const uint8_t *pk)
	Encapsulation algorithm. More...
error_t	mlkem1024Decapsulate (uint8_t *ss, const uint8_t *ct, const uint8_t *sk)
	Decapsulation algorithm. More...

Variables
const KemAlgo	mlkem1024KemAlgo

Detailed Description

ML-KEM-1024 key encapsulation mechanism.

License

SPDX-License-Identifier: GPL-2.0-or-later

Copyright (C) 2010-2024 Oryx Embedded SARL. All rights reserved.

This file is part of CycloneCRYPTO Open.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Author

Oryx Embedded SARL (www.oryx-embedded.com)

Version

2.4.4

Definition in file mlkem1024.c.

Macro Definition Documentation

TRACE_LEVEL

#define TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Definition at line 32 of file mlkem1024.c.

Function Documentation

mlkem1024Decapsulate()

error_t mlkem1024Decapsulate	(	uint8_t *	ss,
		const uint8_t *	ct,
		const uint8_t *	sk
	)

Decapsulation algorithm.

Parameters

[out]	ss	Shared secret
[in]	ct	Ciphertext
[in]	sk	Secret key

Returns

Error code

Definition at line 111 of file mlkem1024.c.

mlkem1024Encapsulate()

error_t mlkem1024Encapsulate	(	const PrngAlgo *	prngAlgo,
		void *	prngContext,
		uint8_t *	ct,
		uint8_t *	ss,
		const uint8_t *	pk
	)

Encapsulation algorithm.

Parameters

[in]	prngAlgo	PRNG algorithm
[in]	prngContext	Pointer to the PRNG context
[out]	ct	Ciphertext
[out]	ss	Shared secret
[in]	pk	Public key

Returns

Error code

Definition at line 90 of file mlkem1024.c.

mlkem1024GenerateKeyPair()

error_t mlkem1024GenerateKeyPair	(	const PrngAlgo *	prngAlgo,
		void *	prngContext,
		uint8_t *	pk,
		uint8_t *	sk
	)

Key pair generation.

Parameters

[in]	prngAlgo	PRNG algorithm
[in]	prngContext	Pointer to the PRNG context
[out]	pk	Public key
[out]	sk	Secret key

Returns

Error code

Definition at line 67 of file mlkem1024.c.

Variable Documentation

mlkem1024KemAlgo

const KemAlgo mlkem1024KemAlgo

Initial value:

=
{
   "ML-KEM-1024",
   MLKEM1024_PUBLIC_KEY_LEN,
   MLKEM1024_SECRET_KEY_LEN,
   MLKEM1024_CIPHERTEXT_LEN,
   MLKEM1024_SHARED_SECRET_LEN,
   (KemAlgoGenerateKeyPair) mlkem1024GenerateKeyPair,
   (KemAlgoEncapsulate) mlkem1024Encapsulate,
   (KemAlgoDecapsulate) mlkem1024Decapsulate
}

Definition at line 45 of file mlkem1024.c.