Skip to content
This repository has been archived by the owner on Oct 22, 2021. It is now read-only.

vibornoff/entropy-collector.js

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 

Repository files navigation

EntropyCollector

Collects random bits from mouse moves and keystrokes and estimates the amount of Shannon entropy among collected samples.

Quick start

Add <script src="path/to/entropy-collector.js"></script> into your page.

Place EntropyCollector.start() into a suitable place.

Move your mouse and press keys for a couple of seconds and right after get the entropy estimation from EntropyCollector.estimatedEntropy and the noisy bits from EntropyCollector.buffer.

Don't forget to call EntropyCollector.stop() whenever you decide to stop entropy collection.

Reference

EntropyCollector.eventTarget

DOM EventTarget to consume events from. Uses document as default target. Setting new target will stop previously started collectors on the old target.

EntropyCollector.start

Starts entropy collection at the current target.

EntropyCollector.stop

Stops entropy collection at the current target.

EntropyCollector.eventsCaptured

The number of events captured.

EntropyCollector.estimatedEntropy

Estimated amount of Shannon entropy of collected samples.

EntropyCollector.buffer

ArrayBuffer containing the noisy bits. Use it to seed CPRNG or to derive a cryptographic key with a secure hash function.

DON'T USE THESE BITS DIRECTLY

TODO

Add support of mobile devices (acceletometer and g-sensor entropy collection).

About

JavaScript entropy collector

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published