ed448.h

Functions

	Name
int	wc_ed448_make_public(ed448_key * key, unsigned char * pubKey, word32 pubKeySz) この関数は、秘密鍵からEd448公開鍵を生成します。公開鍵をバッファpubKeyに格納し、このバッファに書き込まれたバイト数をpubKeySzに設定します。
int	wc_ed448_make_key(WC_RNG * rng, int keysize, ed448_key * key) この関数は新しいEd448キーを生成し、それをkeyに格納します。
int	wc_ed448_sign_msg(const byte * in, word32 inlen, byte * out, word32 * outlen, ed448_key * key) この関数は、真正性を保証するためにed448_keyオブジェクトを使用してメッセージに署名します。
int	wc_ed448ph_sign_hash(const byte * hash, word32 hashLen, byte * out, word32 * outLen, ed448_key * key, const byte * context, byte contextLen) この関数は、真正性を保証するためにed448_keyオブジェクトを使用してメッセージダイジェストに署名します。コンテキストは署名されるデータの一部として含まれます。ハッシュは署名計算前の事前ハッシュ化されたメッセージです。
int	wc_ed448ph_sign_msg(const byte * in, word32 inlen, byte * out, word32 * outlen, ed448_key * key, const byte * context, byte contextLen) この関数は、真正性を保証するためにed448_keyオブジェクトを使用してメッセージに署名します。コンテキストは署名されるデータの一部として含まれます。メッセージは署名計算前に事前ハッシュ化されます。
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) この関数は、真正性を保証するためにメッセージのEd448署名を検証します。コンテキストは検証されるデータの一部として含まれます。答えはresを通じて返され、1は有効な署名に対応し、0は無効な署名に対応します。
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) この関数は、真正性を保証するためにメッセージのダイジェストのEd448署名を検証します。コンテキストは検証されるデータの一部として含まれます。ハッシュは署名計算前の事前ハッシュ化されたメッセージです。答えはresを通じて返され、1は有効な署名に対応し、0は無効な署名に対応します。
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) この関数は、真正性を保証するためにメッセージのEd448署名を検証します。コンテキストは検証されるデータの一部として含まれます。メッセージは検証前に事前ハッシュ化されます。答えはresを通じて返され、1は有効な署名に対応し、0は無効な署名に対応します。
int	wc_ed448_init(ed448_key * key) この関数は、メッセージ検証での将来の使用のためにed448_keyオブジェクトを初期化します。
void	wc_ed448_free(ed448_key * key) この関数は、使用後にEd448オブジェクトを解放します。
int	wc_ed448_import_public(const byte * in, word32 inLen, ed448_key * key) この関数は、公開鍵を含むバッファから公開ed448_keyペアをインポートします。この関数は、圧縮キーと非圧縮キーの両方を処理します。公開鍵は、秘密鍵が存在する場合にそれと一致するかチェックされます。
int	wc_ed448_import_public_ex(const byte * in, word32 inLen, ed448_key * key, int trusted) この関数は、公開鍵を含むバッファから公開ed448_keyペアをインポートします。この関数は、圧縮キーと非圧縮キーの両方を処理します。信頼されていない場合、秘密鍵が存在するときに公開鍵が秘密鍵と一致するかチェックします。
int	wc_ed448_import_private_only(const byte * priv, word32 privSz, ed448_key * key) この関数は、バッファからEd448秘密鍵のみをインポートします。
int	wc_ed448_import_private_key(const byte * priv, word32 privSz, const byte * pub, word32 pubSz, ed448_key * key) この関数は、一対のバッファから公開/秘密Ed448鍵ペアをインポートします。この関数は、圧縮キーと非圧縮キーの両方を処理します。
int	wc_ed448_import_private_key_ex(const byte * priv, word32 privSz, const byte * pub, word32 pubSz, ed448_key * key, int trusted) この関数は、一対のバッファから公開/秘密Ed448鍵ペアをインポートします。この関数は、圧縮キーと非圧縮キーの両方を処理します。信頼されていない場合、公開鍵が秘密鍵に対してチェックされます。
int	wc_ed448_export_public(ed448_key * key, byte * out, word32 * outLen) この関数は、ed448_key構造体から秘密鍵をエクスポートします。公開鍵をバッファoutに格納し、このバッファに書き込まれたバイト数をoutLenに設定します。
int	wc_ed448_export_private_only(ed448_key * key, byte * out, word32 * outLen) この関数は、ed448_key構造体から秘密鍵のみをエクスポートします。秘密鍵をバッファoutに格納し、このバッファに書き込まれたバイト数をoutLenに設定します。
int	wc_ed448_export_private(ed448_key * key, byte * out, word32 * outLen) この関数は、ed448_key構造体から鍵ペアをエクスポートします。鍵ペアをバッファoutに格納し、このバッファに書き込まれたバイト数をoutLenに設定します。
int	wc_ed448_export_key(ed448_key * key, byte * priv, word32 * privSz, byte * pub, word32 * pubSz) この関数は、ed448_key構造体から秘密鍵と公開鍵を個別にエクスポートします。秘密鍵をバッファprivに格納し、このバッファに書き込まれたバイト数をprivSzに設定します。公開鍵をバッファpubに格納し、このバッファに書き込まれたバイト数をpubSzに設定します。
int	wc_ed448_check_key(ed448_key * key) この関数は、ed448_key構造体内の公開鍵が秘密鍵と一致するかチェックします。
int	wc_ed448_size(ed448_key * key) この関数は、Ed448秘密鍵のサイズ（57バイト）を返します。
int	wc_ed448_priv_size(ed448_key * key) この関数は、秘密鍵のサイズ（秘密 + 公開）をバイト単位で返します。
int	wc_ed448_pub_size(ed448_key * key) この関数は、圧縮鍵のサイズをバイト単位で返します（公開鍵）。
int	wc_ed448_sig_size(ed448_key * key) この関数は、Ed448署名のサイズ（バイト単位で114）を返します。

