Changeset View
Changeset View
Standalone View
Standalone View
src/secp256k1/include/secp256k1_ecdh.h
| Show All 16 Lines | |||||
| */ | */ | ||||
| typedef int (*secp256k1_ecdh_hash_function)( | typedef int (*secp256k1_ecdh_hash_function)( | ||||
| unsigned char *output, | unsigned char *output, | ||||
| const unsigned char *x, | const unsigned char *x, | ||||
| const unsigned char *y, | const unsigned char *y, | ||||
| void *data | void *data | ||||
| ); | ); | ||||
| /** An implementation of SHA256 hash function that applies to compressed public key. */ | /** An implementation of SHA256 hash function that applies to compressed public key. | ||||
| * Populates the output parameter with 32 bytes. */ | |||||
| SECP256K1_API extern const secp256k1_ecdh_hash_function secp256k1_ecdh_hash_function_sha256; | SECP256K1_API extern const secp256k1_ecdh_hash_function secp256k1_ecdh_hash_function_sha256; | ||||
| /** A default ecdh hash function (currently equal to secp256k1_ecdh_hash_function_sha256). */ | /** A default ecdh hash function (currently equal to secp256k1_ecdh_hash_function_sha256). | ||||
| * Populates the output parameter with 32 bytes. */ | |||||
| SECP256K1_API extern const secp256k1_ecdh_hash_function secp256k1_ecdh_hash_function_default; | SECP256K1_API extern const secp256k1_ecdh_hash_function secp256k1_ecdh_hash_function_default; | ||||
| /** Compute an EC Diffie-Hellman secret in constant time | /** Compute an EC Diffie-Hellman secret in constant time | ||||
| * Returns: 1: exponentiation was successful | * Returns: 1: exponentiation was successful | ||||
| * 0: scalar was invalid (zero or overflow) | * 0: scalar was invalid (zero or overflow) | ||||
| * Args: ctx: pointer to a context object (cannot be NULL) | * Args: ctx: pointer to a context object (cannot be NULL) | ||||
| * Out: output: pointer to an array to be filled by the function | * Out: output: pointer to an array to be filled by hashfp | ||||
| * In: pubkey: a pointer to a secp256k1_pubkey containing an | * In: pubkey: a pointer to a secp256k1_pubkey containing an | ||||
| * initialized public key | * initialized public key | ||||
| * privkey: a 32-byte scalar with which to multiply the point | * privkey: a 32-byte scalar with which to multiply the point | ||||
| * hashfp: pointer to a hash function. If NULL, secp256k1_ecdh_hash_function_sha256 is used | * hashfp: pointer to a hash function. If NULL, secp256k1_ecdh_hash_function_sha256 is used | ||||
| * data: Arbitrary data pointer that is passed through | * (in which case, 32 bytes will be written to output) | ||||
| * data: Arbitrary data pointer that is passed through to hashfp | |||||
| */ | */ | ||||
| SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ecdh( | SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ecdh( | ||||
| const secp256k1_context* ctx, | const secp256k1_context* ctx, | ||||
| unsigned char *output, | unsigned char *output, | ||||
| const secp256k1_pubkey *pubkey, | const secp256k1_pubkey *pubkey, | ||||
| const unsigned char *privkey, | const unsigned char *privkey, | ||||
| secp256k1_ecdh_hash_function hashfp, | secp256k1_ecdh_hash_function hashfp, | ||||
| void *data | void *data | ||||
| ) SECP256K1_ARG_NONNULL(1) SECP256K1_ARG_NONNULL(2) SECP256K1_ARG_NONNULL(3) SECP256K1_ARG_NONNULL(4); | ) SECP256K1_ARG_NONNULL(1) SECP256K1_ARG_NONNULL(2) SECP256K1_ARG_NONNULL(3) SECP256K1_ARG_NONNULL(4); | ||||
| #ifdef __cplusplus | #ifdef __cplusplus | ||||
| } | } | ||||
| #endif | #endif | ||||
| #endif /* SECP256K1_ECDH_H */ | #endif /* SECP256K1_ECDH_H */ | ||||