Practical overview
When it fits
Use it when developing an identity-registration or proof-generation workflow that needs to process passport-derived data and produce Circom circuit artifacts.
Who it is for
- Developers building passport-based identity registration flows
- Teams developing zero-knowledge proof pipelines or voting applications that use biometric-passport identity circuits
Documented uses
- Generate a main circuit and inputs from passport JSON.
- Use a reusable identity-registration builder or supply parameters manually.
- Generate verification circuits configured for passport-format differences.
- Use the described query circuit to reveal data for an already registered passport.
Requirements & limits
The repository identifies an MIT license.
- The documented generation workflow requires passport JSON plus npm or Yarn; manual parameter entry is also mentioned, without a detailed procedure.
- Passport variation is handled through verification-flow parameters and compile-time shifts, so developers need to configure for the relevant passport case.
- The README assigns active-authentication signature verification to a smart contract, while circuits prove that a public key is present in a valid passport.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Generate circuit artifacts from passport JSON
Create the main circuit and inputs for passport identity registration using the repository's documented workflow.
Before you start
- The repository's files
- Passport data in JSON format
- npm or Yarn
Steps
Place the passport JSON file in test/inputs/passport.
Install the project dependencies with npm i or yarn.
Run npm run test or yarn run test.
Expected outcome
The workflow generates a main circuit in ciruits/generated and inputs in inputs/generated.
Guide limitations
- The README describes this as circuit generation; it does not document a complete voting-system deployment.
- Manual parameters are described as an alternative when passport JSON is unavailable, but this workflow does not detail those parameters.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 24 October 2026
- Original website title
- rarimo/passport-zk-circuits · Official homepage title · retained in its source language

