/*! \ingroup ED448 \brief この関数は、秘密鍵からED448公開鍵を生成します。公開鍵をバッファPubkeyに格納し、Pubkeyszでこのバッファに書き込まれたバイトを設定します。 \return 0 公開鍵の作成に成功したときに返されます。 \return BAD_FUNC_ARG IFIキーまたはPubKeyがNULLに評価された場合、または指定されたキーサイズが57バイトではない場合(ED448には57バイトのキーがあります)。 \return MEMORY_E 関数の実行中にメモリを割り当てるエラーがある場合に返されます。 \param [in] キーを生成するED448_Keyへのキーポインタ。 \param [out] 公開鍵を保存するバッファへのポインタ。 _Example_ \code int ret; ed448_key key; byte priv[] = { initialize with 57 byte private key }; byte pub[57]; word32 pubSz = sizeof(pub); wc_ed448_init(&key); wc_ed448_import_private_only(priv, sizeof(priv), &key); ret = wc_ed448_make_public(&key, pub, &pubSz); if (ret != 0) { // error making public key } \endcode \sa wc_ed448_init \sa wc_ed448_import_private_only \sa wc_ed448_make_key */ int wc_ed448_make_public(ed448_key* key, unsigned char* pubKey, word32 pubKeySz); /*! \ingroup ED448 \brief この関数は新しいED448キーを生成し、それをキーに格納します。 \return 0 ED448_Keyを正常に作成したときに返されます。 \return BAD_FUNC_ARG RNGまたはKeyがNULLに評価された場合、または指定されたキーサイズが57バイトではない場合(ED448には57バイトのキーがあります)。 \return MEMORY_E 関数の実行中にメモリを割り当てるエラーがある場合に返されます。 \param [in] RNGキーを生成する初期化されたRNGオブジェクトへのポインタ。 \param [in] keysize keyの長さを生成します。ED448の場合は常に57になります。 _Example_ \code int ret; WC_RNG rng; ed448_key key; wc_InitRng(&rng); wc_ed448_init(&key); ret = wc_ed448_make_key(&rng, 57, &key); if (ret != 0) { // error making key } \endcode \sa wc_ed448_init */ int wc_ed448_make_key(WC_RNG* rng, int keysize, ed448_key* key); /*! \ingroup ED448 \brief この関数は、ED448_Keyオブジェクトを使用したメッセージに正解を保証します。 \return 0 メッセージの署名を正常に生成すると返されます。 \return BAD_FUNC_ARG 入力パラメータのいずれかがNULLに評価された場合、または出力バッファが小さすぎて生成された署名を保存する場合は返されます。 \return MEMORY_E 関数の実行中にメモリを割り当てるエラーがある場合に返されます。 \param [in] 署名するメッセージを含むバッファへのポインタ。 \param [in] 署名するメッセージのインレル長。 \param [out] 生成された署名を格納するためのバッファー。 \param [in,out] 出力バッファの最大長の範囲内。メッセージ署名の生成に成功したときに、書き込まれたバイトを保存します。 _Example_ \code ed448_key key; WC_RNG rng; int ret, sigSz; byte sig[114]; // will hold generated signature sigSz = sizeof(sig); byte message[] = { initialize with message }; wc_InitRng(&rng); // initialize rng wc_ed448_init(&key); // initialize key wc_ed448_make_key(&rng, 57, &key); // make public/private key pair ret = wc_ed448_sign_msg(message, sizeof(message), sig, &sigSz, &key); if (ret != 0 ) { // error generating message signature } \endcode \sa wc_ed448ph_sign_hash \sa wc_ed448ph_sign_msg \sa wc_ed448_verify_msg */ int wc_ed448_sign_msg(const byte* in, word32 inlen, byte* out, word32 *outlen, ed448_key* key); /*! \ingroup ED448 \brief この関数は、Ed448_Keyオブジェクトを使用してメッセージダイジェストに署名して信頼性を保証します。コンテキストは署名されたデータの一部として含まれています。ハッシュは、署名計算前のプリハッシュメッセージです。メッセージダイジェストを作成するために使用されるハッシュアルゴリズムはShake-256でなければなりません。 \return 0 メッセージダイジェストの署名を正常に生成すると返されます。 \return BAD_FUNC_ARG 返された入力パラメータはNULLに評価されます。出力バッファが小さすぎて生成された署名を保存するには小さすぎます。 \return MEMORY_E 関数の実行中にメモリを割り当てるエラーがある場合に返されます。 \param [in] サインへのメッセージのハッシュを含むバッファへのハッシュポインタ。 \param [in] サインへのメッセージのハッシュのハッシュの長さ。 \param [out] 生成された署名を格納するためのバッファー。 \param [in,out] 出力バッファの最大長の範囲内。メッセージ署名の生成に成功したときに、書き込まれたバイトを保存します。 \param [in] 署名を生成するためのプライベートED448_Keyへのキーポインタ。 \param [in] メッセージが署名されているコンテキストを含むバッファへのコンテキストポインタ。 _Example_ \code ed448_key key; WC_RNG rng; int ret, sigSz; byte sig[114]; // will hold generated signature sigSz = sizeof(sig); byte hash[] = { initialize with SHAKE-256 hash of message }; byte context[] = { initialize with context of signing }; wc_InitRng(&rng); // initialize rng wc_ed448_init(&key); // initialize key wc_ed448_make_key(&rng, 57, &key); // make public/private key pair ret = wc_ed448ph_sign_hash(hash, sizeof(hash), sig, &sigSz, &key, context, sizeof(context)); if (ret != 0) { // error generating message signature } \endcode \sa wc_ed448_sign_msg \sa wc_ed448ph_sign_msg \sa wc_ed448ph_verify_hash */ int wc_ed448ph_sign_hash(const byte* hash, word32 hashLen, byte* out, word32 *outLen, ed448_key* key, const byte* context, byte contextLen); /*! \ingroup ED448 \brief この関数は、ED448_Keyオブジェクトを使用したメッセージに正解を保証します。コンテキストは署名されたデータの一部として含まれています。署名計算の前にメッセージは事前にハッシュされています。 \return 0 メッセージの署名を正常に生成すると返されます。 \return BAD_FUNC_ARG 返された入力パラメータはNULLに評価されます。出力バッファが小さすぎて生成された署名を保存するには小さすぎます。 \return MEMORY_E 関数の実行中にメモリを割り当てるエラーがある場合に返されます。 \param [in] 署名するメッセージを含むバッファへのポインタ。 \param [in] 署名するメッセージのインレル長。 \param [out] 生成された署名を格納するためのバッファー。 \param [in,out] 出力バッファの最大長の範囲内。メッセージ署名の生成に成功したときに、書き込まれたバイトを保存します。 \param [in] 署名を生成するためのプライベートED448_Keyへのキーポインタ。 \param [in] メッセージが署名されているコンテキストを含むバッファへのコンテキストポインタ。 _Example_ \code ed448_key key; WC_RNG rng; int ret, sigSz; byte sig[114]; // will hold generated signature sigSz = sizeof(sig); byte message[] = { initialize with message }; byte context[] = { initialize with context of signing }; wc_InitRng(&rng); // initialize rng wc_ed448_init(&key); // initialize key wc_ed448_make_key(&rng, 57, &key); // make public/private key pair ret = wc_ed448ph_sign_msg(message, sizeof(message), sig, &sigSz, &key, context, sizeof(context)); if (ret != 0) { // error generating message signature } \endcode \sa wc_ed448_sign_msg \sa wc_ed448ph_sign_hash \sa wc_ed448ph_verify_msg */ int wc_ed448ph_sign_msg(const byte* in, word32 inLen, byte* out, word32 *outLen, ed448_key* key, const byte* context, byte contextLen); /*! \ingroup ED448 \brief この関数は、メッセージのED448署名を確認して信頼性を確保します。文脈はデータ検証済みの一部として含まれています。答えはRESを介して返され、有効な署名に対応する1、無効な署名に対応する0を返します。 \return 0 署名検証と認証を正常に実行したときに返されます。 \return BAD_FUNC_ARG いずれかの入力パラメータがNULLに評価された場合、またはSIGLENが署名の実際の長さと一致しない場合に返されます。 \return SIG_VERIFY_E 検証が完了した場合は返されますが、生成された署名は提供された署名と一致しません。 \param [in] 検証するシグネチャを含むバッファへのSIGポインタ。 \param [in] 検証するシグネチャのシグレンの長さ。 \param [in] メッセージを含むバッファへのMSGポインタを確認する。 \param [in] 検証するメッセージのMSGlen長。 \param [in] 署名を検証するためのパブリックED448キーへのキーポインタ。 \param [in] メッセージが署名されたコンテキストを含むバッファへのコンテキストポインタ。 _Example_ \code ed448_key key; int ret, verified = 0; byte sig[] { initialize with received signature }; byte msg[] = { initialize with message }; byte context[] = { initialize with context of signature }; // initialize key with received public key ret = wc_ed448_verify_msg(sig, sizeof(sig), msg, sizeof(msg), &verified, &key, context, sizeof(context)); if (ret < 0) { // error performing verification } else if (verified == 0) // the signature is invalid } \endcode \sa wc_ed448ph_verify_hash \sa wc_ed448ph_verify_msg \sa wc_ed448_sign_msg */ int wc_ed448_verify_msg(const byte* sig, word32 siglen, const byte* msg, word32 msgLen, int* res, ed448_key* key, const byte* context, byte contextLen); /*! \ingroup ED448 \brief この関数は、メッセージのダイジェストのED448シグネチャを検証して、信頼性を確保します。文脈はデータ検証済みの一部として含まれています。ハッシュは、署名計算前のプリハッシュメッセージです。メッセージダイジェストを作成するために使用されるハッシュアルゴリズムはShake-256でなければなりません。答えはRESを介して返され、有効な署名に対応する1、無効な署名に対応する0を返します。 \return 0 署名検証と認証を正常に実行したときに返されます。 \return BAD_FUNC_ARG いずれかの入力パラメータがNULLに評価された場合、またはSIGLENが署名の実際の長さと一致しない場合に返されます。 \return SIG_VERIFY_E 検証が完了した場合は返されますが、生成された署名は提供された署名と一致しません。 \param [in] 検証するシグネチャを含むバッファへのSIGポインタ。 \param [in] 検証するシグネチャのシグレンの長さ。 \param [in] 検証するメッセージのハッシュを含むバッファへのハッシュポインタ。 \param [in] 検証するハッシュのハッシュレン長。 \param [in] 署名を検証するためのパブリックED448キーへのキーポインタ。 \param [in] メッセージが署名されたコンテキストを含むバッファへのコンテキストポインタ。 _Example_ \code ed448_key key; int ret, verified = 0; byte sig[] { initialize with received signature }; byte hash[] = { initialize with SHAKE-256 hash of message }; byte context[] = { initialize with context of signature }; // initialize key with received public key ret = wc_ed448ph_verify_hash(sig, sizeof(sig), hash, sizeof(hash), &verified, &key, context, sizeof(context)); if (ret < 0) { // error performing verification } else if (verified == 0) // the signature is invalid } \endcode \sa wc_ed448_verify_msg \sa wc_ed448ph_verify_msg \sa wc_ed448ph_sign_hash */ int wc_ed448ph_verify_hash(const byte* sig, word32 siglen, const byte* hash, word32 hashlen, int* res, ed448_key* key, const byte* context, byte contextLen); /*! \ingroup ED448 \brief この関数は、メッセージのED448署名を確認して信頼性を確保します。文脈はデータ検証済みの一部として含まれています。検証前にメッセージがプリハッシュされています。答えはRESを介して返され、有効な署名に対応する1、無効な署名に対応する0を返します。 \return 0 署名検証と認証を正常に実行したときに返されます。 \return BAD_FUNC_ARG いずれかの入力パラメータがNULLに評価された場合、またはSIGLENが署名の実際の長さと一致しない場合に返されます。 \return SIG_VERIFY_E 検証が完了した場合は返されますが、生成された署名は提供された署名と一致しません。 \param [in] 検証するシグネチャを含むバッファへのSIGポインタ。 \param [in] 検証するシグネチャのシグレンの長さ。 \param [in] メッセージを含むバッファへのMSGポインタを確認する。 \param [in] 検証するメッセージのMSGlen長。 \param [in] 署名を検証するためのパブリックED448キーへのキーポインタ。 \param [in] メッセージが署名されたコンテキストを含むバッファへのコンテキストポインタ。 _Example_ \code ed448_key key; int ret, verified = 0; byte sig[] { initialize with received signature }; byte msg[] = { initialize with message }; byte context[] = { initialize with context of signature }; // initialize key with received public key ret = wc_ed448ph_verify_msg(sig, sizeof(sig), msg, sizeof(msg), &verified, &key, context, sizeof(context)); if (ret < 0) { // error performing verification } else if (verified == 0) // the signature is invalid } \endcode \sa wc_ed448_verify_msg \sa wc_ed448ph_verify_hash \sa wc_ed448ph_sign_msg */ int wc_ed448ph_verify_msg(const byte* sig, word32 siglen, const byte* msg, word32 msgLen, int* res, ed448_key* key, const byte* context, byte contextLen); /*! \ingroup ED448 \brief この関数は、メッセージ検証で将来の使用のためにED448_Keyオブジェクトを初期化します。 \return 0 ED448_Keyオブジェクトの初期化に成功したら返されます。 \return BAD_FUNC_ARG キーがNULLの場合は返されます。 _Example_ \code ed448_key key; wc_ed448_init(&key); \endcode \sa wc_ed448_make_key \sa wc_ed448_free */ int wc_ed448_init(ed448_key* key); /*! \ingroup ED448 \brief この関数は、それが使用された後にED448オブジェクトを解放します。 _Example_ \code ed448_key key; // initialize key and perform secure exchanges ... wc_ed448_free(&key); \endcode \sa wc_ed448_init */ void wc_ed448_free(ed448_key* key); /*! \ingroup ED448 \brief この関数は、公開鍵を含むバッファからPublic ED448_Keyペアをインポートします。この関数は圧縮キーと非圧縮キーの両方を処理します。 \return 0 ED448_Keyのインポートに成功しました。 \return BAD_FUNC_ARG INまたはKEYがNULLに評価されている場合、またはINLENがED448キーのサイズより小さい場合に返されます。 \param [in] 公開鍵を含むバッファへのポインタ。 \param [in] 公開鍵を含むバッファのインレル長。 _Example_ \code int ret; byte pub[] = { initialize Ed448 public key }; ed_448 key; wc_ed448_init_key(&key); ret = wc_ed448_import_public(pub, sizeof(pub), &key); if (ret != 0) { // error importing key } \endcode \sa wc_ed448_import_private_key \sa wc_ed448_export_public */ int wc_ed448_import_public(const byte* in, word32 inLen, ed448_key* key); /*! \ingroup ED448 \brief この関数は、ed448秘密鍵をバッファからのみインポートします。 \return 0 ED448秘密鍵のインポートに成功しました。 \return BAD_FUNC_ARG INまたはKEYがNULLに評価された場合、またはPRIVSZがED448_KEY_SIZEよりも小さい場合に返されます。 \param [in] 秘密鍵を含むバッファへのPRIVポインタ。 \param [in] 秘密鍵のPrivsz長さ。 _Example_ \code int ret; byte priv[] = { initialize with 57 byte private key }; ed448_key key; wc_ed448_init_key(&key); ret = wc_ed448_import_private_only(priv, sizeof(priv), &key); if (ret != 0) { // error importing private key } \endcode \sa wc_ed448_import_public \sa wc_ed448_import_private_key \sa wc_ed448_export_private_only */ int wc_ed448_import_private_only(const byte* priv, word32 privSz, ed448_key* key); /*! \ingroup ED448 \brief この関数は、一対のバッファからパブリック/プライベートED448キーペアをインポートします。この関数は圧縮キーと非圧縮キーの両方を処理します。 \return 0 ED448キーのインポートに成功しました。 \return BAD_FUNC_ARG INまたはKEYがNULLに評価された場合、またはPROVSZがED448_KEY_SIZEまたはPUBSZのいずれかがeD448_PUB_KEY_SIZEよりも小さい場合に返されます。 \param [in] 秘密鍵を含むバッファへのPRIVポインタ。 \param [in] 秘密鍵のPrivsz長さ。 \param [in] 公開鍵を含むバッファへのPubポインタ。 \param [in] 公開鍵のPubszの長さ。 _Example_ \code int ret; byte priv[] = { initialize with 57 byte private key }; byte pub[] = { initialize with the corresponding public key }; ed448_key key; wc_ed448_init_key(&key); ret = wc_ed448_import_private_key(priv, sizeof(priv), pub, sizeof(pub), &key); if (ret != 0) { // error importing key } \endcode \sa wc_ed448_import_public \sa wc_ed448_import_private_only \sa wc_ed448_export_private */ int wc_ed448_import_private_key(const byte* priv, word32 privSz, const byte* pub, word32 pubSz, ed448_key* key); /*! \ingroup ED448 \brief この関数は、ED448_Key構造体から秘密鍵をエクスポートします。公開鍵をバッファアウトに格納し、ounterenでこのバッファに書き込まれたバイトを設定します。 \return 0 公開鍵のエクスポートに成功したら返されます。 \return BAD_FUNC_ARG いずれかの入力値がNULLに評価された場合に返されます。 \return BUFFER_E 提供されたバッファーが秘密鍵を保存するのに十分な大きさでない場合に返されます。このエラーを返すと、outlenに必要なサイズを設定します。 \param [in] 公開鍵をエクスポートするED448_Key構造体へのキーポインタ。 \param [out] 公開鍵を保存するバッファへのポインタ。 _Example_ \code int ret; ed448_key key; // initialize key, make key char pub[57]; word32 pubSz = sizeof(pub); ret = wc_ed448_export_public(&key, pub, &pubSz); if (ret != 0) { // error exporting public key } \endcode \sa wc_ed448_import_public \sa wc_ed448_export_private_only */ int wc_ed448_export_public(ed448_key* key, byte* out, word32* outLen); /*! \ingroup ED448 \brief この関数は、ED448_Key構造体からの秘密鍵のみをエクスポートします。秘密鍵をバッファアウトに格納し、outlenにこのバッファに書き込まれたバイトを設定します。 \return 0 秘密鍵のエクスポートに成功したら返されます。 \return ECC_BAD_ARG_E いずれかの入力値がNULLに評価された場合に返されます。 \return BUFFER_E 提供されたバッファーが秘密鍵を保存するのに十分な大きさでない場合に返されます。 \param [in] 秘密鍵をエクスポートするED448_Key構造体へのキーポインタ。 \param [out] 秘密鍵を保存するバッファへのポインタ。 _Example_ \code int ret; ed448_key key; // initialize key, make key char priv[57]; // 57 bytes because only private key word32 privSz = sizeof(priv); ret = wc_ed448_export_private_only(&key, priv, &privSz); if (ret != 0) { // error exporting private key } \endcode \sa wc_ed448_export_public \sa wc_ed448_import_private_key */ int wc_ed448_export_private_only(ed448_key* key, byte* out, word32* outLen); /*! \ingroup ED448 \brief この関数は、ED448_Key構造体からキーペアをエクスポートします。キーペアをバッファOUTに格納し、ounterenでこのバッファに書き込まれたバイトを設定します。 \return 0 キーペアのエクスポートに成功したら返されます。 \return ECC_BAD_ARG_E いずれかの入力値がNULLに評価された場合に返されます。 \return BUFFER_E 提供されているバッファーがキーペアを保存するのに十分な大きさでない場合に返されます。 \param [in] キーペアをエクスポートするためのED448_Key構造体へのキーポインタ。 \param [out] キーペアを保存するバッファへのポインタ。 _Example_ \code ed448_key key; wc_ed448_init(&key); WC_RNG rng; wc_InitRng(&rng); wc_ed448_make_key(&rng, 57, &key); // initialize 57 byte Ed448 key byte out[114]; // out needs to be a sufficient buffer size word32 outLen = sizeof(out); int key_size = wc_ed448_export_private(&key, out, &outLen); if (key_size == BUFFER_E) { // Check size of out compared to outLen to see if function reset outLen } \endcode \sa wc_ed448_import_private \sa wc_ed448_export_private_only */ int wc_ed448_export_private(ed448_key* key, byte* out, word32* outLen); /*! \ingroup ED448 \brief この関数は、ED448_Key構造体とは別にプライベートキーと公開鍵をエクスポートします。秘密鍵をバッファーPrivに格納し、PRIVSZでこのバッファに書き込まれたバイトを設定します。公開鍵をバッファPUBに格納し、Pubszでこのバッファに書き込まれたバイトを設定します。 \return 0 キーペアのエクスポートに成功したら返されます。 \return ECC_BAD_ARG_E いずれかの入力値がNULLに評価された場合に返されます。 \return BUFFER_E 提供されているバッファーがキーペアを保存するのに十分な大きさでない場合に返されます。 \param [in] キーペアをエクスポートするためのED448_Key構造体へのキーポインタ。 \param [out] 秘密鍵を保存するバッファへのPRIVポインタ。 \param [in,out] PRIVSZ PIVINSZポインタサイズが表示されているサイズを持つWord32オブジェクトへのポインタ。秘密鍵のエクスポート後に書き込まれたバイト数を設定します。 \param [out] パブリックキーを保存するバッファへのPub。 _Example_ \code int ret; ed448_key key; // initialize key, make key char pub[57]; word32 pubSz = sizeof(pub); char priv[57]; word32 privSz = sizeof(priv); ret = wc_ed448_export_key(&key, priv, &pubSz, pub, &pubSz); if (ret != 0) { // error exporting private and public key } \endcode \sa wc_ed448_export_private \sa wc_ed448_export_public */ int wc_ed448_export_key(ed448_key* key, byte* priv, word32 *privSz, byte* pub, word32 *pubSz); /*! \ingroup ED448 \brief この関数は、ed448_key構造体の公開鍵をチェックします。 \return 0 プライベートキーと公開鍵が一致した場合に返されます。 \return BAD_FUNC_ARGS 与えられたキーがNULLの場合に返されます。 _Example_ \code int ret; byte priv[] = { initialize with 57 byte private key }; byte pub[] = { initialize with the corresponding public key }; ed448_key key; wc_ed448_init_key(&key); wc_ed448_import_private_key(priv, sizeof(priv), pub, sizeof(pub), &key); ret = wc_ed448_check_key(&key); if (ret != 0) { // error checking key } \endcode \sa wc_ed448_import_private_key */ int wc_ed448_check_key(ed448_key* key); /*! \ingroup ED448 \brief この関数は、ED448秘密鍵のサイズ - 57バイトを返します。 \return ED448_KEY_SIZE 有効な秘密鍵のサイズ(57バイト)。 \return BAD_FUNC_ARGS 与えられたキーがNULLの場合に返されます。 _Example_ \code int keySz; ed448_key key; // initialize key, make key keySz = wc_ed448_size(&key); if (keySz == 0) { // error determining key size } \endcode \sa wc_ed448_make_key */ int wc_ed448_size(ed448_key* key); /*! \ingroup ED448 \brief この関数は、秘密鍵サイズ(secret + public)をバイト単位で返します。 \return ED448_PRV_KEY_SIZE 秘密鍵のサイズ(114バイト)。 \return BAD_FUNC_ARG key引数がnullの場合は返します。 _Example_ \code ed448_key key; wc_ed448_init(&key); WC_RNG rng; wc_InitRng(&rng); wc_ed448_make_key(&rng, 57, &key); // initialize 57 byte Ed448 key int key_size = wc_ed448_priv_size(&key); \endcode \sa wc_ed448_pub_size */ int wc_ed448_priv_size(ed448_key* key); /*! \ingroup ED448 \brief この関数は圧縮鍵サイズをバイト単位で返します(公開鍵)。 \return ED448_PUB_KEY_SIZE 圧縮公開鍵のサイズ(57バイト)。 \return BAD_FUNC_ARG key引数がnullの場合は返します。 _Example_ \code ed448_key key; wc_ed448_init(&key); WC_RNG rng; wc_InitRng(&rng); wc_ed448_make_key(&rng, 57, &key); // initialize 57 byte Ed448 key int key_size = wc_ed448_pub_size(&key); \endcode \sa wc_ed448_priv_size */ int wc_ed448_pub_size(ed448_key* key); /*! \ingroup ED448 \brief この関数は、ED448シグネチャのサイズ(バイト数114)を返します。 \return ED448_SIG_SIZE ED448シグネチャ(114バイト)のサイズ。 \return BAD_FUNC_ARG key引数がnullの場合は返します。 _Example_ \code int sigSz; ed448_key key; // initialize key, make key sigSz = wc_ed448_sig_size(&key); if (sigSz == 0) { // error determining sig size } \endcode \sa wc_ed448_sign_msg */ int wc_ed448_sig_size(ed448_key* key);