# @hebcal/murmurhash3

> Pure-JavaScript MurmurHash3 (x86 32-bit and 128-bit), byte-compatible with the native murmurhash3 package

Latest version **1.0.0** (published 2026-07-29) · BSD-2-Clause license · 0 weekly downloads

## Install

```sh
npm install @hebcal/murmurhash3
pnpm add @hebcal/murmurhash3
yarn add @hebcal/murmurhash3
bun add @hebcal/murmurhash3
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2026-07-29 |
| First published | 2026-07-29 |
| Weekly downloads | 0 |
| License | BSD-2-Clause |
| TypeScript types | bundled |
| Module format | ESM |
| Node | >= 20 |
| Dependencies | 0 |
| Unpacked size | 13.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | Michael J. Radwin |
| Maintainers | mjradwin |
| Keywords | hash, murmur, murmurhash, murmurhash3, hebcal |

## Links

- npm: https://www.npmjs.com/package/@hebcal/murmurhash3
- Repository: https://github.com/hebcal/murmurhash3
- Homepage: https://github.com/hebcal/murmurhash3#readme
- Issues: https://github.com/hebcal/murmurhash3/issues
- npm.io page: https://npm.io/package/@hebcal/murmurhash3

## Alternatives

- [@gemini-wallet/core](https://npm.io/package/@gemini-wallet/core.md) — 515.6K weekly downloads
- [utility](https://npm.io/package/utility.md) — 416.6K weekly downloads
- [@primno/dpapi](https://npm.io/package/@primno/dpapi.md) — 7.2K weekly downloads
- [pi-readseek](https://npm.io/package/pi-readseek.md) — 3.7K weekly downloads
- [@emilia-protocol/verify](https://npm.io/package/@emilia-protocol/verify.md) — 1.1K weekly downloads

## Recent versions

- 1.0.0 (latest) — 2026-07-29

## README

# @hebcal/murmurhash3

Pure-JavaScript implementation of the [MurmurHash3](https://en.wikipedia.org/wiki/MurmurHash)
(x86) non-cryptographic hash by Austin Appleby, with TypeScript typings and no
native build step.

The output is **byte-for-byte identical** to the native
[`murmurhash3`](https://www.npmjs.com/package/murmurhash3) npm package
(`MurmurHash3_x86_32` / `MurmurHash3_x86_128`) for every input — including
non-ASCII strings, which are hashed as UTF-8 — so it is a drop-in replacement
that preserves previously computed hash values.

Because it is plain JavaScript, there is **no `node-gyp` / C++ compilation and no
`allowScripts` install step**. It works anywhere modern JavaScript runs.

## Install

```sh
npm install @hebcal/murmurhash3
```

## Usage

```js
import {
  murmur32Sync,
  murmur32HexSync,
  murmur128Sync,
  murmur128HexSync,
} from '@hebcal/murmurhash3';

murmur32Sync('Hello'); // 316307400
murmur32HexSync('Hello'); // '12da77c8'
murmur128Sync('Hello'); // [593538630, 1583560390, 2907026420, 2907026420]
murmur128HexSync('Hello'); // '2360ae465e6336c6ad45b3f4ad45b3f4'

// An optional 32-bit seed may be supplied (default 0):
murmur32HexSync('Hello', 0x9747b28c);
```

## API

All functions hash the UTF-8 encoding of `key` and accept an optional 32-bit
`seed` (default `0`).

| Function                       | Returns                                |
| ------------------------------ | -------------------------------------- |
| `murmur32Sync(key, seed?)`     | unsigned 32-bit integer (`number`)     |
| `murmur32HexSync(key, seed?)`  | 8-character zero-padded hex string     |
| `murmur128Sync(key, seed?)`    | array of four unsigned 32-bit integers |
| `murmur128HexSync(key, seed?)` | 32-character zero-padded hex string    |

Only the synchronous interface is provided. The native package's asynchronous
callback variants existed to offload work to a threadpool; for a pure-JS
computation that indirection has no benefit, so it is intentionally omitted.

## Compatibility

The `test/fixtures.json` file contains reference vectors captured directly from
the native `murmurhash3` package. The test suite asserts that this
implementation reproduces every one of them, locking byte-for-byte
compatibility across releases.

## License

BSD-2-Clause

---
_Source: https://npm.io/package/@hebcal/murmurhash3 · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
