frost/secp256k1-zkp
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Make tweak function documentation more consistent.

Browse Source 
Do this by adding a newline after the first sentence and aligning the rest.
This commit is contained in:
Jonas Nick 2020-03-19 21:52:37 +00:00
parent 41fc785602
commit 89853a0f2e
1 changed files with 43 additions and 38 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

81
include/secp256k1.h
View File

@ -616,17 +616,18 @@ SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ec_pubkey_negate(
) SECP256K1_ARG_NONNULL(1) SECP256K1_ARG_NONNULL(2); ) SECP256K1_ARG_NONNULL(1) SECP256K1_ARG_NONNULL(2);
/** Tweak a secret key by adding tweak to it. /** Tweak a secret key by adding tweak to it.
* Returns: 0 if the resulting secret key would be invalid (only when the tweak *
* is the negation of the secret key). 1 otherwise. * Returns: 0 if the resulting secret key would be invalid (only when the tweak
* Args: ctx: pointer to a context object (cannot be NULL). * is the negation of the secret key). 1 otherwise.
* In/Out: seckey: pointer to a 32-byte secret key. The secret key should be * Args: ctx: pointer to a context object (cannot be NULL).
* valid according to secp256k1_ec_seckey_verify. If this * In/Out: seckey: pointer to a 32-byte secret key. The secret key should be
* function returns 0, seckey will be some unspecified * valid according to secp256k1_ec_seckey_verify. If this
* value. (cannot be NULL) * function returns 0, seckey will be some unspecified
* In: tweak: pointer to a 32-byte tweak. Must be in the same range as secret * value. (cannot be NULL)
* keys (see secp256k1_ec_seckey_verify). For uniformly random * In: tweak: pointer to a 32-byte tweak. Must be in the same range as secret
* 32-byte arrays the chance of being out of range is * keys (see secp256k1_ec_seckey_verify). For uniformly random
* negligible (around 1 in 2^128). (cannot be NULL) * 32-byte arrays the chance of being out of range is
* negligible (around 1 in 2^128). (cannot be NULL)
*/ */
SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ec_seckey_tweak_add( SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ec_seckey_tweak_add(
const secp256k1_context* ctx, const secp256k1_context* ctx,
@ -643,16 +644,17 @@ SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ec_privkey_tweak_add(
) SECP256K1_ARG_NONNULL(1) SECP256K1_ARG_NONNULL(2) SECP256K1_ARG_NONNULL(3); ) SECP256K1_ARG_NONNULL(1) SECP256K1_ARG_NONNULL(2) SECP256K1_ARG_NONNULL(3);
/** Tweak a public key by adding tweak times the generator to it. /** Tweak a public key by adding tweak times the generator to it.
* Returns: 0 if the resulting public key would be invalid (only when the tweak *
* is the negation of the corresponding secret key). 1 otherwise. * Returns: 0 if the resulting public key would be invalid (only when the tweak
* Args: ctx: pointer to a context object initialized for validation * is the negation of the corresponding secret key). 1 otherwise.
* (cannot be NULL). * Args: ctx: pointer to a context object initialized for validation
* In/Out: pubkey: pointer to a public key object. If this function returns 0, * (cannot be NULL).
* pubkey will be invalid. (cannot be NULL). * In/Out: pubkey: pointer to a public key object. If this function returns 0,
* In: tweak: pointer to a 32-byte tweak. Must be in the same range as secret * pubkey will be invalid. (cannot be NULL).
* keys (see secp256k1_ec_seckey_verify). For uniformly random * In: tweak: pointer to a 32-byte tweak. Must be in the same range as secret
* 32-byte arrays the chance of being out of range is * keys (see secp256k1_ec_seckey_verify). For uniformly random
* negligible (around 1 in 2^128). (cannot be NULL) * 32-byte arrays the chance of being out of range is
* negligible (around 1 in 2^128). (cannot be NULL)
*/ */
SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ec_pubkey_tweak_add( SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ec_pubkey_tweak_add(
const secp256k1_context* ctx, const secp256k1_context* ctx,
@ -661,14 +663,15 @@ SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ec_pubkey_tweak_add(
) SECP256K1_ARG_NONNULL(1) SECP256K1_ARG_NONNULL(2) SECP256K1_ARG_NONNULL(3); ) SECP256K1_ARG_NONNULL(1) SECP256K1_ARG_NONNULL(2) SECP256K1_ARG_NONNULL(3);
/** Tweak a secret key by multiplying it by a tweak. /** Tweak a secret key by multiplying it by a tweak.
* Returns: 0 if the arguments are invalid.. 1 otherwise. *
* Args: ctx: pointer to a context object (cannot be NULL). * Returns: 0 if the arguments are invalid.. 1 otherwise.
* In/Out: seckey: pointer to a 32-byte secret key. If this function returns 0, * Args: ctx: pointer to a context object (cannot be NULL).
* seckey will be some unspecified value. (cannot be NULL). * In/Out: seckey: pointer to a 32-byte secret key. If this function returns 0,
* In: tweak: pointer to a 32-byte tweak. Must be in the same range as secret * seckey will be some unspecified value. (cannot be NULL).
* keys (see secp256k1_ec_seckey_verify). For uniformly random * In: tweak: pointer to a 32-byte tweak. Must be in the same range as secret
* 32-byte arrays the chance of being out of range is * keys (see secp256k1_ec_seckey_verify). For uniformly random
* negligible (around 1 in 2^128). (cannot be NULL) * 32-byte arrays the chance of being out of range is
* negligible (around 1 in 2^128). (cannot be NULL)
*/ */
SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ec_seckey_tweak_mul( SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ec_seckey_tweak_mul(
const secp256k1_context* ctx, const secp256k1_context* ctx,
@ -685,15 +688,16 @@ SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ec_privkey_tweak_mul(
) SECP256K1_ARG_NONNULL(1) SECP256K1_ARG_NONNULL(2) SECP256K1_ARG_NONNULL(3); ) SECP256K1_ARG_NONNULL(1) SECP256K1_ARG_NONNULL(2) SECP256K1_ARG_NONNULL(3);
/** Tweak a public key by multiplying it by a tweak value. /** Tweak a public key by multiplying it by a tweak value.
* Returns: 0 if the arguments are invalid. 1 otherwise. *
* Args: ctx: pointer to a context object initialized for validation * Returns: 0 if the arguments are invalid. 1 otherwise.
* (cannot be NULL). * Args: ctx: pointer to a context object initialized for validation
* In/Out: pubkey: pointer to a public key object. If this function returns 0, * (cannot be NULL).
* pubkey will be invalid. (cannot be NULL). * In/Out: pubkey: pointer to a public key object. If this function returns 0,
* In: tweak: pointer to a 32-byte tweak. Must be in the same range as secret * pubkey will be invalid. (cannot be NULL).
* keys (see secp256k1_ec_seckey_verify). For uniformly random * In: tweak: pointer to a 32-byte tweak. Must be in the same range as secret
* 32-byte arrays the chance of being out of range is * keys (see secp256k1_ec_seckey_verify). For uniformly random
* negligible (around 1 in 2^128). (cannot be NULL) * 32-byte arrays the chance of being out of range is
* negligible (around 1 in 2^128). (cannot be NULL)
*/ */
SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ec_pubkey_tweak_mul( SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ec_pubkey_tweak_mul(
const secp256k1_context* ctx, const secp256k1_context* ctx,
@ -732,6 +736,7 @@ SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_context_randomize(
) SECP256K1_ARG_NONNULL(1); ) SECP256K1_ARG_NONNULL(1);
/** Add a number of public keys together. /** Add a number of public keys together.
*
* Returns: 1: the sum of the public keys is valid. * Returns: 1: the sum of the public keys is valid.
* 0: the sum of the public keys is not valid. * 0: the sum of the public keys is not valid.
* Args: ctx: pointer to a context object * Args: ctx: pointer to a context object