mlkem768.c File Reference

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

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

Go to the source code of this file.

Macros
#define	TRACE_LEVEL   CRYPTO_TRACE_LEVEL

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

Variables
const KemAlgo	mlkem768KemAlgo

Detailed Description

ML-KEM-768 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 mlkem768.c.

Macro Definition Documentation

TRACE_LEVEL

#define TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Definition at line 32 of file mlkem768.c.

Function Documentation

mlkem768Decapsulate()

error_t mlkem768Decapsulate	(	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 mlkem768.c.

mlkem768Encapsulate()

error_t mlkem768Encapsulate	(	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 mlkem768.c.

mlkem768GenerateKeyPair()

error_t mlkem768GenerateKeyPair	(	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 mlkem768.c.

Variable Documentation

mlkem768KemAlgo

const KemAlgo mlkem768KemAlgo

Initial value:

=
{
   "ML-KEM-768",
   MLKEM768_PUBLIC_KEY_LEN,
   MLKEM768_SECRET_KEY_LEN,
   MLKEM768_CIPHERTEXT_LEN,
   MLKEM768_SHARED_SECRET_LEN,
   (KemAlgoGenerateKeyPair) mlkem768GenerateKeyPair,
   (KemAlgoEncapsulate) mlkem768Encapsulate,
   (KemAlgoDecapsulate) mlkem768Decapsulate
}

Definition at line 45 of file mlkem768.c.