123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196 |
- /* curve25519.h
- *
- * Copyright (C) 2006-2022 wolfSSL Inc.
- *
- * This file is part of wolfSSL.
- *
- * wolfSSL 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.
- *
- * wolfSSL 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-1335, USA
- */
- /*!
- \file wolfssl/wolfcrypt/curve25519.h
- */
- #ifndef WOLF_CRYPT_CURVE25519_H
- #define WOLF_CRYPT_CURVE25519_H
- #include <wolfssl/wolfcrypt/types.h>
- #ifdef HAVE_CURVE25519
- #include <wolfssl/wolfcrypt/fe_operations.h>
- #include <wolfssl/wolfcrypt/random.h>
- #ifdef WOLFSSL_ASYNC_CRYPT
- #include <wolfssl/wolfcrypt/async.h>
- #endif
- #ifdef __cplusplus
- extern "C" {
- #endif
- #define CURVE25519_KEYSIZE 32
- #define CURVE25519_PUB_KEY_SIZE 32
- #ifdef WOLFSSL_NAMES_STATIC
- typedef char curve25519_str[12];
- #else
- typedef const char* curve25519_str;
- #endif
- /* curve25519 set type */
- typedef struct {
- int size; /* The size of the curve in octets */
- curve25519_str name; /* name of this curve */
- } curve25519_set_type;
- /* ECC point, the internal structure is Little endian
- * the mathematical functions used the endianness */
- typedef struct ECPoint {
- byte point[CURVE25519_KEYSIZE];
- #ifdef FREESCALE_LTC_ECC
- byte pointY[CURVE25519_KEYSIZE];
- #endif
- byte pointSz;
- } ECPoint;
- #ifndef WC_CURVE25519KEY_TYPE_DEFINED
- typedef struct curve25519_key curve25519_key;
- #define WC_CURVE25519KEY_TYPE_DEFINED
- #endif
- /* A CURVE25519 Key */
- struct curve25519_key {
- int idx; /* Index into the ecc_sets[] for the parameters of
- this curve if -1, this key is using user supplied
- curve in dp */
- const curve25519_set_type* dp; /* domain parameters, either points to
- curves (idx >= 0) or user supplied */
- ECPoint p; /* public point for key */
- byte k[CURVE25519_KEYSIZE]; /* private scaler for key */
- #ifdef WOLFSSL_ASYNC_CRYPT
- WC_ASYNC_DEV asyncDev;
- #endif
- #if defined(WOLF_CRYPTO_CB)
- int devId;
- #endif
- #ifdef WOLFSSL_SE050
- int keyId;
- #endif
- /* bit fields */
- byte pubSet:1;
- byte privSet:1;
- };
- enum {
- EC25519_LITTLE_ENDIAN=0,
- EC25519_BIG_ENDIAN=1
- };
- WOLFSSL_API
- int wc_curve25519_make_pub(int public_size, byte* pub, int private_size,
- const byte* priv);
- WOLFSSL_API
- int wc_curve25519_generic(int public_size, byte* pub,
- int private_size, const byte* priv,
- int basepoint_size, const byte* basepoint);
- WOLFSSL_API
- int wc_curve25519_make_priv(WC_RNG* rng, int keysize, byte* priv);
- WOLFSSL_API
- int wc_curve25519_make_key(WC_RNG* rng, int keysize, curve25519_key* key);
- WOLFSSL_API
- int wc_curve25519_shared_secret(curve25519_key* private_key,
- curve25519_key* public_key,
- byte* out, word32* outlen);
- WOLFSSL_API
- int wc_curve25519_shared_secret_ex(curve25519_key* private_key,
- curve25519_key* public_key,
- byte* out, word32* outlen, int endian);
- WOLFSSL_API
- int wc_curve25519_init(curve25519_key* key);
- WOLFSSL_API
- int wc_curve25519_init_ex(curve25519_key* key, void* heap, int devId);
- WOLFSSL_API
- void wc_curve25519_free(curve25519_key* key);
- /* raw key helpers */
- WOLFSSL_API
- int wc_curve25519_import_private(const byte* priv, word32 privSz,
- curve25519_key* key);
- WOLFSSL_API
- int wc_curve25519_import_private_ex(const byte* priv, word32 privSz,
- curve25519_key* key, int endian);
- WOLFSSL_API
- int wc_curve25519_import_private_raw(const byte* priv, word32 privSz,
- const byte* pub, word32 pubSz, curve25519_key* key);
- WOLFSSL_API
- int wc_curve25519_import_private_raw_ex(const byte* priv, word32 privSz,
- const byte* pub, word32 pubSz,
- curve25519_key* key, int endian);
- WOLFSSL_API
- int wc_curve25519_export_private_raw(curve25519_key* key, byte* out,
- word32* outLen);
- WOLFSSL_API
- int wc_curve25519_export_private_raw_ex(curve25519_key* key, byte* out,
- word32* outLen, int endian);
- WOLFSSL_API
- int wc_curve25519_import_public(const byte* in, word32 inLen,
- curve25519_key* key);
- WOLFSSL_API
- int wc_curve25519_import_public_ex(const byte* in, word32 inLen,
- curve25519_key* key, int endian);
- WOLFSSL_API
- int wc_curve25519_check_public(const byte* pub, word32 pubSz, int endian);
- WOLFSSL_API
- int wc_curve25519_export_public(curve25519_key* key, byte* out, word32* outLen);
- WOLFSSL_API
- int wc_curve25519_export_public_ex(curve25519_key* key, byte* out,
- word32* outLen, int endian);
- WOLFSSL_API
- int wc_curve25519_export_key_raw(curve25519_key* key,
- byte* priv, word32 *privSz,
- byte* pub, word32 *pubSz);
- WOLFSSL_API
- int wc_curve25519_export_key_raw_ex(curve25519_key* key,
- byte* priv, word32 *privSz,
- byte* pub, word32 *pubSz,
- int endian);
- /* size helper */
- WOLFSSL_API
- int wc_curve25519_size(curve25519_key* key);
- #ifdef __cplusplus
- } /* extern "C" */
- #endif
- #endif /* HAVE_CURVE25519 */
- #endif /* WOLF_CRYPT_CURVE25519_H */
|