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

34 lines
1.0 KiB
JavaScript
Raw Normal View History

2022-12-03 05:27:06 +03: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 23:57:11 +03: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-03 05:27:06 +03:00
/**
* Return %%length%% bytes of cryptographically secure random data.
2022-12-10 02:24:58 +03:00
*
* @example:
* randomBytes(8)
* //_result:
2022-12-03 05:27:06 +03:00
*/
2022-09-05 23:57:11 +03:00
export function randomBytes(length) {
return __randomBytes(length);
}
randomBytes._ = _randomBytes;
randomBytes.lock = function () { locked = true; };
randomBytes.register = function (func) {
if (locked) {
2022-10-01 08:34:06 +03:00
throw new Error("randomBytes is locked");
2022-09-05 23:57:11 +03:00
}
__randomBytes = func;
};
Object.freeze(randomBytes);
//# sourceMappingURL=random.js.map