Functions Documentation

function wc_ed448_make_public

int wc_ed448_make_public(
    ed448_key * key,
    unsigned char * pubKey,
    word32 pubKeySz
)

この関数は、秘密鍵からEd448公開鍵を生成します。公開鍵をバッファpubKeyに格納し、このバッファに書き込まれたバイト数をpubKeySzに設定します。

Parameters:

key キーを生成するed448_keyへのポインタ。
out 公開鍵を格納するバッファへのポインタ。
outLen outで利用可能なサイズを持つword32オブジェクトへのポインタ。公開鍵のエクスポートに成功した後、outに書き込まれたバイト数が設定されます。

See:

Return:

0 公開鍵の作成に成功した場合に返されます。
BAD_FUNC_ARG keyまたはpubKeyがNULLと評価された場合、または指定されたキーサイズが57バイトでない場合に返されます（Ed448は57バイトのキーを持ちます）。
MEMORY_E 関数実行中にメモリの割り当てエラーが発生した場合に返されます。

Example

int ret;

ed448_key key;
byte priv[] = { 57バイトの秘密鍵で初期化 };
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) {
    // 公開鍵の作成エラー
}

function wc_ed448_make_key

int wc_ed448_make_key(
    WC_RNG * rng,
    int keysize,
    ed448_key * key
)

この関数は新しいEd448キーを生成し、それをkeyに格納します。

Parameters:

rng キーを生成するために使用する初期化済みRNGオブジェクトへのポインタ。
keysize 生成するキーの長さ。Ed448の場合は常に57である必要があります。
key キーを生成するed448_keyへのポインタ。

See: wc_ed448_init

Return:

0 ed448_keyの作成に成功した場合に返されます。
BAD_FUNC_ARG rngまたはkeyがNULLと評価された場合、または指定されたキーサイズが57バイトでない場合に返されます（Ed448は57バイトのキーを持ちます）。
MEMORY_E 関数実行中にメモリの割り当てエラーが発生した場合に返されます。

Example

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) {
    // キー作成エラー
}

function wc_ed448_sign_msg

int wc_ed448_sign_msg(
    const byte * in,
    word32 inlen,
    byte * out,
    word32 * outlen,
    ed448_key * key
)

この関数は、真正性を保証するためにed448_keyオブジェクトを使用してメッセージに署名します。

Parameters:

in 署名するメッセージを含むバッファへのポインタ。
inlen 署名するメッセージの長さ。
out 生成された署名を格納するバッファ。
outlen 出力バッファの最大長。メッセージ署名の生成に成功した後、outに書き込まれたバイト数が格納されます。
key 署名を生成するために使用する秘密ed448_keyへのポインタ。

See:

Return:

0 メッセージの署名の生成に成功した場合に返されます。
BAD_FUNC_ARG 入力パラメータのいずれかがNULLと評価された場合、または出力バッファが生成された署名を格納するには小さすぎる場合に返されます。
MEMORY_E 関数実行中にメモリの割り当てエラーが発生した場合に返されます。

Example

ed448_key key;
WC_RNG rng;
int ret, sigSz;

