My Project
|
Functions | |
int | wc_curve25519_make_key (WC_RNG *rng, int keysize, curve25519_key *key) |
This function generates a Curve25519 key using the given random number generator, rng, of the size given (keysize), and stores it in the given curve25519_key structure. It should be called after the key structure has been initialized through wc_curve25519_init(). More... | |
int | wc_curve25519_shared_secret (curve25519_key *private_key, curve25519_key *public_key, byte *out, word32 *outlen) |
This function computes a shared secret key given a secret private key and a received public key. It stores the generated secret key in the buffer out and assigns the variable of the secret key to outlen. Only supports big endian. More... | |
int | wc_curve25519_shared_secret_ex (curve25519_key *private_key, curve25519_key *public_key, byte *out, word32 *outlen, int endian) |
This function computes a shared secret key given a secret private key and a received public key. It stores the generated secret key in the buffer out and assigns the variable of the secret key to outlen. Supports both big and little endian. More... | |
int | wc_curve25519_init (curve25519_key *key) |
This function initializes a Curve25519 key. It should be called before generating a key for the structure. More... | |
void | wc_curve25519_free (curve25519_key *key) |
This function frees a Curve25519 object. More... | |
int | wc_curve25519_import_private (const byte *priv, word32 privSz, curve25519_key *key) |
This function imports a curve25519 private key only. (Big endian). More... | |
int | wc_curve25519_import_private_ex (const byte *priv, word32 privSz, curve25519_key *key, int endian) |
curve25519 private key import only. (Big or Little endian). More... | |
int | wc_curve25519_import_private_raw (const byte *priv, word32 privSz, const byte *pub, word32 pubSz, curve25519_key *key) |
This function imports a public-private key pair into a curve25519_key structure. Big endian only. More... | |
int | wc_curve25519_import_private_raw_ex (const byte *priv, word32 privSz, const byte *pub, word32 pubSz, curve25519_key *key, int endian) |
This function imports a public-private key pair into a curve25519_key structure. Supports both big and little endian. More... | |
int | wc_curve25519_export_private_raw (curve25519_key *key, byte *out, word32 *outLen) |
This function exports a private key from a curve25519_key structure and stores it in the given out buffer. It also sets outLen to be the size of the exported key. Big Endian only. More... | |
int | wc_curve25519_export_private_raw_ex (curve25519_key *key, byte *out, word32 *outLen, int endian) |
This function exports a private key from a curve25519_key structure and stores it in the given out buffer. It also sets outLen to be the size of the exported key. Can specify whether it's big or little endian. More... | |
int | wc_curve25519_import_public (const byte *in, word32 inLen, curve25519_key *key) |
This function imports a public key from the given in buffer and stores it in the curve25519_key structure. More... | |
int | wc_curve25519_import_public_ex (const byte *in, word32 inLen, curve25519_key *key, int endian) |
This function imports a public key from the given in buffer and stores it in the curve25519_key structure. More... | |
int | wc_curve25519_check_public (const byte *pub, word32 pubSz, int endian) |
This function checks that a public key buffer holds a valid Curve25519 key value given the endian ordering. More... | |
int | wc_curve25519_export_public (curve25519_key *key, byte *out, word32 *outLen) |
This function exports a public key from the given key structure and stores the result in the out buffer. Big endian only. More... | |
int | wc_curve25519_export_public_ex (curve25519_key *key, byte *out, word32 *outLen, int endian) |
This function exports a public key from the given key structure and stores the result in the out buffer. Supports both big and little endian. More... | |
int | wc_curve25519_export_key_raw (curve25519_key *key, byte *priv, word32 *privSz, byte *pub, word32 *pubSz) |
Export Curve25519 key pair. Big endian only. More... | |
int | wc_curve25519_export_key_raw_ex (curve25519_key *key, byte *priv, word32 *privSz, byte *pub, word32 *pubSz, int endian) |
Export curve25519 key pair. Big or little endian. More... | |
int | wc_curve25519_size (curve25519_key *key) |
This function returns the key size of the given key structure. More... | |
int wc_curve25519_check_public | ( | const byte * | pub, |
word32 | pubSz, | ||
int | endian | ||
) |
This function checks that a public key buffer holds a valid Curve25519 key value given the endian ordering.
[in] | pub | Pointer to the buffer containing the public key to check. |
[in] | pubLen | Length of the public key to check. |
[in] | endian | EC25519_BIG_ENDIAN or EC25519_LITTLE_ENDIAN to set which form to use. |
Example
int wc_curve25519_export_key_raw | ( | curve25519_key * | key, |
byte * | priv, | ||
word32 * | privSz, | ||
byte * | pub, | ||
word32 * | pubSz | ||
) |
Export Curve25519 key pair. Big endian only.
[in] | key | Pointer to the curve448_key structure in from which to export the key pair. |
[out] | priv | Pointer to the buffer in which to store the private key. |
[in,out] | privSz | On in, is the size of the priv buffer in bytes. On out, will store the bytes written to the priv buffer. |
[out] | pub | Pointer to the buffer in which to store the public key. |
[in,out] | pubSz | On in, is the size of the pub buffer in bytes. On out, will store the bytes written to the pub buffer. |
Example
int wc_curve25519_export_key_raw_ex | ( | curve25519_key * | key, |
byte * | priv, | ||
word32 * | privSz, | ||
byte * | pub, | ||
word32 * | pubSz, | ||
int | endian | ||
) |
Export curve25519 key pair. Big or little endian.
[in] | key | Pointer to the curve448_key structure in from which to export the key pair. |
[out] | priv | Pointer to the buffer in which to store the private key. |
[in,out] | privSz | On in, is the size of the priv buffer in bytes. On out, will store the bytes written to the priv buffer. |
[out] | pub | Pointer to the buffer in which to store the public key. |
[in,out] | pubSz | On in, is the size of the pub buffer in bytes. On out, will store the bytes written to the pub buffer. |
[in] | endian | EC25519_BIG_ENDIAN or EC25519_LITTLE_ENDIAN to set which form to use. |
Example
int wc_curve25519_export_private_raw | ( | curve25519_key * | key, |
byte * | out, | ||
word32 * | outLen | ||
) |
This function exports a private key from a curve25519_key structure and stores it in the given out buffer. It also sets outLen to be the size of the exported key. Big Endian only.
[in] | key | Pointer to the structure from which to export the key. |
[out] | out | Pointer to the buffer in which to store the exported key. |
[in,out] | outLen | On in, is the size of the out in bytes. On out, will store the bytes written to the output buffer. |
Example
int wc_curve25519_export_private_raw_ex | ( | curve25519_key * | key, |
byte * | out, | ||
word32 * | outLen, | ||
int | endian | ||
) |
This function exports a private key from a curve25519_key structure and stores it in the given out buffer. It also sets outLen to be the size of the exported key. Can specify whether it's big or little endian.
[in] | key | Pointer to the structure from which to export the key. |
[out] | out | Pointer to the buffer in which to store the exported key. |
[in,out] | outLen | On in, is the size of the out in bytes. On out, will store the bytes written to the output buffer. |
[in] | endian | EC25519_BIG_ENDIAN or EC25519_LITTLE_ENDIAN to set which form to use. |
Example
int wc_curve25519_export_public | ( | curve25519_key * | key, |
byte * | out, | ||
word32 * | outLen | ||
) |
This function exports a public key from the given key structure and stores the result in the out buffer. Big endian only.
[in] | key | Pointer to the curve25519_key structure in from which to export the key. |
[out] | out | Pointer to the buffer in which to store the public key. |
[in,out] | outLen | On in, is the size of the out in bytes. On out, will store the bytes written to the output buffer. |
Example
int wc_curve25519_export_public_ex | ( | curve25519_key * | key, |
byte * | out, | ||
word32 * | outLen, | ||
int | endian | ||
) |
This function exports a public key from the given key structure and stores the result in the out buffer. Supports both big and little endian.
[in] | key | Pointer to the curve25519_key structure in from which to export the key. |
[out] | out | Pointer to the buffer in which to store the public key. |
[in,out] | outLen | On in, is the size of the out in bytes. On out, will store the bytes written to the output buffer. |
[in] | endian | EC25519_BIG_ENDIAN or EC25519_LITTLE_ENDIAN to set which form to use. |
Example
void wc_curve25519_free | ( | curve25519_key * | key | ) |
This function frees a Curve25519 object.
[in,out] | key | Pointer to the key object to free. |
Example
int wc_curve25519_import_private | ( | const byte * | priv, |
word32 | privSz, | ||
curve25519_key * | key | ||
) |
This function imports a curve25519 private key only. (Big endian).
[in] | priv | Pointer to a buffer containing the private key to import. |
[in] | privSz | Length of the private key to import. |
[in,out] | key | Pointer to the structure in which to store the imported key. |
Example
int wc_curve25519_import_private_ex | ( | const byte * | priv, |
word32 | privSz, | ||
curve25519_key * | key, | ||
int | endian | ||
) |
curve25519 private key import only. (Big or Little endian).
[in] | priv | Pointer to a buffer containing the private key to import. |
[in] | privSz | Length of the private key to import. |
[in,out] | key | Pointer to the structure in which to store the imported key. |
[in] | endian | EC25519_BIG_ENDIAN or EC25519_LITTLE_ENDIAN to set which form to use. |
Example
int wc_curve25519_import_private_raw | ( | const byte * | priv, |
word32 | privSz, | ||
const byte * | pub, | ||
word32 | pubSz, | ||
curve25519_key * | key | ||
) |
This function imports a public-private key pair into a curve25519_key structure. Big endian only.
[in] | priv | Pointer to a buffer containing the private key to import. |
[in] | privSz | Length of the private key to import. |
[in] | pub | Pointer to a buffer containing the public key to import. |
[in] | pubSz | Length of the public key to import. |
[in,out] | key | Pointer to the structure in which to store the imported keys. |
Example
int wc_curve25519_import_private_raw_ex | ( | const byte * | priv, |
word32 | privSz, | ||
const byte * | pub, | ||
word32 | pubSz, | ||
curve25519_key * | key, | ||
int | endian | ||
) |
This function imports a public-private key pair into a curve25519_key structure. Supports both big and little endian.
[in] | priv | Pointer to a buffer containing the private key to import. |
[in] | privSz | Length of the private key to import. |
[in] | pub | Pointer to a buffer containing the public key to import. |
[in] | pubSz | Length of the public key to import. |
[in,out] | key | Pointer to the structure in which to store the imported keys. |
[in] | endian | EC25519_BIG_ENDIAN or EC25519_LITTLE_ENDIAN to set which form to use. |
Example
int wc_curve25519_import_public | ( | const byte * | in, |
word32 | inLen, | ||
curve25519_key * | key | ||
) |
This function imports a public key from the given in buffer and stores it in the curve25519_key structure.
[in] | in | Pointer to the buffer containing the public key to import. |
[in] | inLen | Length of the public key to import. |
[in,out] | key | Pointer to the curve25519_key structure in which to store the key. |
Example
int wc_curve25519_import_public_ex | ( | const byte * | in, |
word32 | inLen, | ||
curve25519_key * | key, | ||
int | endian | ||
) |
This function imports a public key from the given in buffer and stores it in the curve25519_key structure.
[in] | in | Pointer to the buffer containing the public key to import. |
[in] | inLen | Length of the public key to import. |
[in,out] | key | Pointer to the curve25519_key structure in which to store the key. |
[in] | endian | EC25519_BIG_ENDIAN or EC25519_LITTLE_ENDIAN to set which form to use. |
Example
int wc_curve25519_init | ( | curve25519_key * | key | ) |
This function initializes a Curve25519 key. It should be called before generating a key for the structure.
[in,out] | key | Pointer to the curve25519_key structure to initialize. |
Example
int wc_curve25519_make_key | ( | WC_RNG * | rng, |
int | keysize, | ||
curve25519_key * | key | ||
) |
This function generates a Curve25519 key using the given random number generator, rng, of the size given (keysize), and stores it in the given curve25519_key structure. It should be called after the key structure has been initialized through wc_curve25519_init().
[in] | rng | Pointer to the RNG object used to generate the ecc key. |
[in] | keysize | Size of the key to generate. Must be 32 bytes for curve25519. |
[in,out] | key | Pointer to the curve25519_key structure in which to store the generated key. |
Example
int wc_curve25519_shared_secret | ( | curve25519_key * | private_key, |
curve25519_key * | public_key, | ||
byte * | out, | ||
word32 * | outlen | ||
) |
This function computes a shared secret key given a secret private key and a received public key. It stores the generated secret key in the buffer out and assigns the variable of the secret key to outlen. Only supports big endian.
[in] | private_key | Pointer to the curve25519_key structure initialized with the user’s private key. |
[in] | public_key | Pointer to the curve25519_key structure containing the received public key. |
[out] | out | Pointer to a buffer in which to store the 32 byte computed secret key. |
[in,out] | outlen | Pointer in which to store the length written to the output buffer. |
Example
int wc_curve25519_shared_secret_ex | ( | curve25519_key * | private_key, |
curve25519_key * | public_key, | ||
byte * | out, | ||
word32 * | outlen, | ||
int | endian | ||
) |
This function computes a shared secret key given a secret private key and a received public key. It stores the generated secret key in the buffer out and assigns the variable of the secret key to outlen. Supports both big and little endian.
[in] | private_key | Pointer to the curve25519_key structure initialized with the user’s private key. |
[in] | public_key | Pointer to the curve25519_key structure containing the received public key. |
[out] | out | Pointer to a buffer in which to store the 32 byte computed secret key. |
pin,out] | outlen Pointer in which to store the length written to the output buffer. | |
[in] | endian | EC25519_BIG_ENDIAN or EC25519_LITTLE_ENDIAN to set which form to use. |
Example
int wc_curve25519_size | ( | curve25519_key * | key | ) |
This function returns the key size of the given key structure.
[in] | key | Pointer to the curve25519_key structure in for which to determine the key size. |
Example