TypeScript/JavaScript implementation of LifeHash: A visual hash algorithm.
This project is in an early development phase and has not been audited or reviewed. Use it at your own risk.
Currently, only version1
and version2
lifehashes are supported.
LifeHash is a method of hash visualization based on Conway’s Game of Life that creates beautiful icons that are deterministic, yet distinct and unique given the input data.
The basic concept is to take a SHA-256 hash of the input data (which can be any data including another hash) and then use the 256-bit digest as a 16x16 pixel "seed" for running the cellular automata known as Conway’s Game of Life.
After the pattern becomes stable (or begins repeating) the resulting history is used to compile a grayscale image of all the states from the first to last generation. Using Game of Life provides visual structure to the resulting image, even though it was seeded with entropy.
Some bits of the initial hash are then used to deterministically apply symmetry and color to the icon to add beauty and quick recognizability.
Source: https://lifehash.info/
npm install lifehash
import { LifeHash, LifeHashVersion } from 'lifehash';
const lifehash = LifeHash.makeFrom(input, LifeHashVersion.version2, 1, true);
lifehash.toDataUrl(); // base64 image
For more examples, check the examples folder or the tests.
This library exports one class called LifeHash
.
class LifeHash {
static makeFrom(
data: string | Uint8Array,
version = LifeHashVersion.version2,
module_size = 1,
has_alpha = false,
): Image {
/* */
}
static makeFromDigest(
digest: Uint8Array | Buffer,
version = LifeHashVersion.version2,
module_size = 1,
has_alpha = false,
): Image {
/* */
}
}
npm install
npm test
- Support remaining LifeHashVersions
- Add tests
- Enable Linting
- Fix sonarsource coverage not working
- Audit/review of library by 3rd party
We try to use only a minimal set of dependencies to reduce the attack surface of malicious code being added by one of those dependencies.
There is only 1 (non-dev) dependency:
It is managed by crypto-browserify.
Currently, the following wallets support LifeHash:
The project setup has been inspired by multiple bitcoinjs libraries, such as bip39 and bip85.
Original C++ implementation: https://github.com/BlockchainCommons/bc-lifehash
This implementation is heavily inspired by https://github.com/BlockchainCommons/bc-lifehash-python
MIT