byte sig[114]; // 生成された署名を保持
sigSz = sizeof(sig);
byte message[] = { メッセージで初期化 };

wc_InitRng(&rng); // rngを初期化
wc_ed448_init(&key); // keyを初期化
wc_ed448_make_key(&rng, 57, &key); // 公開/秘密鍵ペアを作成
ret = wc_ed448_sign_msg(message, sizeof(message), sig, &sigSz, &key);
if (ret != 0 ) {
    // メッセージ署名の生成エラー
}

function wc_ed448ph_sign_hash

int wc_ed448ph_sign_hash(
    const byte * hash,
    word32 hashLen,
    byte * out,
    word32 * outLen,
    ed448_key * key,
    const byte * context,
    byte contextLen
)

この関数は、真正性を保証するためにed448_keyオブジェクトを使用してメッセージダイジェストに署名します。コンテキストは署名されるデータの一部として含まれます。ハッシュは署名計算前の事前ハッシュ化されたメッセージです。

Parameters:

hash 署名するメッセージのハッシュを含むバッファへのポインタ。
hashLen 署名するメッセージのハッシュの長さ。
out 生成された署名を格納するバッファ。
outlen 出力バッファの最大長。メッセージ署名の生成に成功した後、outに書き込まれたバイト数が格納されます。
key 署名を生成するために使用する秘密ed448_keyへのポインタ。
context メッセージが署名されているコンテキストを含むバッファへのポインタ。
contextLen コンテキストバッファの長さ。

See:

Return:

0 メッセージダイジェストの署名の生成に成功した場合に返されます。
BAD_FUNC_ARG 入力パラメータのいずれかがNULLと評価された場合、または出力バッファが生成された署名を格納するには小さすぎる場合に返されます。
MEMORY_E 関数実行中にメモリの割り当てエラーが発生した場合に返されます。

Example

ed448_key key;
WC_RNG rng;
int ret, sigSz;

byte sig[114]; // 生成された署名を保持
sigSz = sizeof(sig);
byte hash[] = { メッセージのハッシュで初期化 };
byte context[] = { 署名のコンテキストで初期化 };

wc_InitRng(&rng); // rngを初期化
wc_ed448_init(&key); // keyを初期化
wc_ed448_make_key(&rng, 57, &key); // 公開/秘密鍵ペアを作成
ret = wc_ed448ph_sign_hash(hash, sizeof(hash), sig, &sigSz, &key,
        context, sizeof(context));
if (ret != 0) {
    // メッセージ署名の生成エラー
}

function wc_ed448ph_sign_msg

int wc_ed448ph_sign_msg(
    const byte * in,
    word32 inlen,
    byte * out,
    word32 * outlen,
    ed448_key * key,
    const byte * context,
    byte contextLen
)

この関数は、真正性を保証するためにed448_keyオブジェクトを使用してメッセージに署名します。コンテキストは署名されるデータの一部として含まれます。メッセージは署名計算前に事前ハッシュ化されます。

Parameters:

in 署名するメッセージを含むバッファへのポインタ。
inlen 署名するメッセージの長さ。
out 生成された署名を格納するバッファ。
outlen 出力バッファの最大長。メッセージ署名の生成に成功した後、outに書き込まれたバイト数が格納されます。
key 署名を生成するために使用する秘密ed448_keyへのポインタ。
context メッセージが署名されているコンテキストを含むバッファへのポインタ。
contextLen コンテキストバッファの長さ。

See:

Return:

0 メッセージの署名の生成に成功した場合に返されます。
BAD_FUNC_ARG 入力パラメータのいずれかがNULLと評価された場合、または出力バッファが生成された署名を格納するには小さすぎる場合に返されます。
MEMORY_E 関数実行中にメモリの割り当てエラーが発生した場合に返されます。

Example

ed448_key key;
WC_RNG rng;
int ret, sigSz;

byte sig[114]; // 生成された署名を保持
sigSz = sizeof(sig);
byte message[] = { メッセージで初期化 };
byte context[] = { 署名のコンテキストで初期化 };

wc_InitRng(&rng); // rngを初期化
wc_ed448_init(&key); // keyを初期化
wc_ed448_make_key(&rng, 57, &key); // 公開/秘密鍵ペアを作成
ret = wc_ed448ph_sign_msg(message, sizeof(message), sig, &sigSz, &key,
        context, sizeof(context));
if (ret != 0) {
    // メッセージ署名の生成エラー
}

function wc_ed448_verify_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
)

この関数は、真正性を保証するためにメッセージのEd448署名を検証します。コンテキストは検証されるデータの一部として含まれます。答えはresを通じて返され、1は有効な署名に対応し、0は無効な署名に対応します。

