ecdh.c File Reference

ECDH (Elliptic Curve Diffie-Hellman) key exchange. More...

#include "core/crypto.h"
#include "ecc/ecdh.h"
#include "ecc/ec_misc.h"
#include "debug.h"

Go to the source code of this file.

Macros
#define	TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Functions
void	ecdhInit (EcdhContext *context)
	Initialize ECDH context. More...
void	ecdhFree (EcdhContext *context)
	Release ECDH context. More...
error_t	ecdhSetCurve (EcdhContext *context, const EcCurve *curve)
	Specify the elliptic curve to use. More...
error_t	ecdhGenerateKeyPair (EcdhContext *context, const PrngAlgo *prngAlgo, void *prngContext)
	ECDH key pair generation. More...
error_t	ecdhExportPublicKey (EcdhContext *context, uint8_t *output, size_t *written, EcPublicKeyFormat format)
	Export our own public key. More...
error_t	ecdhImportPeerPublicKey (EcdhContext *context, const uint8_t *input, size_t length, EcPublicKeyFormat format)
	Import peer's public key. More...
error_t	ecdhCheckPublicKey (EcdhContext *context, const EcPublicKey *publicKey)
	Check public key. More...
error_t	ecdhComputeSharedSecret (EcdhContext *context, uint8_t *output, size_t outputSize, size_t *outputLen)
	Compute ECDH shared secret. More...

Detailed Description

ECDH (Elliptic Curve Diffie-Hellman) key exchange.

License

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

Copyright (C) 2010-2025 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.5.4

Definition in file ecdh.c.

Macro Definition Documentation

TRACE_LEVEL

#define TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Definition at line 32 of file ecdh.c.

Function Documentation

ecdhCheckPublicKey()

error_t ecdhCheckPublicKey	(	EcdhContext *	context,
		const EcPublicKey *	publicKey
	)

Check public key.

Parameters

[in]	context	Pointer to the ECDH context
[in]	publicKey	Public key to be checked

Returns

Error code

Definition at line 301 of file ecdh.c.

ecdhComputeSharedSecret()

error_t ecdhComputeSharedSecret	(	EcdhContext *	context,
		uint8_t *	output,
		size_t	outputSize,
		size_t *	outputLen
	)

Compute ECDH shared secret.

Parameters

[in]	context	Pointer to the ECDH context
[out]	output	Buffer where to store the shared secret
[in]	outputSize	Size of the buffer in bytes
[out]	outputLen	Length of the resulting shared secret

Returns

Error code

Definition at line 415 of file ecdh.c.

ecdhExportPublicKey()

error_t ecdhExportPublicKey	(	EcdhContext *	context,
		uint8_t *	output,
		size_t *	written,
		EcPublicKeyFormat	format
	)

Export our own public key.

Parameters

[in]	context	Pointer to the ECDH context
[out]	output	Pointer to the octet string
[out]	written	Length of the octet string, in bytes
[in]	format	EC public key format (X9.63 or raw format)

Returns

Error code

Definition at line 257 of file ecdh.c.

ecdhFree()

void ecdhFree

(

EcdhContext *

context

)

Release ECDH context.

Parameters

[in]

context

Pointer to the ECDH context

Definition at line 65 of file ecdh.c.

ecdhGenerateKeyPair()

error_t ecdhGenerateKeyPair	(	EcdhContext *	context,
		const PrngAlgo *	prngAlgo,
		void *	prngContext
	)

ECDH key pair generation.

Parameters

[in]	context	Pointer to the ECDH context
[in]	prngAlgo	PRNG algorithm
[in]	prngContext	Pointer to the PRNG context

Returns

Error code

Definition at line 115 of file ecdh.c.

ecdhImportPeerPublicKey()

error_t ecdhImportPeerPublicKey	(	EcdhContext *	context,
		const uint8_t *	input,
		size_t	length,
		EcPublicKeyFormat	format
	)

Import peer's public key.

Parameters

[in]	context	Pointer to the ECDH context
[in]	input	Pointer to the octet string
[in]	length	Length of the octet string, in bytes
[in]	format	EC public key format (X9.63 or raw format)

Returns

Error code

Definition at line 274 of file ecdh.c.

ecdhInit()

void ecdhInit

(

EcdhContext *

context

)

Initialize ECDH context.

Parameters

[in]

context

Pointer to the ECDH context

Definition at line 49 of file ecdh.c.

ecdhSetCurve()

error_t ecdhSetCurve	(	EcdhContext *	context,
		const EcCurve *	curve
	)

Specify the elliptic curve to use.

Parameters

[in]	context	Pointer to the ECDH context
[in]	curve	Elliptic curve parameters

Returns

Error code

Definition at line 83 of file ecdh.c.