1 /* 2 * This file is part of the openHiTLS project. 3 * 4 * openHiTLS is licensed under the Mulan PSL v2. 5 * You can use this software according to the terms and conditions of the Mulan PSL v2. 6 * You may obtain a copy of Mulan PSL v2 at: 7 * 8 * http://license.coscl.org.cn/MulanPSL2 9 * 10 * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, 11 * EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, 12 * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE. 13 * See the Mulan PSL v2 for more details. 14 */ 15 16 #ifndef ECP_NISTP256_H 17 #define ECP_NISTP256_H 18 19 #include "hitls_build.h" 20 21 #if defined(HITLS_CRYPTO_CURVE_NISTP256) 22 23 #include "ecc_local.h" 24 25 #ifdef __cplusplus 26 extern "C" { 27 #endif 28 29 /** 30 * @brief Convert the point information pt to the affine coordinate system and refresh the data to r. 31 * 32 * @param para [IN] Curve parameters 33 * @param r [OUT] Output point information 34 * @param pt [IN] Input point information 35 * 36 * @retval CRYPT_SUCCESS succeeded 37 * @retval For details about other errors, see crypt_errno.h 38 */ 39 int32_t ECP256_Point2Affine(const ECC_Para *para, ECC_Point *r, const ECC_Point *pt); 40 41 /** 42 * @brief Calculate r = k1 * G + k2 * pt 43 * 44 * @param para [IN] Curve parameters 45 * @param r [OUT] Output point information 46 * @param k1 [IN] Scalar 1, with a maximum of 256 bits 47 * @param k2 [IN] Scalar 2, with a maximum of 256 bits 48 * @param pt [IN] Point data 49 * 50 * @retval CRYPT_SUCCESS succeeded 51 * @retval For details about other errors, see crypt_errno.h 52 */ 53 int32_t ECP256_PointMulAdd(ECC_Para *para, ECC_Point *r, 54 const BN_BigNum *k1, const BN_BigNum *k2, const ECC_Point *pt); 55 56 /** 57 * @brief If pt != NULL, calculate r = k * pt; Otherwise, calculate r = k * G 58 * 59 * @param para [IN] Curve parameter information 60 * @param r [OUT] Output point information 61 * @param k [IN] Scalar, with a maximum of 256 bits 62 * @param pt [IN] Point data, which can be set to NULL. 63 * 64 * @retval CRYPT_SUCCESS succeeded 65 * @retval For details about other errors, see crypt_errno.h 66 */ 67 int32_t ECP256_PointMul(ECC_Para *para, ECC_Point *r, const BN_BigNum *k, const ECC_Point *pt); 68 69 /** 70 * @brief Calculate r = 1/a mod para->n 71 * 72 * @param para [IN] Curve parameter information 73 * @param r [OUT] Output modulus inverse value 74 * @param a [IN] input BigNum that needs to be inverted. 75 * 76 * @retval CRYPT_SUCCESS succeeded 77 * @retval For details about other errors, see crypt_errno.h 78 */ 79 int32_t ECP256_ModOrderInv(const ECC_Para *para, BN_BigNum *r, const BN_BigNum *a); 80 81 #ifdef __cplusplus 82 } 83 #endif 84 85 #endif /* defined(HITLS_CRYPTO_CURVE_NISTP256) */ 86 87 #endif 88