# keccak

> Keccak sponge function family

Latest version **3.0.4** (published 2023-09-20) · MIT license · 0 weekly downloads

## Install

```sh
npm install keccak
pnpm add keccak
yarn add keccak
bun add keccak
```

## Health

**Score 18/100 (F)** — status: abandoned.

Positive: has types package; no vulnerabilities.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.0.4 |
| Published | 2023-09-20 |
| First published | 2016-05-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/keccak) |
| Module format | CommonJS |
| Node | >=10.0.0 |
| Dependencies | 3 |
| Unpacked size | 761.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | yes |
| GitHub stars | 89 |
| Maintainers | null_radix, fanatid, axic, holgerd77 |
| Keywords | sha3, sha-3, keccak, shake |

## Links

- npm: https://www.npmjs.com/package/keccak
- Repository: https://github.com/cryptocoinjs/keccak
- Homepage: https://github.com/cryptocoinjs/keccak#readme
- Issues: https://github.com/cryptocoinjs/keccak/issues
- npm.io page: https://npm.io/package/keccak

## Dependencies (3)

- [node-addon-api](https://npm.io/package/node-addon-api.md) ^2.0.0
- [node-gyp-build](https://npm.io/package/node-gyp-build.md) ^4.2.0
- [readable-stream](https://npm.io/package/readable-stream.md) ^3.6.0

## Recent versions

- 3.0.4 (latest) — 2023-09-20
- 3.0.3 — 2022-12-28
- 3.0.2 — 2021-08-20
- 3.0.1 — 2020-07-20
- 3.0.0 — 2019-12-28
- 2.1.0 — 2019-12-01
- 2.0.0 — 2018-12-20
- 1.4.0 — 2017-12-02
- 1.3.0 — 2017-06-07
- 1.2.0 — 2017-02-23
- 1.1.0 — 2017-01-21
- 1.0.2 — 2017-01-04
- 1.0.0 — 2016-12-11
- 0.1.0 — 2016-12-09
- 0.0.1 — 2016-05-07

## README

# keccak

This module provides native bindings to [Keccak sponge function family][1] from [Keccak Code Package][2]. In browser pure JavaScript implementation will be used.

## Usage

You can use this package as [node Hash][3].

```js
const createKeccakHash = require('keccak')

console.log(createKeccakHash('keccak256').digest().toString('hex'))
// => c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470

console.log(createKeccakHash('keccak256').update('Hello world!').digest('hex'))
// => ecd0e108a98e192af1d2c25055f4e3bed784b5c877204e73219a5203251feaab
```

Also object has two useful methods: `_resetState` and `_clone`

```js
const createKeccakHash = require('keccak')

console.log(createKeccakHash('keccak256').update('Hello World!')._resetState().digest('hex'))
// => c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470

const hash1 = createKeccakHash('keccak256').update('Hello')
const hash2 = hash1._clone()
console.log(hash1.digest('hex'))
// => 06b3dfaec148fb1bb2b066f10ec285e7c9bf402ab32aa78a5d38e34566810cd2
console.log(hash1.update(' world!').digest('hex'))
// => throw Error: Digest already called
console.log(hash2.update(' world!').digest('hex'))
// => ecd0e108a98e192af1d2c25055f4e3bed784b5c877204e73219a5203251feaab
```

### Why I should use this package?

I thought it will be popular question, so I decide write explanation in readme.

I know a few popular packages on [npm][4] related with [Keccak][1]:

  - [sha3][5] ([phusion/node-sha3][6] on github) — not actual because support _only keccak_.
  - [js-sha3][7] ([emn178/js-sha3][8] on github) — brilliant package which support keccak, sha3, shake. But not implement [node Hash][3] interface unfortunately!
  - [browserify-sha3][9] ([wanderer/browserify-sha3][10] on github) — based on [js-sha3][7] (but not support shake!). Support [node Hash][3] interface, but without [streams][11].
  - [keccakjs][12] ([axic/keccakjs][13] on github) — uses [sha3][5] and [browserify-sha3][9] as fallback. As result _keccak only_ with [node Hash][3] interface without [streams][11].

## LICENSE

This library is free and open-source software released under the MIT license.

[1]: http://keccak.noekeon.org/
[2]: https://github.com/gvanas/KeccakCodePackage
[3]: https://nodejs.org/api/crypto.html#crypto_class_hash
[4]: http://npmjs.com/
[5]: https://www.npmjs.com/package/sha3
[6]: https://github.com/phusion/node-sha3
[7]: https://www.npmjs.com/package/js-sha3
[8]: https://github.com/emn178/js-sha3
[9]: https://www.npmjs.com/package/browserify-sha3
[10]: https://github.com/wanderer/browserify-sha3
[11]: http://nodejs.org/api/stream.html
[12]: https://www.npmjs.com/package/keccakjs
[13]: https://github.com/axic/keccakjs

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