# @projectsophon/hashing

> This package contains MiMC hashing utilities for use with Dark Forest. The MiMC algorithm is used for both finding planet hashes and calculating the perlin in-game. Among other things, these values are often needed for generating Snarks.

Latest version **0.1.3** (published 2022-08-15) · MIT license · 0 weekly downloads

## Install

```sh
npm install @projectsophon/hashing
pnpm add @projectsophon/hashing
yarn add @projectsophon/hashing
bun add @projectsophon/hashing
```

## Health

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

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

Warnings: low downloads; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.3 |
| Published | 2022-08-15 |
| First published | 2022-08-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=16 |
| Dependencies | 1 |
| Unpacked size | 160.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | Blaine Bublitz |
| Maintainers | phated, sophonbot |

## Links

- npm: https://www.npmjs.com/package/@projectsophon/hashing
- Repository: https://github.com/projectsophon/zkgame-primitives
- Homepage: https://github.com/projectsophon/zkgame-primitives#readme
- Issues: https://github.com/projectsophon/zkgame-primitives/issues
- npm.io page: https://npm.io/package/@projectsophon/hashing

## Dependencies (1)

- [@projectsophon/types](https://npm.io/package/@projectsophon/types.md) ^0.1.3

## Recent versions

- 0.1.3 (latest) — 2022-08-15
- 0.1.2 — 2022-08-15
- 0.1.1 — 2022-08-13
- 0.1.0 — 2022-08-12

## README

# @projectsophon/hashing

This package contains MiMC hashing utilities for use with Dark Forest.
The MiMC algorithm is used for both finding planet hashes and calculating
the perlin in-game. Among other things, these values are often needed for
generating Snarks.

## Installation

You can install this package using [`npm`](https://www.npmjs.com) or
[`yarn`](https://classic.yarnpkg.com/lang/en/) by running:

```bash
npm install --save @projectsophon/hashing
```
```bash
yarn add @projectsophon/hashing
```

When using this in a plugin, you might want to load it with [skypack](https://www.skypack.dev)

```js
import * as hashing from 'http://cdn.skypack.dev/@projectsophon/hashing'
```

## Table of contents

### Interfaces

- [IntegerVector](interfaces/IntegerVector.md)

### Variables

- [Fraction](README.md#fraction)
- [MAX\_PERLIN\_VALUE](README.md#max_perlin_value)

### Functions

- [getRandomGradientAt](README.md#getrandomgradientat)
- [mimcHash](README.md#mimchash)
- [mimcSponge](README.md#mimcsponge)
- [modPBigInt](README.md#modpbigint)
- [modPBigIntNative](README.md#modpbigintnative)
- [perlin](README.md#perlin)
- [rand](README.md#rand)
- [seededRandom](README.md#seededrandom)

## Variables

### Fraction

• **Fraction**: `IFraction`

___

### MAX\_PERLIN\_VALUE

• `Const` **MAX\_PERLIN\_VALUE**: ``32``

## Functions

### getRandomGradientAt

▸ **getRandomGradientAt**(`point`, `scale`, `randFn`): `Vector`

#### Parameters

| Name | Type |
| :------ | :------ |
| `point` | `Vector` |
| `scale` | `IFraction` |
| `randFn` | `HashFn` |

#### Returns

`Vector`

___

### mimcHash

▸ **mimcHash**(`key`): (...`inputs`: `number`[]) => `bigint`

The primary function used to build any MiMC hashing algorithm for Dark Forest.

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `key` | `number` | The key for the MiMC algorithm. Will usually be PLANETHASH_KEY, SPACETYPE_KEY, or BIOMEBASE_KEY. |

#### Returns

`fn`

▸ (...`inputs`): `bigint`

##### Parameters

| Name | Type |
| :------ | :------ |
| `...inputs` | `number`[] |

##### Returns

`bigint`

___

### mimcSponge

▸ **mimcSponge**(`inputs`, `nOutputs`, `rounds`, `key`): `bigint`[]

#### Parameters

| Name | Type |
| :------ | :------ |
| `inputs` | `bigint`[] |
| `nOutputs` | `number` |
| `rounds` | `number` |
| `key` | `number` |

#### Returns

`bigint`[]

___

### modPBigInt

▸ **modPBigInt**(`x`): `bigint`

Modulo a number with the LOCATION_ID_UB constant.
If the result is < 0, the LOCATION_ID_UB will then be added.

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `x` | `number` | The number to modulo against LOCATION_ID_UB |

#### Returns

`bigint`

___

### modPBigIntNative

▸ **modPBigIntNative**(`x`): `bigint`

Modulo a BigInt with the LOCATION_ID_UB constant.
If the result is < 0, the LOCATION_ID_UB will then be added.

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `x` | `bigint` | The number to modulo against LOCATION_ID_UB |

#### Returns

`bigint`

___

### perlin

▸ **perlin**(`coords`, `options`): `number`

Calculates the perlin for a location, given the x,y pair and the PerlinConfig for the game.

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `coords` | [`IntegerVector`](interfaces/IntegerVector.md) | An object of the x,y coordinates for which perlin is being calculated. |
| `options` | `PerlinConfig` | An object containing the configuration for the perlin algorithm. |

#### Returns

`number`

___

### rand

▸ **rand**(`key`): (...`args`: `number`[]) => `number`

#### Parameters

| Name | Type |
| :------ | :------ |
| `key` | `number` |

#### Returns

`fn`

▸ (...`args`): `number`

##### Parameters

| Name | Type |
| :------ | :------ |
| `...args` | `number`[] |

##### Returns

`number`

___

### seededRandom

▸ **seededRandom**(`seed`): `number`

Generate a random number based on some seed. Useful for procedural generation.

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `seed` | `number` | The seed of the random number. |

#### Returns

`number`

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