ECDH

[<Interface>]
type ECDH =
    abstract member computeSecret (otherPublicKey: string, inputEncoding: BinaryToTextEncoding, outputEncoding: BinaryToTextEncoding) : string
    abstract member computeSecret (otherPublicKey: U12<BigInt64Array<U2<ArrayBuffer,SharedArrayBuffer>>,BigUint64Array<U2<ArrayBuffer,SharedArrayBuffer>>,DataView<U2<ArrayBuffer,SharedArrayBuffer>>,Float32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Float64Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int16Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int8Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint16Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint8Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint8ClampedArray<U2<ArrayBuffer,SharedArrayBuffer>>>, outputEncoding: BinaryToTextEncoding) : string
    abstract member computeSecret (otherPublicKey: string, inputEncoding: BinaryToTextEncoding) : NonSharedBuffer
    abstract member computeSecret (otherPublicKey: U12<BigInt64Array<U2<ArrayBuffer,SharedArrayBuffer>>,BigUint64Array<U2<ArrayBuffer,SharedArrayBuffer>>,DataView<U2<ArrayBuffer,SharedArrayBuffer>>,Float32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Float64Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int16Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int8Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint16Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint8Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint8ClampedArray<U2<ArrayBuffer,SharedArrayBuffer>>>) : NonSharedBuffer
    static member convertKey (key: BinaryLike, curve: string, ?inputEncoding: BinaryToTextEncoding, ?outputEncoding: OutputEncoding, ?format: ECDHKeyFormat) : U2<string,NonSharedBuffer>
    abstract member generateKeys (encoding: BinaryToTextEncoding, ?format: ECDHKeyFormat) : string
    abstract member generateKeys () : NonSharedBuffer
    abstract member getPrivateKey (encoding: BinaryToTextEncoding) : string
    abstract member getPrivateKey () : NonSharedBuffer
    abstract member getPublicKey (encoding: BinaryToTextEncoding, ?format: ECDHKeyFormat) : string
    abstract member getPublicKey (?encoding: unit, ?format: ECDHKeyFormat) : NonSharedBuffer
    abstract member setPrivateKey (privateKey: string, encoding: BinaryToTextEncoding) : unit
    abstract member setPrivateKey (privateKey: U12<BigInt64Array<U2<ArrayBuffer,SharedArrayBuffer>>,BigUint64Array<U2<ArrayBuffer,SharedArrayBuffer>>,DataView<U2<ArrayBuffer,SharedArrayBuffer>>,Float32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Float64Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int16Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int8Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint16Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint8Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint8ClampedArray<U2<ArrayBuffer,SharedArrayBuffer>>>) : unit


Assembly	`Xantham.Fable.Node`
Attributes	`[<Interface>]`

The ECDH class is a utility for creating Elliptic Curve Diffie-Hellman (ECDH) key exchanges.

Instances of the ECDH class can be created using the createECDH function.

import assert from 'node:assert';

const {
createECDH,
} = await import('node:crypto');

// Generate Alice's keys...
const alice = createECDH('secp521r1');
const aliceKey = alice.generateKeys();

// Generate Bob's keys...
const bob = createECDH('secp521r1');
const bobKey = bob.generateKeys();

// Exchange and generate the secret...
const aliceSecret = alice.computeSecret(bobKey);
const bobSecret = bob.computeSecret(aliceKey);

assert.strictEqual(aliceSecret.toString('hex'), bobSecret.toString('hex'));
// OK

@since v0.11.14

Declared inside


`ConvertKey`

Methods

abstract member computeSecret (otherPublicKey: string, inputEncoding: BinaryToTextEncoding, outputEncoding: BinaryToTextEncoding) : string

Computes the shared secret using otherPublicKey as the other party's public key and returns the computed shared secret. The supplied key is interpreted using specified inputEncoding, and the returned secret is encoded using the specified outputEncoding. If the inputEncoding is not provided, otherPublicKey is expected to be a Buffer, TypedArray, or DataView.

If outputEncoding is given a string will be returned; otherwise a Buffer is returned.

ecdh.computeSecret will throw anERR_CRYPTO_ECDH_INVALID_PUBLIC_KEY error when otherPublicKey lies outside of the elliptic curve. Since otherPublicKey is usually supplied from a remote user over an insecure network, be sure to handle this exception accordingly.

@since v0.11.14

Parameter
`inputEncoding`	The `encoding` of the `otherPublicKey` string.
`outputEncoding`	The `encoding` of the return value.

abstract member computeSecret (otherPublicKey: U12<BigInt64Array<U2<ArrayBuffer,SharedArrayBuffer>>,BigUint64Array<U2<ArrayBuffer,SharedArrayBuffer>>,DataView<U2<ArrayBuffer,SharedArrayBuffer>>,Float32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Float64Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int16Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int8Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint16Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint8Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint8ClampedArray<U2<ArrayBuffer,SharedArrayBuffer>>>, outputEncoding: BinaryToTextEncoding) : string

If outputEncoding is given a string will be returned; otherwise a Buffer is returned.

@since v0.11.14

Parameter
`inputEncoding`	The `encoding` of the `otherPublicKey` string.
`outputEncoding`	The `encoding` of the return value.

abstract member computeSecret (otherPublicKey: string, inputEncoding: BinaryToTextEncoding) : NonSharedBuffer

If outputEncoding is given a string will be returned; otherwise a Buffer is returned.

@since v0.11.14

Parameter
`inputEncoding`	The `encoding` of the `otherPublicKey` string.
`outputEncoding`	The `encoding` of the return value.

