init

system/node_modules/ethers/src.ts/crypto/random.ts

@@ -0,0 +1,36 @@
+/**
+ *  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]
+ */
+import { randomBytes as crypto_random } from "./crypto.js";
+
+let locked = false;
+
+const _randomBytes = function(length: number): Uint8Array {
+    return new Uint8Array(crypto_random(length));
+}
+
+let __randomBytes = _randomBytes;
+
+/**
+ *  Return %%length%% bytes of cryptographically secure random data.
+ *
+ *  @example:
+ *    randomBytes(8)
+ *    //_result:
+ */
+export function randomBytes(length: number): Uint8Array {
+    return __randomBytes(length);
+}
+
+randomBytes._ = _randomBytes;
+randomBytes.lock = function(): void { locked = true; }
+randomBytes.register = function(func: (length: number) => Uint8Array) {
+    if (locked) { throw new Error("randomBytes is locked"); }
+    __randomBytes = func;
+}
+Object.freeze(randomBytes);