@0gzk/sdk

ZK Groth16 prover and 0G Storage helpers for the 0gzk ZK Proof-as-a-Service platform. Three subpaths, picked automatically by your runtime:

• @0gzk/sdk — isomorphic (Node + browser): generateProof, verifyLocal, validateInputs, BundleFiles, CircuitMetadata, InputValidationError. Wraps snarkjs.groth16 with metadata-driven input validation.
• @0gzk/sdk/node — Node-only: uploadBundle, fetchBundle, loadConfig, readBundleFromDir. Talks to 0G Storage via @0gfoundation/0g-ts-sdk.
• @0gzk/sdk/onchain — isomorphic: getRegistryContract, getVersion, getLatest, listCircuits, resolveBundle, parseNameSpec. Resolves circuits by name through the on-chain CircuitRegistry.

Witness data never leaves the calling process — proofs are generated client-side and only proof + publicSignals go anywhere else.

Install

npm i @0gzk/sdk snarkjs
# or, with Node uploads/downloads + on-chain resolution:
npm i @0gzk/sdk snarkjs @0gfoundation/0g-ts-sdk ethers

snarkjs is a hard peer. @0gfoundation/0g-ts-sdk and ethers are optional peers — only required if you import from /node or /onchain respectively.

TL;DR

import { generateProof, verifyLocal, type BundleFiles } from "@0gzk/sdk";

const bundle: BundleFiles = { wasm, zkey, vkey, metadata };
const inputs = { birthYear: 1990, currentYear: 2026, minAge: 18 };

const { proof, publicSignals } = await generateProof(bundle, inputs);
const ok = await verifyLocal(bundle, { proof, publicSignals });

generateProof validates inputs against metadata.inputs (uint, bool, field, uint[], field[] — with optional length) before calling snarkjs.groth16.fullProve. Bad input throws InputValidationError with a list of all problems.

Pull a bundle from 0G Storage (Node-only)

import { fetchBundle, loadConfig } from "@0gzk/sdk/node";

const config = loadConfig({});
const bundle = await fetchBundle(rootHash, config, "/tmp/my-bundle");

Set OG_PRIVATE_KEY if you also need to uploadBundle. Reads do not require a wallet.

Resolve a circuit by name from the registry

import { JsonRpcProvider } from "ethers";
import { getRegistryContract, resolveBundle, parseNameSpec } from "@0gzk/sdk/onchain";
import { fetchBundle, loadConfig } from "@0gzk/sdk/node";

const registry = getRegistryContract(new JsonRpcProvider("https://evmrpc.0g.ai"));
const { record, bundle } = await resolveBundle(
  registry,
  parseNameSpec("[email protected]"),
  (root) => fetchBundle(root, loadConfig({}), `/tmp/0gzk/${root}`),
);

Full guide → USAGE.md

USAGE.md has copy-pasteable recipes for browser ESM, Next.js App Router, plain Node scripts, registry-driven proving, and CI / programmatic CLI usage, plus an input-validation cheatsheet.

License

MIT