175 lines
7.0 KiB
JavaScript
175 lines
7.0 KiB
JavaScript
"use strict";
|
|
/*! noble-hashes - MIT License (c) 2022 Paul Miller (paulmillr.com) */
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
exports.randomBytes = exports.wrapXOFConstructorWithOpts = exports.wrapConstructorWithOpts = exports.wrapConstructor = exports.checkOpts = exports.Hash = exports.concatBytes = exports.toBytes = exports.utf8ToBytes = exports.asyncLoop = exports.nextTick = exports.hexToBytes = exports.bytesToHex = exports.isLE = exports.rotr = exports.createView = exports.u32 = exports.u8 = void 0;
|
|
// We use WebCrypto aka globalThis.crypto, which exists in browsers and node.js 16+.
|
|
// node.js versions earlier than v19 don't declare it in global scope.
|
|
// For node.js, package.json#exports field mapping rewrites import
|
|
// from `crypto` to `cryptoNode`, which imports native module.
|
|
// Makes the utils un-importable in browsers without a bundler.
|
|
// Once node.js 18 is deprecated, we can just drop the import.
|
|
const crypto_1 = require("@noble/hashes/crypto");
|
|
const u8a = (a) => a instanceof Uint8Array;
|
|
// Cast array to different type
|
|
const u8 = (arr) => new Uint8Array(arr.buffer, arr.byteOffset, arr.byteLength);
|
|
exports.u8 = u8;
|
|
const u32 = (arr) => new Uint32Array(arr.buffer, arr.byteOffset, Math.floor(arr.byteLength / 4));
|
|
exports.u32 = u32;
|
|
// Cast array to view
|
|
const createView = (arr) => new DataView(arr.buffer, arr.byteOffset, arr.byteLength);
|
|
exports.createView = createView;
|
|
// The rotate right (circular right shift) operation for uint32
|
|
const rotr = (word, shift) => (word << (32 - shift)) | (word >>> shift);
|
|
exports.rotr = rotr;
|
|
// big-endian hardware is rare. Just in case someone still decides to run hashes:
|
|
// early-throw an error because we don't support BE yet.
|
|
exports.isLE = new Uint8Array(new Uint32Array([0x11223344]).buffer)[0] === 0x44;
|
|
if (!exports.isLE)
|
|
throw new Error('Non little-endian hardware is not supported');
|
|
const hexes = Array.from({ length: 256 }, (v, i) => i.toString(16).padStart(2, '0'));
|
|
/**
|
|
* @example bytesToHex(Uint8Array.from([0xca, 0xfe, 0x01, 0x23])) // 'cafe0123'
|
|
*/
|
|
function bytesToHex(bytes) {
|
|
if (!u8a(bytes))
|
|
throw new Error('Uint8Array expected');
|
|
// pre-caching improves the speed 6x
|
|
let hex = '';
|
|
for (let i = 0; i < bytes.length; i++) {
|
|
hex += hexes[bytes[i]];
|
|
}
|
|
return hex;
|
|
}
|
|
exports.bytesToHex = bytesToHex;
|
|
/**
|
|
* @example hexToBytes('cafe0123') // Uint8Array.from([0xca, 0xfe, 0x01, 0x23])
|
|
*/
|
|
function hexToBytes(hex) {
|
|
if (typeof hex !== 'string')
|
|
throw new Error('hex string expected, got ' + typeof hex);
|
|
const len = hex.length;
|
|
if (len % 2)
|
|
throw new Error('padded hex string expected, got unpadded hex of length ' + len);
|
|
const array = new Uint8Array(len / 2);
|
|
for (let i = 0; i < array.length; i++) {
|
|
const j = i * 2;
|
|
const hexByte = hex.slice(j, j + 2);
|
|
const byte = Number.parseInt(hexByte, 16);
|
|
if (Number.isNaN(byte) || byte < 0)
|
|
throw new Error('Invalid byte sequence');
|
|
array[i] = byte;
|
|
}
|
|
return array;
|
|
}
|
|
exports.hexToBytes = hexToBytes;
|
|
// There is no setImmediate in browser and setTimeout is slow.
|
|
// call of async fn will return Promise, which will be fullfiled only on
|
|
// next scheduler queue processing step and this is exactly what we need.
|
|
const nextTick = async () => { };
|
|
exports.nextTick = nextTick;
|
|
// Returns control to thread each 'tick' ms to avoid blocking
|
|
async function asyncLoop(iters, tick, cb) {
|
|
let ts = Date.now();
|
|
for (let i = 0; i < iters; i++) {
|
|
cb(i);
|
|
// Date.now() is not monotonic, so in case if clock goes backwards we return return control too
|
|
const diff = Date.now() - ts;
|
|
if (diff >= 0 && diff < tick)
|
|
continue;
|
|
await (0, exports.nextTick)();
|
|
ts += diff;
|
|
}
|
|
}
|
|
exports.asyncLoop = asyncLoop;
|
|
/**
|
|
* @example utf8ToBytes('abc') // new Uint8Array([97, 98, 99])
|
|
*/
|
|
function utf8ToBytes(str) {
|
|
if (typeof str !== 'string')
|
|
throw new Error(`utf8ToBytes expected string, got ${typeof str}`);
|
|
return new Uint8Array(new TextEncoder().encode(str)); // https://bugzil.la/1681809
|
|
}
|
|
exports.utf8ToBytes = utf8ToBytes;
|
|
/**
|
|
* Normalizes (non-hex) string or Uint8Array to Uint8Array.
|
|
* Warning: when Uint8Array is passed, it would NOT get copied.
|
|
* Keep in mind for future mutable operations.
|
|
*/
|
|
function toBytes(data) {
|
|
if (typeof data === 'string')
|
|
data = utf8ToBytes(data);
|
|
if (!u8a(data))
|
|
throw new Error(`expected Uint8Array, got ${typeof data}`);
|
|
return data;
|
|
}
|
|
exports.toBytes = toBytes;
|
|
/**
|
|
* Copies several Uint8Arrays into one.
|
|
*/
|
|
function concatBytes(...arrays) {
|
|
const r = new Uint8Array(arrays.reduce((sum, a) => sum + a.length, 0));
|
|
let pad = 0; // walk through each item, ensure they have proper type
|
|
arrays.forEach((a) => {
|
|
if (!u8a(a))
|
|
throw new Error('Uint8Array expected');
|
|
r.set(a, pad);
|
|
pad += a.length;
|
|
});
|
|
return r;
|
|
}
|
|
exports.concatBytes = concatBytes;
|
|
// For runtime check if class implements interface
|
|
class Hash {
|
|
// Safe version that clones internal state
|
|
clone() {
|
|
return this._cloneInto();
|
|
}
|
|
}
|
|
exports.Hash = Hash;
|
|
// Check if object doens't have custom constructor (like Uint8Array/Array)
|
|
const isPlainObject = (obj) => Object.prototype.toString.call(obj) === '[object Object]' && obj.constructor === Object;
|
|
function checkOpts(defaults, opts) {
|
|
if (opts !== undefined && (typeof opts !== 'object' || !isPlainObject(opts)))
|
|
throw new Error('Options should be object or undefined');
|
|
const merged = Object.assign(defaults, opts);
|
|
return merged;
|
|
}
|
|
exports.checkOpts = checkOpts;
|
|
function wrapConstructor(hashCons) {
|
|
const hashC = (msg) => hashCons().update(toBytes(msg)).digest();
|
|
const tmp = hashCons();
|
|
hashC.outputLen = tmp.outputLen;
|
|
hashC.blockLen = tmp.blockLen;
|
|
hashC.create = () => hashCons();
|
|
return hashC;
|
|
}
|
|
exports.wrapConstructor = wrapConstructor;
|
|
function wrapConstructorWithOpts(hashCons) {
|
|
const hashC = (msg, opts) => hashCons(opts).update(toBytes(msg)).digest();
|
|
const tmp = hashCons({});
|
|
hashC.outputLen = tmp.outputLen;
|
|
hashC.blockLen = tmp.blockLen;
|
|
hashC.create = (opts) => hashCons(opts);
|
|
return hashC;
|
|
}
|
|
exports.wrapConstructorWithOpts = wrapConstructorWithOpts;
|
|
function wrapXOFConstructorWithOpts(hashCons) {
|
|
const hashC = (msg, opts) => hashCons(opts).update(toBytes(msg)).digest();
|
|
const tmp = hashCons({});
|
|
hashC.outputLen = tmp.outputLen;
|
|
hashC.blockLen = tmp.blockLen;
|
|
hashC.create = (opts) => hashCons(opts);
|
|
return hashC;
|
|
}
|
|
exports.wrapXOFConstructorWithOpts = wrapXOFConstructorWithOpts;
|
|
/**
|
|
* Secure PRNG. Uses `crypto.getRandomValues`, which defers to OS.
|
|
*/
|
|
function randomBytes(bytesLength = 32) {
|
|
if (crypto_1.crypto && typeof crypto_1.crypto.getRandomValues === 'function') {
|
|
return crypto_1.crypto.getRandomValues(new Uint8Array(bytesLength));
|
|
}
|
|
throw new Error('crypto.getRandomValues must be defined');
|
|
}
|
|
exports.randomBytes = randomBytes;
|
|
//# sourceMappingURL=utils.js.map
|