Parameters:

sig 検証する署名を含むバッファへのポインタ。
siglen 検証する署名の長さ。
msg 検証するメッセージを含むバッファへのポインタ。
msgLen 検証するメッセージの長さ。
key 署名を検証するために使用する公開Ed448鍵へのポインタ。
context メッセージが署名されたコンテキストを含むバッファへのポインタ。
contextLen コンテキストバッファの長さ。

See:

Return:

0 署名の検証と認証の実行に成功した場合に返されます。
BAD_FUNC_ARG 入力パラメータのいずれかがNULLと評価された場合、またはsiglenが署名の実際の長さと一致しない場合に返されます。
SIG_VERIFY_E 検証は完了したが、生成された署名が提供された署名と一致しない場合に返されます。

Example

ed448_key key;
int ret, verified = 0;

byte sig[] { 受信した署名で初期化 };
byte msg[] = { メッセージで初期化 };
byte context[] = { 署名のコンテキストで初期化 };
// 受信した公開鍵でkeyを初期化
ret = wc_ed448_verify_msg(sig, sizeof(sig), msg, sizeof(msg), &verified,
        &key, context, sizeof(context));
if (ret < 0) {
    // 検証実行エラー
} else if (verified == 0)
    // 署名が無効
}

function wc_ed448ph_verify_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
)

この関数は、真正性を保証するためにメッセージのダイジェストのEd448署名を検証します。コンテキストは検証されるデータの一部として含まれます。ハッシュは署名計算前の事前ハッシュ化されたメッセージです。答えはresを通じて返され、1は有効な署名に対応し、0は無効な署名に対応します。

Parameters:

sig 検証する署名を含むバッファへのポインタ。
siglen 検証する署名の長さ。
hash 検証するメッセージのハッシュを含むバッファへのポインタ。
hashLen 検証するハッシュの長さ。
key 署名を検証するために使用する公開Ed448鍵へのポインタ。
context メッセージが署名されたコンテキストを含むバッファへのポインタ。
contextLen コンテキストバッファの長さ。

See:

Return:

0 署名の検証と認証の実行に成功した場合に返されます。
BAD_FUNC_ARG 入力パラメータのいずれかがNULLと評価された場合、またはsiglenが署名の実際の長さと一致しない場合に返されます。
SIG_VERIFY_E 検証は完了したが、生成された署名が提供された署名と一致しない場合に返されます。

Example

ed448_key key;
int ret, verified = 0;

byte sig[] { 受信した署名で初期化 };
byte hash[] = { メッセージのハッシュで初期化 };
byte context[] = { 署名のコンテキストで初期化 };
// 受信した公開鍵でkeyを初期化
ret = wc_ed448ph_verify_hash(sig, sizeof(sig), hash, sizeof(hash),
        &verified, &key, context, sizeof(context));
if (ret < 0) {
    // 検証実行エラー
} else if (verified == 0)
    // 署名が無効
}

function wc_ed448ph_verify_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
)

この関数は、真正性を保証するためにメッセージのEd448署名を検証します。コンテキストは検証されるデータの一部として含まれます。メッセージは検証前に事前ハッシュ化されます。答えはresを通じて返され、1は有効な署名に対応し、0は無効な署名に対応します。

Parameters:

sig 検証する署名を含むバッファへのポインタ。
siglen 検証する署名の長さ。
msg 検証するメッセージを含むバッファへのポインタ。
msgLen 検証するメッセージの長さ。
key 署名を検証するために使用する公開Ed448鍵へのポインタ。
context メッセージが署名されたコンテキストを含むバッファへのポインタ。
contextLen コンテキストバッファの長さ。

See:

Return:

0 署名の検証と認証の実行に成功した場合に返されます。
BAD_FUNC_ARG 入力パラメータのいずれかがNULLと評価された場合、またはsiglenが署名の実際の長さと一致しない場合に返されます。
SIG_VERIFY_E 検証は完了したが、生成された署名が提供された署名と一致しない場合に返されます。

Example

ed448_key key;
int ret, verified = 0;

byte sig[] { 受信した署名で初期化 };
byte msg[] = { メッセージで初期化 };
byte context[] = { 署名のコンテキストで初期化 };
// 受信した公開鍵でkeyを初期化
ret = wc_ed448ph_verify_msg(sig, sizeof(sig), msg, sizeof(msg), &verified,
        &key, context, sizeof(context));
if (ret < 0) {
    // 検証実行エラー
} else if (verified == 0)
    // 署名が無効
}

