Add specs/: import proof-of-personhood and age-verification specs from zkspecs#87
Merged
Merged
Conversation
Imports three protocol specs from privacy-ethereum/zkspecs so they live alongside the zkID reference implementation: - 1/OPENAC-CORE (was zkspecs#23, slug 7) - 2/ZK-HUMAN-VERIFICATION (was zkspecs:specs/5 + zkspecs#20 updates folded in) - 3/ZK-AGE-ELIGIBILITY (was zkspecs#19, slug 6) Slugs are renumbered 1-3 in import order. Cross-references between the three specs use relative paths. The 1/COSS change-process link still points to zkspecs and can be updated in review if needed. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Several verifier implementations referenced by the Verifier Implementations section currently live in `zkmopro/zkID` (a fork of this repo) rather than `privacy-ethereum/zkID`. Adds a one-line note so readers aren't surprised by the cross-org URLs. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The OpenAC core spec (1/OPENAC) is still in editorial flux; splitting it out of this migration so the human-verification and age-eligibility specs can land without being held up by OpenAC review. - Removes specs/1-openac-core/ entirely. - Updates specs/README.md: marks slot 1 as "in review" and explains the OpenAC spec will arrive in a separate PR. - Updates 3/ZK-AGE-ELIGIBILITY References: link target renamed to ../1-openac/README.md (broken until the OpenAC PR merges, by design). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This was referenced May 14, 2026
Closed
vplasencia
approved these changes
May 14, 2026
Member
vplasencia
left a comment
There was a problem hiding this comment.
Look great! Thank you very much @cc03668 🚀
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
specs/directory hosting protocol specs alongside the zkID reference implementation.2/ZK-PROOF-OF-PERSONHOODand3/ZK-AGE-VERIFICATIONfromprivacy-ethereum/zkspecs, renumbered in dependency order.1/OPENACis reserved and will arrive in a separate PR (still in editorial flux).What's included
zkspecsOPENAC2/ZK-PROOF-OF-PERSONHOODspecs/5/README.md(originally5/ZK-HUMAN-VERIFICATION) with updates from zkspecs#20 folded in; renamed during migration3/ZK-AGE-VERIFICATION6/ZK-AGE-ELIGIBILITY); renamed during migrationWhy move them here
The specs are tightly coupled to the implementation that lives in this repository (
wallet-unit-poc/,paper/). Co-locating spec text with the reference implementation makes reviews, conformance work, and editorial updates a single PR cycle rather than two.Why OpenAC is split out
1/OPENACis still in editorial flux, with verifier-profile boundary questions tracked separately in #89. Keeping it on its own PR allows the proof-of-personhood and age-verification migration to land without being held up by that review.A follow-up PR will add
specs/1-openac/.Renumbering
Slugs are renumbered in dependency order. Original
zkspecsnumbers (5,6,7) reflected the cross-project zkspecs registry, which doesn't carry meaning in this repository.The temporary gap at slot 1 in this PR's index is intentional — it signals that OpenAC is in flight rather than missing.
Cross-references
3/ZK-AGE-VERIFICATIONreferences1/OPENAC(it defines an OpenAC profile) and2/ZK-PROOF-OF-PERSONHOODvia relative paths. The1/OPENAClink will resolve once the follow-up PR merges.2/ZK-PROOF-OF-PERSONHOOD's in-body cross-reference to the age-verification spec is updated to3/ZK-AGE-VERIFICATION.1/COSSchange-process link continues to point toprivacy-ethereum/zkspecs/specs/1, so these specs remain governed by the same COSS process as the rest of PSE specs.2/ZK-PROOF-OF-PERSONHOOD's Verifier Implementations section references several repos underzkmopro/zkID(a fork of this repo). A short note in the section explains the split; the canonical spec home remainsprivacy-ethereum/zkID.Follow-ups (separate PRs / actions)
Companion OpenAC PR (filed): #88. OpenAC tracking issue (relocated from
zkspecs#22): #89. The corresponding zkspecs items (#19,#20,#21,#23,#22) have been closed with cross-links.Open follow-up:
specs/5/README.mdstill live onzkspecs:main— leave as historical, or open a separate deprecation PR there with maintainer signoff.cc @oskarth @vplasencia
🤖 Generated with Claude Code