zkToolkit

zk toolkit <category> <operation> [input]

zk toolkit help

zk toolkit <category> help

zk toolkit hash poseidon "hello world"
zk toolkit hash pedersen "secret"
zk toolkit hash mimc "data" --key "optional"

> zk toolkit hash poseidon "hello"

Poseidon Hash Result

Input: "hello"

Hash:
  8765432109876543210987654321098765432109876543210987654321098765

zk toolkit commit create 100 --secret "my_secret"
zk toolkit commit reveal <commitment> 100 --secret "my_secret"
zk toolkit commit verify <commitment> 100 <salt>

zk toolkit merkle create alice bob charlie dave
zk toolkit merkle proof <root> <leaf> <index>

zk toolkit range prove 25 --min 18 --max 100

zk toolkit sign keypair
zk toolkit sign sign <message> --privateKey <key>
zk toolkit sign verify <message> <signature> --publicKey <key>

zk toolkit nullifier create "my_secret" --scope "tx:001"
zk toolkit nullifier verify <nullifier> <secret> <scope>

zk toolkit field add 5 7           # 12
zk toolkit field mul 6 7           # 42
zk toolkit field inv 5             # Modular inverse
zk toolkit field pow 2 256         # 2^256 mod p

p = 21888242871839275222246405745257275088548364400416034343698204186575808495617

zk toolkit ec mulbase <scalar>     # Scalar * Generator
zk toolkit ec add <x1,y1> <x2,y2>  # Point addition
zk toolkit ec isoncurve <x,y>      # Verify point on curve

a = 168700
d = 168696
Equation: a*x² + y² = 1 + d*x²*y²

zk toolkit shamir split "secret" --threshold 3 --shares 5
zk toolkit shamir combine <share1>,<share2>,<share3>

# Split secret into 5 shares, need 3 to reconstruct
> zk toolkit shamir split "secret" --threshold 3 --shares 5
Share 1: 1:abc123...
Share 2: 2:def456...
Share 3: 3:ghi789...
Share 4: 4:jkl012...
Share 5: 5:mno345...

# Combine any 3 shares
> zk toolkit shamir combine 1:abc123...,2:def456...,3:ghi789...
Secret: secret

zk toolkit proof generate --inputs "a=5,b=7"

POST /api/zk-toolkit/hash/poseidon
Content-Type: application/json

{ "input": "hello world" }

{
  "algorithm": "Poseidon",
  "input": "hello world",
  "hash": "8765432109876543210..."
}

POST /api/zk-toolkit/commit/create
Content-Type: application/json

{ "value": "100", "secret": "my_secret" }

{
  "commitment": "1234567890...",
  "salt": "abcdef..."
}

POST /api/zk-toolkit/field/add
Content-Type: application/json

{ "a": "5", "b": "7" }

{
  "operation": "add",
  "a": "5",
  "b": "7",
  "result": "12"
}

POST /api/zk-toolkit/ec/mulbase
Content-Type: application/json

{ "scalar": "12345" }

{
  "point": {
    "x": "1234567890...",
    "y": "9876543210..."
  }
}

npm install @zkterm/zktoolkit

import { hash, field, ec, shamir, proof } from '@zkterm/zktoolkit';

// Hash
const h = await hash.poseidon("hello");

// Field arithmetic
const sum = field.add(5n, 7n);

// EC operations
const point = ec.mulBase(12345n);

// Secret sharing
const shares = shamir.split(42n, 3, 5);

// Generate proof
const p = await proof.generate({ a: 5, b: 7 });