function wc_ed448_init

int wc_ed448_init(
    ed448_key * key
)

この関数は、メッセージ検証での将来の使用のためにed448_keyオブジェクトを初期化します。

Parameters:

key 初期化するed448_keyオブジェクトへのポインタ。

See:

Return:

0 ed448_keyオブジェクトの初期化に成功した場合に返されます。
BAD_FUNC_ARG keyがNULLの場合に返されます。

Example

ed448_key key;
wc_ed448_init(&key);

function wc_ed448_free

void wc_ed448_free(
    ed448_key * key
)

この関数は、使用後にEd448オブジェクトを解放します。

Parameters:

key 解放するed448_keyオブジェクトへのポインタ

See: wc_ed448_init

Example

ed448_key key;
// keyを初期化し、安全な交換を実行
...
wc_ed448_free(&key);

function wc_ed448_import_public

int wc_ed448_import_public(
    const byte * in,
    word32 inLen,
    ed448_key * key
)

この関数は、公開鍵を含むバッファから公開ed448_keyペアをインポートします。この関数は、圧縮キーと非圧縮キーの両方を処理します。公開鍵は、秘密鍵が存在する場合にそれと一致するかチェックされます。

Parameters:

in 公開鍵を含むバッファへのポインタ。
inLen 公開鍵を含むバッファの長さ。
key 公開鍵を格納するed448_keyオブジェクトへのポインタ。

See:

Return:

0 ed448_keyのインポートに成功した場合に返されます。
BAD_FUNC_ARG inまたはkeyがNULLと評価された場合、またはinLenがEd448鍵のサイズより小さい場合に返されます。

Example

int ret;
byte pub[] = { Ed448公開鍵で初期化 };

ed_448 key;
wc_ed448_init_key(&key);
ret = wc_ed448_import_public(pub, sizeof(pub), &key);
if (ret != 0) {
    // 鍵のインポートエラー
}

function wc_ed448_import_public_ex

int wc_ed448_import_public_ex(
    const byte * in,
    word32 inLen,
    ed448_key * key,
    int trusted
)

この関数は、公開鍵を含むバッファから公開ed448_keyペアをインポートします。この関数は、圧縮キーと非圧縮キーの両方を処理します。信頼されていない場合、秘密鍵が存在するときに公開鍵が秘密鍵と一致するかチェックします。

Parameters:

in 公開鍵を含むバッファへのポインタ。
inLen 公開鍵を含むバッファの長さ。
key 公開鍵を格納するed448_keyオブジェクトへのポインタ。
trusted 公開鍵データが信頼されているかどうか。

See:

Return:

0 ed448_keyのインポートに成功した場合に返されます。
BAD_FUNC_ARG inまたはkeyがNULLと評価された場合、またはinLenがEd448鍵のサイズより小さい場合に返されます。

Example

int ret;
byte pub[] = { Ed448公開鍵で初期化 };

ed_448 key;
wc_ed448_init_key(&key);
ret = wc_ed448_import_public_ex(pub, sizeof(pub), &key, 1);
if (ret != 0) {
    // 鍵のインポートエラー
}

function wc_ed448_import_private_only

int wc_ed448_import_private_only(
    const byte * priv,
    word32 privSz,
    ed448_key * key
)

この関数は、バッファからEd448秘密鍵のみをインポートします。

Parameters:

priv 秘密鍵を含むバッファへのポインタ。
privSz 秘密鍵の長さ。
key インポートされた秘密鍵を格納するed448_keyオブジェクトへのポインタ。

See:

Return:

0 Ed448秘密鍵のインポートに成功した場合に返されます。
BAD_FUNC_ARG inまたはkeyがNULLと評価された場合、またはprivSzがED448_KEY_SIZEより小さい場合に返されます。

Example

int ret;
byte priv[] = { 57バイトの秘密鍵で初期化 };

ed448_key key;
wc_ed448_init_key(&key);
ret = wc_ed448_import_private_only(priv, sizeof(priv), &key);
if (ret != 0) {
    // 秘密鍵のインポートエラー
}

function wc_ed448_import_private_key

int wc_ed448_import_private_key(
    const byte * priv,
    word32 privSz,
    const byte * pub,
    word32 pubSz,
    ed448_key * key
)

この関数は、一対のバッファから公開/秘密Ed448鍵ペアをインポートします。この関数は、圧縮キーと非圧縮キーの両方を処理します。

Parameters:

priv 秘密鍵を含むバッファへのポインタ。
privSz 秘密鍵の長さ。
pub 公開鍵を含むバッファへのポインタ。
pubSz 公開鍵の長さ。
key インポートされた秘密/公開鍵ペアを格納するed448_keyオブジェクトへのポインタ。

