This file contains the CRYS APIs used for EC EDW (Edwards) ed25519 algorithms. More...

Macros
#define	CRYS_ECEDW_MOD_SIZE_IN_BITS 255U

#define	CRYS_ECEDW_ORD_SIZE_IN_BITS 255U

#define	CRYS_ECEDW_MOD_SIZE_IN_32BIT_WORDS ((CRYS_ECEDW_MOD_SIZE_IN_BITS + SASI_BITS_IN_32BIT_WORD - 1) / SASI_BITS_IN_32BIT_WORD)

#define	CRYS_ECEDW_MOD_SIZE_IN_BYTES (CRYS_ECEDW_MOD_SIZE_IN_32BIT_WORDS * SASI_32BIT_WORD_SIZE)

#define	CRYS_ECEDW_ORD_SIZE_IN_32BIT_WORDS ((CRYS_ECEDW_ORD_SIZE_IN_BITS + SASI_BITS_IN_32BIT_WORD - 1) / SASI_BITS_IN_32BIT_WORD)

#define	CRYS_ECEDW_ORD_SIZE_IN_BYTES (CRYS_ECEDW_ORD_SIZE_IN_32BIT_WORDS * SASI_32BIT_WORD_SIZE)

#define	CRYS_ECEDW_SEED_BYTES CRYS_ECEDW_MOD_SIZE_IN_BYTES

#define	CRYS_ECEDW_SECRET_KEY_BYTES (2 * CRYS_ECEDW_MOD_SIZE_IN_BYTES)

#define	CRYS_ECEDW_SIGNATURE_BYTES (2 * CRYS_ECEDW_ORD_SIZE_IN_BYTES)

#define	CRYS_ECEDW_SCALAR_BYTES CRYS_ECEDW_ORD_SIZE_IN_BYTES

#define	CRYS_ECEDW_SCALARMULT_BYTES CRYS_ECEDW_MOD_SIZE_IN_BYTES

#define	CRYS_ECEDW_TEMP_BUFF_SIZE_IN_32BIT_WORD

Functions
CRYSError_t	CRYS_ECEDW_Sign (uint8_t pSign, size_t pSignSize, const uint8_t pMsg, size_t msgSize, const uint8_t pSignSecrKey, size_t secrKeySize, CRYS_ECEDW_TempBuff_t *pTempBuff)
	The function creates EC Edwards signature on the message. More...

CRYSError_t	CRYS_ECEDW_Verify (const uint8_t pSign, size_t signSize, const uint8_t pSignPublKey, size_t publKeySize, uint8_t pMsg, size_t msgSize, CRYS_ECEDW_TempBuff_t pTempBuff)
	The function verifies the EC Edwards ed25519 signature on the message. More...

CRYSError_t	CRYS_ECEDW_SeedKeyPair (const uint8_t pSeed, size_t seedSize, uint8_t pSecrKey, size_t pSecrKeySize, uint8_t pPublKey, size_t pPublKeySize, CRYS_ECEDW_TempBuff_t pTempBuff)
	The function randomly generates Ec ed25519 private and public keys using given seed. The generation is performed using EC Edwards ed25519 algorithm. More...

CRYSError_t	CRYS_ECEDW_KeyPair (uint8_t pSecrKey, size_t pSecrKeySize, uint8_t pPublKey, size_t pPublKeySize, CRYS_RND_Context_t pRndContext, CRYS_ECEDW_TempBuff_t pTempBuff)
	The function randomly generates the EC Edwards ed25519 private and public keys. The generation is performed using EC Edwards ed25519 algorithm. More...

Detailed Description

This file contains the CRYS APIs used for EC EDW (Edwards) ed25519 algorithms.

Note: Algorithms of Montgomery and Edwards elliptic curves cryptography were developed by Daniel.J.Bernstein.

Macro Definition Documentation

#define CRYS_ECEDW_MOD_SIZE_IN_BITS 255U

EC Edwards ed25519 modulus and order sizes in bits, words and bytes

#define CRYS_ECEDW_SEED_BYTES CRYS_ECEDW_MOD_SIZE_IN_BYTES

Constant sizes of special EC_MONT buffers and arrays

#define CRYS_ECEDW_TEMP_BUFF_SIZE_IN_32BIT_WORD

Value:

(10*CRYS_EC_MONT_EDW_MODULUS_MAX_SIZE_IN_WORDS + \

(sizeof(CRYS_HASHUserContext_t)+SASI_32BIT_WORD_SIZE-1)/SASI_32BIT_WORD_SIZE)

EC_EDW temp buffer size definition

