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(). | |
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. | |
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. | |
int | wc_curve25519_init (curve25519_key *key) |
This function initializes a Curve25519 key. It should be called before generating a key for the structure. | |
void | wc_curve25519_free (curve25519_key *key) |
This function frees a Curve25519 object. | |
int | wc_curve25519_import_private (const byte *priv, word32 privSz, curve25519_key *key) |
This function imports a curve25519 private key only. (Big endian). | |
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). | |
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. | |
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. | |
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. | |
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. | |
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. | |
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. | |
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. | |
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. | |
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. | |
int | wc_curve25519_export_key_raw (curve25519_key *key, byte *priv, word32 *privSz, byte *pub, word32 *pubSz) |
Export Curve25519 key pair. Big endian only. | |
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. | |
int | wc_curve25519_size (curve25519_key *key) |
This function returns the key size of the given key structure. | |
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