function generatePrime
Usage in Deno
import { generatePrime } from "node:crypto";
generatePrime(size: number,callback: (err: Error | null,prime: ArrayBuffer,) => void,): void
Generates a pseudorandom prime of size
bits.
If options.safe
is true
, the prime will be a safe prime -- that is,(prime - 1) / 2
will also be a prime.
The options.add
and options.rem
parameters can be used to enforce additional
requirements, e.g., for Diffie-Hellman:
- If
options.add
andoptions.rem
are both set, the prime will satisfy the condition thatprime % add = rem
. - If only
options.add
is set andoptions.safe
is nottrue
, the prime will satisfy the condition thatprime % add = 1
. - If only
options.add
is set andoptions.safe
is set totrue
, the prime will instead satisfy the condition thatprime % add = 3
. This is necessary becauseprime % add = 1
foroptions.add > 2
would contradict the condition enforced byoptions.safe
. options.rem
is ignored ifoptions.add
is not given.
Both options.add
and options.rem
must be encoded as big-endian sequences
if given as an ArrayBuffer
, SharedArrayBuffer
, TypedArray
, Buffer
, orDataView
.
By default, the prime is encoded as a big-endian sequence of octets
in an ArrayBuffer. If the bigint
option is true
, then a
bigint is provided.
void
generatePrime(size: number,options: GeneratePrimeOptionsBigInt,callback: (err: Error | null,prime: bigint,) => void,): void
options: GeneratePrimeOptionsBigInt
void
generatePrime(size: number,options: GeneratePrimeOptionsArrayBuffer,callback: (err: Error | null,prime: ArrayBuffer,) => void,): void
options: GeneratePrimeOptionsArrayBuffer
void
generatePrime(size: number,options: GeneratePrimeOptions,callback: (err: Error | null,prime: ArrayBuffer | bigint,) => void,): void
options: GeneratePrimeOptions
void