 |
Software APIs
|
|
Software APIs
|
X25519 operations for OpenTitan cryptography library. More...
#include "datatypes.h"Go to the source code of this file.
X25519 operations for OpenTitan cryptography library.
Definition in file x25519.h.
| OT_WARN_UNUSED_RESULT otcrypto_status_t otcrypto_x25519 | ( | const otcrypto_blinded_key_t * | private_key, |
| const otcrypto_unblinded_key_t * | public_key, | ||
| otcrypto_blinded_key_t * | shared_secret | ||
| ) |
Elliptic-curve Diffie Hellman shared secret generation with Curve25519.
| private_key | Pointer to blinded private key (u-coordinate). | |
| public_key | Pointer to the public scalar from the sender. | |
| [out] | shared_secret | Pointer to shared secret key (u-coordinate). |
| OT_WARN_UNUSED_RESULT otcrypto_status_t otcrypto_x25519_async_finalize | ( | otcrypto_blinded_key_t * | shared_secret | ) |
Finalizes asynchronous shared secret generation for X25519.
See otcrypto_x25519 for requirements on input values.
May block until the operation is complete.
| [out] | shared_secret | Pointer to shared secret key (u-coordinate). |
| OT_WARN_UNUSED_RESULT otcrypto_status_t otcrypto_x25519_async_start | ( | const otcrypto_blinded_key_t * | private_key, |
| const otcrypto_unblinded_key_t * | public_key | ||
| ) |
Starts asynchronous shared secret generation for X25519.
See otcrypto_x25519 for requirements on input values.
| private_key | Pointer to the blinded private key (u-coordinate). |
| public_key | Pointer to the public scalar from the sender. |
| OT_WARN_UNUSED_RESULT otcrypto_status_t otcrypto_x25519_keygen | ( | otcrypto_blinded_key_t * | private_key, |
| otcrypto_unblinded_key_t * | public_key | ||
| ) |
Generates a key pair for X25519.
The caller should allocate and partially populate the blinded key struct, including populating the key configuration and allocating space for the keyblob. For a hardware-backed key, use the private key handle returned by otcrypto_hw_backed_key. Otherwise, the mode should indicate X25519 and the keyblob should be 80 bytes. The value in the checksum field of the blinded key struct will be populated by the key generation function.
| [out] | private_key | Pointer to the blinded private key struct. |
| [out] | public_key | Pointer to the unblinded public key struct. |
| OT_WARN_UNUSED_RESULT otcrypto_status_t otcrypto_x25519_keygen_async_finalize | ( | otcrypto_blinded_key_t * | private_key, |
| otcrypto_unblinded_key_t * | public_key | ||
| ) |
Finalizes the asynchronous key generation for X25519.
See otcrypto_x25519_keygen for requirements on input values.
May block until the operation is complete.
The caller should ensure that the private key configuration matches that passed to the _start function.
| [out] | private_key | Pointer to the blinded private key struct. |
| [out] | public_key | Pointer to the unblinded public key struct. |
| OT_WARN_UNUSED_RESULT otcrypto_status_t otcrypto_x25519_keygen_async_start | ( | const otcrypto_blinded_key_t * | private_key | ) |