CRYSError_t CRYS_ECEDW_KeyPair	(	uint8_t *	pSecrKey,
		size_t *	pSecrKeySize,
		uint8_t *	pPublKey,
		size_t *	pPublKeySize,
		CRYS_RND_Context_t *	pRndContext,
		CRYS_ECEDW_TempBuff_t *	pTempBuff
	)

The function randomly generates the EC Edwards ed25519 private and public keys. The generation is performed using EC Edwards ed25519 algorithm.

Returns: CRYS_OK on success,; A non-zero value on failure as defined crys_ec_mont_edw_error.h.

Parameters

[out]	pSecrKey	Pointer to the secret key (including seed and public key).
[in,out]	pSecrKeySize	Pointer to the size of the secret key in bytes, (must be at least 2*EC order size).
[out]	pPublKey	Pointer to the public key.
[in,out]	pPublKeySize	- Pointer to the size of the public key in bytes. In - the size of buffer must be at least EC modulus size; Out - the actual size.
[in,out]	pRndContext	Pointer to the RND context buffer.
[in]	pTempBuff	Pointer to the temp buffer.

CRYSError_t CRYS_ECEDW_SeedKeyPair	(	const uint8_t *	pSeed,
		size_t	seedSize,
		uint8_t *	pSecrKey,
		size_t *	pSecrKeySize,
		uint8_t *	pPublKey,
		size_t *	pPublKeySize,
		CRYS_ECEDW_TempBuff_t *	pTempBuff
	)

The function randomly generates Ec ed25519 private and public keys using given seed. The generation is performed using EC Edwards ed25519 algorithm.

Returns: CRYS_OK on success,; A non-zero value on failure as defined crys_ec_mont_edw_error.h.

Parameters

[in]	pSeed	Pointer to the given seed.
[in]	seedSize	Size of the seed in bytes, must be equal the EC order size in bytes.
[out]	pSecrKey	Pointer to the secret key, including the seed, concatenated with the public key.
[in,out]	pSecrKeySize	Pointer to the size of the secret key buffer in bytes (must be at least 2*EC order size).
[out]	pPublKey	Pointer to the public key.
[in,out]	pPublKeySize	Pointer to the size of the public key in bytes. In - the size of buffer must be at least EC modulus size; Out - the actual size.
[in]	pTempBuff	Pointer to the temp buffer, for internal use.

The function creates EC Edwards signature on the message.

Note: Used detached form of signature, separated from the message. Implemented algorithm of Bernstein D. etc. sign ed25519.

Returns: CRYS_OK on success,; A non-zero value on failure as defined crys_ec_mont_edw_error.h.

Parameters

[out]	pSign	Pointer to the detached signature.
[in,out]	pSignSize	Pointer to the total size of the signature ; In - the buffer size, which (must be at least 2*EC order size); Out - the actual size of output data.
[in]	pMsg	Pointer to the message.
[in]	msgSize	Message size in bytes: must be less, than (CRYS_HASH_UPDATE_DATA_MAX_SIZE_IN_BYTES - 2*(EC_EDW modulus size)).
[in]	pSignSecrKey	Pointer to the signer secret key (seed \|\| pulKey)
[in]	secrKeySize	Size of signer secret key in bytes: (must be 2*EC order size).
[in]	pTempBuff	Pointer to the temp buffer.

CRYSError_t CRYS_ECEDW_Verify	(	const uint8_t *	pSign,
		size_t	signSize,
		const uint8_t *	pSignPublKey,
		size_t	publKeySize,
		uint8_t *	pMsg,
		size_t	msgSize,
		CRYS_ECEDW_TempBuff_t *	pTempBuff
	)

The function verifies the EC Edwards ed25519 signature on the message.

Note: The input signature is in detached form, i.e. separated from the message.

Returns: CRYS_OK on success,; A non-zero value on failure as defined crys_ec_mont_edw_error.h.

Parameters

[in]	pSign	Pointer to detached signature, i.e. the signature is separated from the message.
[in]	signSize	Size of the signature in bytes, it must be equal to two EC Order size in bytes.
[in]	pSignPublKey	Pointer to signer public key.
[in]	publKeySize	Size of the signer public key in bytes; must be equal to EC modulus size.
[in]	pMsg	Pointer to the message.
[in]	msgSize	Pointer to the message size in bytes. Must be less than (CRYS_HASH_UPDATE_DATA_MAX_SIZE_IN_BYTES - 2*(EC_EDW modulus size)).
[in]	pTempBuff	Pointer to the temp buffer, for internal use.