See:

Return:

0 Ed448鍵のインポートに成功した場合に返されます。
BAD_FUNC_ARG inまたはkeyがNULLと評価された場合、またはprivSzがED448_KEY_SIZEより小さい、もしくはpubSzがED448_PUB_KEY_SIZEより小さい場合に返されます。

Example

int ret;
byte priv[] = { 57バイトの秘密鍵で初期化 };
byte pub[]  = { 対応する公開鍵で初期化 };

ed448_key key;
wc_ed448_init_key(&key);
ret = wc_ed448_import_private_key(priv, sizeof(priv), pub, sizeof(pub),
        &key);
if (ret != 0) {
    // 鍵のインポートエラー
}

function wc_ed448_import_private_key_ex

int wc_ed448_import_private_key_ex(
    const byte * priv,
    word32 privSz,
    const byte * pub,
    word32 pubSz,
    ed448_key * key,
    int trusted
)

この関数は、一対のバッファから公開/秘密Ed448鍵ペアをインポートします。この関数は、圧縮キーと非圧縮キーの両方を処理します。信頼されていない場合、公開鍵が秘密鍵に対してチェックされます。

Parameters:

priv 秘密鍵を含むバッファへのポインタ。
privSz 秘密鍵の長さ。
pub 公開鍵を含むバッファへのポインタ。
pubSz 公開鍵の長さ。
key インポートされた秘密/公開鍵ペアを格納するed448_keyオブジェクトへのポインタ。
trusted 公開鍵データが信頼されているかどうか。

See:

Return:

0 Ed448鍵のインポートに成功した場合に返されます。
BAD_FUNC_ARG inまたはkeyがNULLと評価された場合、またはprivSzがED448_KEY_SIZEより小さい、もしくはpubSzがED448_PUB_KEY_SIZEより小さい場合に返されます。

Example

int ret;
byte priv[] = { 57バイトの秘密鍵で初期化 };
byte pub[]  = { 対応する公開鍵で初期化 };

ed448_key key;
wc_ed448_init_key(&key);
ret = wc_ed448_import_private_key_ex(priv, sizeof(priv), pub, sizeof(pub),
        &key, 1);
if (ret != 0) {
    // 鍵のインポートエラー
}

function wc_ed448_export_public

int wc_ed448_export_public(
    ed448_key * key,
    byte * out,
    word32 * outLen
)

この関数は、ed448_key構造体から秘密鍵をエクスポートします。公開鍵をバッファoutに格納し、このバッファに書き込まれたバイト数をoutLenに設定します。

Parameters:

key 公開鍵をエクスポートするed448_key構造体へのポインタ。
out 公開鍵を格納するバッファへのポインタ。
outLen outで利用可能なサイズを持つword32オブジェクトへのポインタ。公開鍵のエクスポートに成功した後、outに書き込まれたバイト数が設定されます。

See:

Return:

0 公開鍵のエクスポートに成功した場合に返されます。
BAD_FUNC_ARG 入力値のいずれかがNULLと評価された場合に返されます。
BUFFER_E 提供されたバッファが秘密鍵を格納するのに十分な大きさでない場合に返されます。このエラーを返す際、関数はoutLenに必要なサイズを設定します。

Example

int ret;
ed448_key key;
// keyを初期化し、keyを作成

char pub[57];
word32 pubSz = sizeof(pub);

ret = wc_ed448_export_public(&key, pub, &pubSz);
if (ret != 0) {
    // 公開鍵のエクスポートエラー
}

function wc_ed448_export_private_only

int wc_ed448_export_private_only(
    ed448_key * key,
    byte * out,
    word32 * outLen
)

この関数は、ed448_key構造体から秘密鍵のみをエクスポートします。秘密鍵をバッファoutに格納し、このバッファに書き込まれたバイト数をoutLenに設定します。

Parameters:

key 秘密鍵をエクスポートするed448_key構造体へのポインタ。
out 秘密鍵を格納するバッファへのポインタ。
outLen outで利用可能なサイズを持つword32オブジェクトへのポインタ。秘密鍵のエクスポートに成功した後、outに書き込まれたバイト数が設定されます。

See:

Return:

0 秘密鍵のエクスポートに成功した場合に返されます。
ECC_BAD_ARG_E 入力値のいずれかがNULLと評価された場合に返されます。
BUFFER_E 提供されたバッファが秘密鍵を格納するのに十分な大きさでない場合に返されます。

Example

