#include "secp256k1.h"

Include dependency graph for secp256k1_ecdh.h:

This graph shows which files directly or indirectly include this file:

Typedefs
typedef int(*	secp256k1_ecdh_hash_function) (unsigned char output, const unsigned char x32, const unsigned char y32, void data)

Functions
SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int	secp256k1_ecdh (const secp256k1_context ctx, unsigned char output, const secp256k1_pubkey pubkey, const unsigned char seckey, secp256k1_ecdh_hash_function hashfp, void *data) SECP256K1_ARG_NONNULL(1) SECP256K1_ARG_NONNULL(2) SECP256K1_ARG_NONNULL(3) SECP256K1_ARG_NONNULL(4)

Variables
SECP256K1_API const secp256k1_ecdh_hash_function	secp256k1_ecdh_hash_function_sha256

SECP256K1_API const secp256k1_ecdh_hash_function	secp256k1_ecdh_hash_function_default

Typedef Documentation

◆ secp256k1_ecdh_hash_function

typedef int(* secp256k1_ecdh_hash_function) (unsigned char *output, const unsigned char *x32, const unsigned char *y32, void *data)

A pointer to a function that hashes an EC point to obtain an ECDH secret

Returns: 1 if the point was successfully hashed. 0 will cause secp256k1_ecdh to fail and return 0. Other return values are not allowed, and the behaviour of secp256k1_ecdh is undefined for other return values. Out: output: pointer to an array to be filled by the function In: x32: pointer to a 32-byte x coordinate y32: pointer to a 32-byte y coordinate data: arbitrary data pointer that is passed through

Definition at line 21 of file secp256k1_ecdh.h.

Function Documentation

◆ secp256k1_ecdh()

SECP256K1_API SECP256K1_WARN_UNUSED_RESULT int secp256k1_ecdh	(	const secp256k1_context *	ctx,
		unsigned char *	output,
		const secp256k1_pubkey *	pubkey,
		const unsigned char *	seckey,
		secp256k1_ecdh_hash_function	hashfp,
		void *	data )

Compute an EC Diffie-Hellman secret in constant time

Returns: 1: exponentiation was successful 0: scalar was invalid (zero or overflow) or hashfp returned 0 Args: ctx: pointer to a context object. Out: output: pointer to an array to be filled by hashfp. In: pubkey: a pointer to a secp256k1_pubkey containing an initialized public key. seckey: 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 (in which case, 32 bytes will be written to output). data: arbitrary data pointer that is passed through to hashfp (can be NULL for secp256k1_ecdh_hash_function_sha256).

Definition at line 29 of file main_impl.h.

                                                                                                                                                                                     {
    int ret = 0;
    int overflow = 0;
    secp256k1_gej res;
    secp256k1_ge pt;
    secp256k1_scalar s;
    unsigned char x[32];
    unsigned char y[32];
 
    VERIFY_CHECK(ctx != NULL);
    ARG_CHECK(output != NULL);
    ARG_CHECK(point != NULL);
    ARG_CHECK(scalar != NULL);
 
    if (hashfp == NULL) {
        hashfp = secp256k1_ecdh_hash_function_default;
    }
 
    secp256k1_pubkey_load(ctx, &pt, point);
    secp256k1_scalar_set_b32(&s, scalar, &overflow);
 
    overflow |= secp256k1_scalar_is_zero(&s);
    secp256k1_scalar_cmov(&s, &secp256k1_scalar_one, overflow);
 
    secp256k1_ecmult_const(&res, &pt, &s, 256);
    secp256k1_ge_set_gej(&pt, &res);
 
    /* Compute a hash of the point */
    secp256k1_fe_normalize(&pt.x);
    secp256k1_fe_normalize(&pt.y);
    secp256k1_fe_get_b32(x, &pt.x);
    secp256k1_fe_get_b32(y, &pt.y);
 
    ret = hashfp(output, x, y, data);
 
    memset(x, 0, 32);
    memset(y, 0, 32);
    secp256k1_scalar_clear(&s);
 
    return !!ret & !overflow;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

◆ secp256k1_ecdh_hash_function_default

SECP256K1_API const secp256k1_ecdh_hash_function secp256k1_ecdh_hash_function_default

extern

A default ECDH hash function (currently equal to secp256k1_ecdh_hash_function_sha256). Populates the output parameter with 32 bytes.

Definition at line 27 of file main_impl.h.

◆ secp256k1_ecdh_hash_function_sha256

SECP256K1_API const secp256k1_ecdh_hash_function secp256k1_ecdh_hash_function_sha256

extern

An implementation of SHA256 hash function that applies to compressed public key. Populates the output parameter with 32 bytes.

Definition at line 26 of file main_impl.h.

Typedefs

Functions