ethers.js/lib.esm/crypto/random.js

34 lines
1.0 KiB
JavaScript
Raw Permalink Normal View History

2022-12-02 21:27:06 -05:00
/**
* A **Cryptographically Secure Random Value** is one that has been
* generated with additional care take to prevent side-channels
* from allowing others to detect it and prevent others from through
* coincidence generate the same values.
*
* @_subsection: api/crypto:Random Values [about-crypto-random]
*/
2022-09-05 16:57:11 -04:00
import { randomBytes as crypto_random } from "./crypto.js";
let locked = false;
const _randomBytes = function (length) {
return new Uint8Array(crypto_random(length));
};
let __randomBytes = _randomBytes;
2022-12-02 21:27:06 -05:00
/**
* Return %%length%% bytes of cryptographically secure random data.
2022-12-09 18:24:58 -05:00
*
* @example:
* randomBytes(8)
* //_result:
2022-12-02 21:27:06 -05:00
*/
2022-09-05 16:57:11 -04:00
export function randomBytes(length) {
return __randomBytes(length);
}
randomBytes._ = _randomBytes;
randomBytes.lock = function () { locked = true; };
randomBytes.register = function (func) {
if (locked) {
2022-10-01 01:34:06 -04:00
throw new Error("randomBytes is locked");
2022-09-05 16:57:11 -04:00
}
__randomBytes = func;
};
Object.freeze(randomBytes);
//# sourceMappingURL=random.js.map