function generatePrimeSync
Jump to headinggeneratePrimeSync(size: number): ArrayBuffer
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
, or DataView
.
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.
Parameters Jump to heading
Jump to headingsize: number
The size (in bits) of the prime to generate.
Return Type Jump to heading
ArrayBuffer
Jump to headinggeneratePrimeSync(size: number,options: GeneratePrimeOptionsBigInt,): bigint
Parameters Jump to heading
Jump to headingsize: number
Return Type Jump to heading
bigint
Jump to headinggeneratePrimeSync(size: number,options: GeneratePrimeOptionsArrayBuffer,): ArrayBuffer
Parameters Jump to heading
Jump to headingsize: number
Return Type Jump to heading
ArrayBuffer
Jump to headinggeneratePrimeSync(size: number,options: GeneratePrimeOptions,): ArrayBuffer | bigint
Parameters Jump to heading
Jump to headingsize: number
Jump to headingoptions: GeneratePrimeOptions
Return Type Jump to heading
ArrayBuffer | bigint