hash-maker

hash-maker

A collection of hash and number generators for Node or Browser in pure JS.

• SHA - Creates a SHA1/224/256/384/512 hash of a message.
• MD5 - Creates a MD5 hash of a message.
• CRC - Createsa CRC3/16/32 hash of a message.
• UUID - Create UUIDs verisons 1 - 5.
• Random bytes - Random bytes of a supplied length (based on Mersenne Twister)
• Mersenne Twister - Random number generator that can be seaded. Create 32 bit signed, unsigned or float values.
• Random Xor Shift - Random number generator that can be seaded. Creates unsigned 32 bit values.

Installation

npm install hash-maker

Provides both CommonJS and ES modules.

SHA

SHA hash function. All SHA functions can be returned as a string, Uint8Array, Buffer or Hex string (default).

Can be imported as:

const { SHA256 } = require('hash-maker');
//
import { SHA256 } from 'hash-maker';
const hash = SHA256("0123456789",{asArray:true});

Functions	Params
SHA1(message, options?) SHA224(message, options?) SHA256(message, options?) SHA384(message, options?) SHA512(message, options?)	Message to be hashed as string, Uint8Array or Buffer, options: { asString: true || asBuffer: true || asArray: true }

MD5

MD5 hash function. MD5 functions can be returned as a string, Uint8Array, Buffer or Hex string (default).

Can be imported as:

const { MD5 } = require('hash-maker');
//
import { MD5 } from 'hash-maker';
const hash = MD5("0123456789",{asArray:true})

Functions	Params
MD5(message, options?)	Message to be hashed as string, Uint8Array or Buffer, options: { asString: true || asBuffer: true || asArray: true }

CRC

CRC hash function. CRC functions can be returned as a Hex string, Uint8Array, Buffer or number (default).

Can be imported as:

const { CRC32 } = require('hash-maker');
//
import { CRC32 } from 'hash-maker';
const hash = CRC32("0123456789",{asArray:true});

Functions	Params
CRC3(message, options?) CRC16(message, options?) CRC32(message, options?)	Message to be hashed as string, Uint8Array or Buffer, options: { asBuffer: true || asArray: true || asHex: true }

UUID

UUID generator function. UUID functions can create verisons 1 - 5 (default 4) and can be returned as a Uint8Array, Buffer or Hex string (default).

Can be imported as:

const { UUID } = require('hash-maker');
//
import { UUID } from 'hash-maker';
const id = UUID(1,{asArray:true});

Functions	Params
UUID(verison, options?)	verison 1 - 5 (default 4), options: { seed: If seeding is needed. Must be UInt8Array or Buffer of 16 bytes, mac: If a mac ID is needed. Must be UInt8Array or Buffer of 6 bytes. Else one is generated when needed, asBuffer: true || asArray: true }

Random Bytes

Random byte generator function. Functions can be returned as a Buffer or Uint8Array (default). Numbers generated with the Mersenne Twister (see below).

Can be imported as:

const { randomBytes } = require('hash-maker');
//
import { randomBytes } from 'hash-maker';
const bytes = randomBytes(12,true);

Functions	Params
randomBytes(amount, asBuffer?)	Bytes neede, true to return as a Buffer

Mersenne Twister

Mersenne Twister number generator class. Can be seeded with a number or Uint32Array.

Can be imported as:

const { MERSENNETWISTER } = require('hash-maker');
//
import { MERSENNETWISTER } from 'hash-maker';
const seed; // number or Uint32Array if needed
const mt = new MERSENNETWISTER(seed);
const unsignedInt = mt.genrand_int32() // or mt.RandTwisterUnsigned() mt.random_int()
const signedInt = mt.genrand_int32i() // or mt.RandTwisterSigned()
const unsigned31Int = mt.genrand_int3i() //31 bit number
const double = mt.genrand_real1() // or mt.RandTwisterDouble()
const float1 = mt.genrand_real2() // generates a random number on [0,1)-real-interval
const float2 = mt.genrand_real3() // generates a random number on (0,1)-real-interval
const float3 = mt.genrand_res53() // generates a random number on [0,1) with 53-bit resolution

Functions	Params / returns
new MERSENNETWISTER(seed?)	Seed as number or Uint32Array
mt.genrand_int32() mt.RandTwisterUnsigned() mt.random_int()	unsigned 32 bit number
mt.genrand_int32i() mt.RandTwisterSigned()	signed 32 bit number
mt.genrand_real1() mt.RandTwisterDouble()	generates a random number on [0,1]-real-interval
mt.genrand_real2()	generates a random number on [0,1)-real-interval
mt.genrand_real3()	generates a random number on (0,1)-real-interval
mt.genrand_real3()	generates a random number on [0,1) with 53-bit resolution

Random Xor Shift

Random Xor Shift number generator class. Can seeded with a number or a Uint8Array or Buffer of 4 bytes.

Can be imported as:

const { RANDOMXORSHIFT } = require('hash-maker');
//
import { RANDOMXORSHIFT } from 'hash-maker';
const seed; //number, Uint8Array or Buffer of 4 bytes
const rxs = new RANDOMXORSHIFT(seed);
const random_int = rxs.random_int();

Functions	Params / returns
new RANDOMXORSHIFT(seed?)	Seed as a number or a Uint8Array or Buffer of 4 bytes.
rxs.random_int()	unsigned 32 bit number