2018-07-09 11:17:44 +00:00
|
|
|
#ifndef SECP256K1_ECDH_H
|
|
|
|
#define SECP256K1_ECDH_H
|
2015-10-26 14:54:21 +00:00
|
|
|
|
2018-07-09 11:17:44 +00:00
|
|
|
#include "secp256k1.h"
|
2015-10-26 14:54:21 +00:00
|
|
|
|
2018-07-09 11:17:44 +00:00
|
|
|
#ifdef __cplusplus
|
2015-10-26 14:54:21 +00:00
|
|
|
extern "C" {
|
2018-07-09 11:17:44 +00:00
|
|
|
#endif
|
2015-10-26 14:54:21 +00:00
|
|
|
|
2018-11-06 21:36:43 +00:00
|
|
|
/** A pointer to a function that applies hash function to a point
|
|
|
|
*
|
|
|
|
* Returns: 1 if a point was successfully hashed. 0 will cause ecdh to fail
|
|
|
|
* Out: output: pointer to an array to be filled by the function
|
|
|
|
* In: x: pointer to a 32-byte x coordinate
|
|
|
|
* y: pointer to a 32-byte y coordinate
|
|
|
|
* data: Arbitrary data pointer that is passed through
|
|
|
|
*/
|
|
|
|
typedef int (*secp256k1_ecdh_hash_function)(
|
|
|
|
unsigned char *output,
|
|
|
|
const unsigned char *x,
|
|
|
|
const unsigned char *y,
|
|
|
|
void *data
|
|
|
|
);
|
|
|
|
|
|
|
|
/** An implementation of SHA256 hash function that applies to compressed public key. */
|
|
|
|
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). */
|
|
|
|
SECP256K1_API extern const secp256k1_ecdh_hash_function secp256k1_ecdh_hash_function_default;
|
|
|
|
|
2015-10-26 14:54:21 +00:00
|
|
|
/** Compute an EC Diffie-Hellman secret in constant time
|
|
|
|
* Returns: 1: exponentiation was successful
|
|
|
|
* 0: scalar was invalid (zero or overflow)
|
|
|
|
* Args: ctx: pointer to a context object (cannot be NULL)
|
2018-11-06 21:36:43 +00:00
|
|
|
* Out: output: pointer to an array to be filled by the function
|
2015-10-26 14:54:21 +00:00
|
|
|
* In: pubkey: a pointer to a secp256k1_pubkey containing an
|
|
|
|
* initialized public key
|
|
|
|
* privkey: a 32-byte scalar with which to multiply the point
|
2018-11-06 21:36:43 +00:00
|
|
|
* hashfp: pointer to a hash function. If NULL, secp256k1_ecdh_hash_function_sha256 is used
|
|
|
|
* data: Arbitrary data pointer that is passed through
|
2015-10-26 14:54:21 +00:00
|
|
|
*/
|
|
|
|
SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ecdh(
|
|
|
|
const secp256k1_context* ctx,
|
2018-11-06 21:36:43 +00:00
|
|
|
unsigned char *output,
|
2015-10-26 14:54:21 +00:00
|
|
|
const secp256k1_pubkey *pubkey,
|
2018-11-06 21:36:43 +00:00
|
|
|
const unsigned char *privkey,
|
|
|
|
secp256k1_ecdh_hash_function hashfp,
|
|
|
|
void *data
|
2015-10-26 14:54:21 +00:00
|
|
|
) SECP256K1_ARG_NONNULL(1) SECP256K1_ARG_NONNULL(2) SECP256K1_ARG_NONNULL(3) SECP256K1_ARG_NONNULL(4);
|
|
|
|
|
2018-07-09 11:17:44 +00:00
|
|
|
#ifdef __cplusplus
|
2015-10-26 14:54:21 +00:00
|
|
|
}
|
|
|
|
#endif
|
2018-07-09 11:17:44 +00:00
|
|
|
|
|
|
|
#endif /* SECP256K1_ECDH_H */
|