$ npm install @projectsophon/hashingThis 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.
You can install this package using npm or
yarn by running:
npm install --save @projectsophon/hashing
yarn add @projectsophon/hashing
When using this in a plugin, you might want to load it with skypack
import * as hashing from 'http://cdn.skypack.dev/@projectsophon/hashing'
• Fraction: IFraction
• Const MAX_PERLIN_VALUE: 32
▸ getRandomGradientAt(point, scale, randFn): Vector
| Name | Type |
|---|---|
point | Vector |
scale | IFraction |
randFn | HashFn |
Vector
▸ mimcHash(key): (...inputs: number[]) => bigint
The primary function used to build any MiMC hashing algorithm for Dark Forest.
| Name | Type | Description |
|---|---|---|
key | number | The key for the MiMC algorithm. Will usually be PLANETHASH_KEY, SPACETYPE_KEY, or BIOMEBASE_KEY. |
fn
▸ (...inputs): bigint
| Name | Type |
|---|---|
...inputs | number[] |
bigint
▸ mimcSponge(inputs, nOutputs, rounds, key): bigint[]
| Name | Type |
|---|---|
inputs | bigint[] |
nOutputs | number |
rounds | number |
key | number |
bigint[]
▸ 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.
| Name | Type | Description |
|---|---|---|
x | number | The number to modulo against LOCATION_ID_UB |
bigint
▸ 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.
| Name | Type | Description |
|---|---|---|
x | bigint | The number to modulo against LOCATION_ID_UB |
bigint
▸ perlin(coords, options): number
Calculates the perlin for a location, given the x,y pair and the PerlinConfig for the game.
| Name | Type | Description |
|---|---|---|
coords | IntegerVector | An object of the x,y coordinates for which perlin is being calculated. |
options | PerlinConfig | An object containing the configuration for the perlin algorithm. |
number
▸ rand(key): (...args: number[]) => number
| Name | Type |
|---|---|
key | number |
fn
▸ (...args): number
| Name | Type |
|---|---|
...args | number[] |
number
▸ seededRandom(seed): number
Generate a random number based on some seed. Useful for procedural generation.
| Name | Type | Description |
|---|---|---|
seed | number | The seed of the random number. |
number