int ret;
ed448_key key;
// keyを初期化し、keyを作成

char priv[57]; // 秘密鍵のみなので57バイト
word32 privSz = sizeof(priv);
ret = wc_ed448_export_private_only(&key, priv, &privSz);
if (ret != 0) {
    // 秘密鍵のエクスポートエラー
}

function wc_ed448_export_private

int wc_ed448_export_private(
    ed448_key * key,
    byte * out,
    word32 * outLen
)

この関数は、ed448_key構造体から鍵ペアをエクスポートします。鍵ペアをバッファoutに格納し、このバッファに書き込まれたバイト数をoutLenに設定します。

Parameters:

key 鍵ペアをエクスポートするed448_key構造体へのポインタ。
out 鍵ペアを格納するバッファへのポインタ。
outLen outで利用可能なサイズを持つword32オブジェクトへのポインタ。鍵ペアのエクスポートに成功した後、outに書き込まれたバイト数が設定されます。

See:

wc_ed448_import_private
wc_ed448_export_private_only

Return:

0 鍵ペアのエクスポートに成功した場合に返されます。
ECC_BAD_ARG_E 入力値のいずれかがNULLと評価された場合に返されます。
BUFFER_E 提供されたバッファが鍵ペアを格納するのに十分な大きさでない場合に返されます。

Example

ed448_key key;
wc_ed448_init(&key);

WC_RNG rng;
wc_InitRng(&rng);

wc_ed448_make_key(&rng, 57, &key); // 57バイトのEd448鍵を初期化

byte out[114]; // outは十分なバッファサイズである必要があります
word32 outLen = sizeof(out);
int key_size = wc_ed448_export_private(&key, out, &outLen);
if (key_size == BUFFER_E) {
    // 関数がoutLenをリセットしたかどうかを確認するため、outのサイズとoutLenを比較
}

function wc_ed448_export_key

int wc_ed448_export_key(
    ed448_key * key,
    byte * priv,
    word32 * privSz,
    byte * pub,
    word32 * pubSz
)

この関数は、ed448_key構造体から秘密鍵と公開鍵を個別にエクスポートします。秘密鍵をバッファprivに格納し、このバッファに書き込まれたバイト数をprivSzに設定します。公開鍵をバッファpubに格納し、このバッファに書き込まれたバイト数をpubSzに設定します。

Parameters:

key 鍵ペアをエクスポートするed448_key構造体へのポインタ。
priv 秘密鍵を格納するバッファへのポインタ。
privSz outで利用可能なサイズを持つword32オブジェクトへのポインタ。秘密鍵のエクスポートに成功した後、outに書き込まれたバイト数が設定されます。
pub 公開鍵を格納するバッファへのポインタ。
pubSz outで利用可能なサイズを持つword32オブジェクトへのポインタ。公開鍵のエクスポートに成功した後、outに書き込まれたバイト数が設定されます。

See:

Return:

0 鍵ペアのエクスポートに成功した場合に返されます。
ECC_BAD_ARG_E 入力値のいずれかがNULLと評価された場合に返されます。
BUFFER_E 提供されたバッファが鍵ペアを格納するのに十分な大きさでない場合に返されます。

Example

int ret;
ed448_key key;
// keyを初期化し、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) {
    // 秘密鍵と公開鍵のエクスポートエラー
}

function wc_ed448_check_key

int wc_ed448_check_key(
    ed448_key * key
)

この関数は、ed448_key構造体内の公開鍵が秘密鍵と一致するかチェックします。

Parameters:

key 秘密鍵と公開鍵を保持するed448_key構造体へのポインタ。

See:

Return:

0 秘密鍵と公開鍵が一致した場合に返されます。
BAD_FUNC_ARGS 指定されたkeyがNULLの場合に返されます。

Example

int ret;
byte priv[] = { 57バイトの秘密鍵で初期化 };
byte pub[]  = { 対応する公開鍵で初期化 };

ed448_key key;
wc_ed448_init_key(&key);
wc_ed448_import_private_key_ex(priv, sizeof(priv), pub, sizeof(pub), &key,
    1);
ret = wc_ed448_check_key(&key);
if (ret != 0) {
    // 鍵のチェックエラー
}

function wc_ed448_size

int wc_ed448_size(
    ed448_key * key
)

この関数は、Ed448秘密鍵のサイズ（57バイト）を返します。

Parameters:

key 鍵サイズを取得するed448_key構造体へのポインタ。

See: wc_ed448_make_key

Return:

ED448_KEY_SIZE 有効な秘密鍵のサイズ（57バイト）。
BAD_FUNC_ARGS 指定されたkeyがNULLの場合に返されます。