abstract member computeSecret (otherPublicKey: U12<BigInt64Array<U2<ArrayBuffer,SharedArrayBuffer>>,BigUint64Array<U2<ArrayBuffer,SharedArrayBuffer>>,DataView<U2<ArrayBuffer,SharedArrayBuffer>>,Float32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Float64Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int16Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int8Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint16Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint8Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint8ClampedArray<U2<ArrayBuffer,SharedArrayBuffer>>>) : NonSharedBuffer

If outputEncoding is given a string will be returned; otherwise a Buffer is returned.

@since v0.11.14

Parameter
`inputEncoding`	The `encoding` of the `otherPublicKey` string.
`outputEncoding`	The `encoding` of the return value.

static member convertKey (key: BinaryLike, curve: string, ?inputEncoding: BinaryToTextEncoding, ?outputEncoding: OutputEncoding, ?format: ECDHKeyFormat) : U2<string,NonSharedBuffer>

Converts the EC Diffie-Hellman public key specified by key and curve to the format specified by format. The format argument specifies point encoding and can be 'compressed', 'uncompressed' or 'hybrid'. The supplied key is interpreted using the specified inputEncoding, and the returned key is encoded using the specified outputEncoding.

Use getCurves to obtain a list of available curve names. On recent OpenSSL releases, openssl ecparam -list_curves will also display the name and description of each available elliptic curve.

If format is not specified the point will be returned in 'uncompressed' format.

If the inputEncoding is not provided, key is expected to be a Buffer, TypedArray, or DataView.

Example (uncompressing a key):

const {
createECDH,
ECDH,
} = await import('node:crypto');

const ecdh = createECDH('secp256k1');
ecdh.generateKeys();

const compressedKey = ecdh.getPublicKey('hex', 'compressed');

const uncompressedKey = ECDH.convertKey(compressedKey,
'secp256k1',
'hex',
'hex',
'uncompressed');

// The converted key and the uncompressed public key should be the same
console.log(uncompressedKey === ecdh.getPublicKey('hex'));

@since v10.0.0

Parameter
`inputEncoding`	The `encoding` of the `key` string.
`outputEncoding`	The `encoding` of the return value.

abstract member generateKeys (encoding: BinaryToTextEncoding, ?format: ECDHKeyFormat) : string

Generates private and public EC Diffie-Hellman key values, and returns the public key in the specified format and encoding. This key should be transferred to the other party.

The format argument specifies point encoding and can be 'compressed' or 'uncompressed'. If format is not specified, the point will be returned in'uncompressed' format.

If encoding is provided a string is returned; otherwise a Buffer is returned.

@since v0.11.14

Parameter
`encoding`	The `encoding` of the return value.

abstract member generateKeys () : NonSharedBuffer

Generates private and public EC Diffie-Hellman key values, and returns the public key in the specified format and encoding. This key should be transferred to the other party.

The format argument specifies point encoding and can be 'compressed' or 'uncompressed'. If format is not specified, the point will be returned in'uncompressed' format.

If encoding is provided a string is returned; otherwise a Buffer is returned.

@since v0.11.14

Parameter
`encoding`	The `encoding` of the return value.

abstract member getPrivateKey (encoding: BinaryToTextEncoding) : string

If encoding is specified, a string is returned; otherwise a Buffer is returned.

@since v0.11.14

Parameter
`encoding`	The `encoding` of the return value.

Returns. The EC Diffie-Hellman in the specified encoding.

abstract member getPrivateKey () : NonSharedBuffer

If encoding is specified, a string is returned; otherwise a Buffer is returned.

@since v0.11.14

Parameter
`encoding`	The `encoding` of the return value.

Returns. The EC Diffie-Hellman in the specified encoding.

abstract member getPublicKey (encoding: BinaryToTextEncoding, ?format: ECDHKeyFormat) : string

The format argument specifies point encoding and can be 'compressed' or 'uncompressed'. If format is not specified the point will be returned in'uncompressed' format.

If encoding is specified, a string is returned; otherwise a Buffer is returned.

@since v0.11.14

Parameter
`encoding`	The `encoding` of the return value.

Returns. The EC Diffie-Hellman public key in the specified encoding and format.

abstract member getPublicKey (?encoding: unit, ?format: ECDHKeyFormat) : NonSharedBuffer

The format argument specifies point encoding and can be 'compressed' or 'uncompressed'. If format is not specified the point will be returned in'uncompressed' format.

If encoding is specified, a string is returned; otherwise a Buffer is returned.

@since v0.11.14

Parameter
`encoding`	The `encoding` of the return value.

Returns. The EC Diffie-Hellman public key in the specified encoding and format.

abstract member setPrivateKey (privateKey: string, encoding: BinaryToTextEncoding) : unit

Sets the EC Diffie-Hellman private key. If encoding is provided, privateKey is expected to be a string; otherwise privateKey is expected to be a Buffer, TypedArray, or DataView.

If privateKey is not valid for the curve specified when the ECDH object was created, an error is thrown. Upon setting the private key, the associated public point (key) is also generated and set in the ECDH object.

@since v0.11.14

Parameter
`encoding`	The `encoding` of the `privateKey` string.

abstract member setPrivateKey (privateKey: U12<BigInt64Array<U2<ArrayBuffer,SharedArrayBuffer>>,BigUint64Array<U2<ArrayBuffer,SharedArrayBuffer>>,DataView<U2<ArrayBuffer,SharedArrayBuffer>>,Float32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Float64Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int16Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Int8Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint16Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint32Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint8Array<U2<ArrayBuffer,SharedArrayBuffer>>,Uint8ClampedArray<U2<ArrayBuffer,SharedArrayBuffer>>>) : unit

Sets the EC Diffie-Hellman private key. If encoding is provided, privateKey is expected to be a string; otherwise privateKey is expected to be a Buffer, TypedArray, or DataView.

@since v0.11.14

Parameter
`encoding`	The `encoding` of the `privateKey` string.