# @projectsophon/snarkjs-helpers

> This package contains simple TypeScript types for working with SnarkJS, plus utilities to convert from SnarkJS outputs to smart contract call data.

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

## Install

```sh
npm install @projectsophon/snarkjs-helpers
pnpm add @projectsophon/snarkjs-helpers
yarn add @projectsophon/snarkjs-helpers
bun add @projectsophon/snarkjs-helpers
```

## 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 | 0 |
| Unpacked size | 15 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | Blaine Bublitz |
| Maintainers | phated, sophonbot |

## Links

- npm: https://www.npmjs.com/package/@projectsophon/snarkjs-helpers
- 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/snarkjs-helpers

## 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/snarkjs-helpers

This package contains simple TypeScript types for working with SnarkJS,
plus utilities to convert from SnarkJS outputs to smart contract call data.

## 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/snarkjs-helpers
```
```bash
yarn add @projectsophon/snarkjs-helpers
```

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

```js
import * as snarkjsHelpers from 'http://cdn.skypack.dev/@projectsophon/snarkjs-helpers'
```

## Table of contents

### Type Aliases

- [ContractCallArgs](README.md#contractcallargs)
- [SnarkJSProof](README.md#snarkjsproof)
- [SnarkJSProofAndSignals](README.md#snarkjsproofandsignals)

### Functions

- [buildContractCallArgs](README.md#buildcontractcallargs)
- [mockProof](README.md#mockproof)

## Type Aliases

### ContractCallArgs

Ƭ **ContractCallArgs**: [[`string`, `string`], [[`string`, `string`], [`string`, `string`]], [`string`, `string`], `string`[]]

Type representing the shape that can be passed into smart contract
functions that require zkSNARK verification.

___

### SnarkJSProof

Ƭ **SnarkJSProof**: `Object`

A zkSNARK proof (without signals) generated by SnarkJS `fullProve`

#### Type declaration

| Name | Type |
| :------ | :------ |
| `pi_a` | [`string`, `string`, `string`] |
| `pi_b` | [[`string`, `string`], [`string`, `string`], [`string`, `string`]] |
| `pi_c` | [`string`, `string`, `string`] |

___

### SnarkJSProofAndSignals

Ƭ **SnarkJSProofAndSignals**: `Object`

A zkSNARK proof and corresponding public signals generated by SnarkJS `fullProve`

#### Type declaration

| Name | Type |
| :------ | :------ |
| `proof` | [`SnarkJSProof`](README.md#snarkjsproof) |
| `publicSignals` | `string`[] |

## Functions

### buildContractCallArgs

▸ **buildContractCallArgs**(`snarkProof`, `publicSignals`): [`ContractCallArgs`](README.md#contractcallargs)

Function for converting the output of SnarkJS `fullProve` into a shape that can be
passed into smart contract functions which perform zk proof verification.

#### Parameters

| Name | Type | Description |
| :------ | :------ | :------ |
| `snarkProof` | [`SnarkJSProof`](README.md#snarkjsproof) | the SNARK proof |
| `publicSignals` | `string`[] | the circuit's public signals (i.e. output signals and public input signals) |

#### Returns

[`ContractCallArgs`](README.md#contractcallargs)

The input data in a shape that is suitable to use as smart contract call data

___

### mockProof

▸ **mockProof**(`publicSignals?`): [`SnarkJSProofAndSignals`](README.md#snarkjsproofandsignals)

Function to generate **mock** proof and signal data in the shape SnarkJS would return.

Only useful if you are using a mock hash and ZK proofs are disabled

#### Parameters

| Name | Type | Default value | Description |
| :------ | :------ | :------ | :------ |
| `publicSignals` | `string`[] | `[]` | the circuit's public signals (i.e. output signals and public input signals) |

#### Returns

[`SnarkJSProofAndSignals`](README.md#snarkjsproofandsignals)

A mock proof and public signals in the shape of SnarkJS output

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