Skip to content

[Tools] Provide CLI utility in zeroj-tools for converting .zkey files to sparse mmap store format #39

Description

@satran004

Background & Objective

ZeroJ supports loading proving keys via memory-mapped sparse stores (Groth16PkStore, ADR-0029/ADR-0035/ADR-0036). Converting a standard snarkjs .zkey into ZeroJ’s sparse .bin store format allows instant memory-mapped startup for provers without re-parsing large .zkey files on every run.

Scope & Tasks

  • Add a CLI command in zeroj-tools (e.g. zeroj-tools convert-zkey --in <circuit.zkey> --out <dir> --sparse).
  • Support dense and sparse point encoding outputs.
  • Output verification key metadata and circuit fingerprint for instant pipeline validation.
  • Document usage in docs/groth16-dev-guide.md.

Risk Classification

  • R1: Developer tooling & workflow ergonomics.
  • Reference: docs/zeroj-comprehensive-review-and-readiness-gemini.md (Section 5.2).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions