README

What is Havok-N?

A modified version of Fletcher & Adler checksums plus an optional iterative hash function, by Lucy Havok.

Fletcher's Checksum algorithm is way overengineered. Adler had the right idea with many of the tweaks he made to simplify and solidify the algorithm. However, I liked the idea of having a user-defined arbitrary checksum bitdepth, but also make sure that the modulo is always prime so as to reduce checksum collision.

Table comparison

Usage

composer require luhav/havok-n

use Luhav\HavokN;

$havokN = new HavokN();

$data       = "Toast"; // This is the data you want a sum of. Can be of any type.
$bitdepth   = 16;      // This is sort of like the length of the checksum, but it's not directly proportionate. If you wanted to pretend this is Adler-32, you would put 32 here. Should be an integer.
$iterations = 0;       // Optional. This is the number of iterations over the iterative hash function (defaults to 0).
$havokN->sum($data, $bitdepth, $iterations);

Upstream

Havok-N is part of the EmojiHash project at Peepee Party, of which I am the creator, maintainer, and current sole contributor. The upstream version of havokn.php can be seen at https://fossil.peepee.party/emojihash/file?name=php/havokn.php.

License

Havok-N is licensed under The 3-Clause BSD License with the explicit military disclaimer (SPDX: BSD-3-Clause-No-Military-License). See LICENSE for the full text.