Example

int keySz;
ed448_key key;
// keyを初期化し、keyを作成
keySz = wc_ed448_size(&key);
if (keySz == 0) {
    // 鍵サイズの決定エラー
}

function wc_ed448_priv_size

int wc_ed448_priv_size(
    ed448_key * key
)

この関数は、秘密鍵のサイズ（秘密 + 公開）をバイト単位で返します。

Parameters:

key 鍵サイズを取得するed448_key構造体へのポインタ。

See: wc_ed448_pub_size

Return:

ED448_PRV_KEY_SIZE 秘密鍵のサイズ（114バイト）。
BAD_FUNC_ARG key引数がNULLの場合に返されます。

Example

ed448_key key;
wc_ed448_init(&key);

WC_RNG rng;
wc_InitRng(&rng);

wc_ed448_make_key(&rng, 57, &key); // 57バイトのEd448鍵を初期化
int key_size = wc_ed448_priv_size(&key);

function wc_ed448_pub_size

int wc_ed448_pub_size(
    ed448_key * key
)

この関数は、圧縮鍵のサイズをバイト単位で返します（公開鍵）。

Parameters:

key 鍵サイズを取得するed448_key構造体へのポインタ。

See: wc_ed448_priv_size

Return:

ED448_PUB_KEY_SIZE 圧縮公開鍵のサイズ（57バイト）。
BAD_FUNC_ARG key引数がNULLの場合に返されます。

Example

ed448_key key;
wc_ed448_init(&key);
WC_RNG rng;
wc_InitRng(&rng);

wc_ed448_make_key(&rng, 57, &key); // 57バイトのEd448鍵を初期化
int key_size = wc_ed448_pub_size(&key);

function wc_ed448_sig_size

int wc_ed448_sig_size(
    ed448_key * key
)

この関数は、Ed448署名のサイズ（バイト単位で114）を返します。

Parameters:

key 署名サイズを取得するed448_key構造体へのポインタ。

See: wc_ed448_sign_msg

Return:

ED448_SIG_SIZE Ed448署名のサイズ（114バイト）。
BAD_FUNC_ARG key引数がNULLの場合に返されます。

Example

int sigSz;
ed448_key key;
// keyを初期化し、keyを作成

sigSz = wc_ed448_sig_size(&key);
if (sigSz == 0) {
    // 署名サイズの決定エラー
}

Source code


int wc_ed448_make_public(ed448_key* key, unsigned char* pubKey,
                         word32 pubKeySz);

int wc_ed448_make_key(WC_RNG* rng, int keysize, ed448_key* key);

int wc_ed448_sign_msg(const byte* in, word32 inlen, byte* out,
                        word32 *outlen, ed448_key* key);

int wc_ed448ph_sign_hash(const byte* hash, word32 hashLen, byte* out,
                         word32 *outLen, ed448_key* key,
                         const byte* context, byte contextLen);

int wc_ed448ph_sign_msg(const byte* in, word32 inlen, byte* out,
                        word32 *outlen, ed448_key* key,
                        const byte* context, byte contextLen);

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);

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);

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);

int wc_ed448_init(ed448_key* key);

void wc_ed448_free(ed448_key* key);

int wc_ed448_import_public(const byte* in, word32 inLen, ed448_key* key);

int wc_ed448_import_public_ex(const byte* in, word32 inLen, ed448_key* key,
    int trusted);

int wc_ed448_import_private_only(const byte* priv, word32 privSz,
                                 ed448_key* key);

int wc_ed448_import_private_key(const byte* priv, word32 privSz,
                               const byte* pub, word32 pubSz, ed448_key* key);

int wc_ed448_import_private_key_ex(const byte* priv, word32 privSz,
    const byte* pub, word32 pubSz, ed448_key* key, int trusted);

int wc_ed448_export_public(ed448_key* key, byte* out, word32* outLen);

int wc_ed448_export_private_only(ed448_key* key, byte* out, word32* outLen);

int wc_ed448_export_private(ed448_key* key, byte* out, word32* outLen);

int wc_ed448_export_key(ed448_key* key,
                          byte* priv, word32 *privSz,
                          byte* pub, word32 *pubSz);

int wc_ed448_check_key(ed448_key* key);


int wc_ed448_size(ed448_key* key);

int wc_ed448_priv_size(ed448_key* key);

int wc_ed448_pub_size(ed448_key* key);

int wc_ed448_sig_size(ed448_key* key);

Updated on 2025-12-12 at 03:08:17 +0000