Security
Curated in-app view
Source file linked
Back to documents
Document route

ZK Capability Matrix

PrivateDAO-specific matrix for what the ZK layer proves today, how it is verified, and what remains explicitly out of scope.

Document context

Truth-aligned matrix only; it does not upgrade the repo beyond the actual verifier and launch boundaries.

Audience: Judges, security reviewers, operators

Open raw file

ZK Capability Matrix

This matrix separates what the PrivateDAO zk stack does today from what remains future work.

The goal is reviewer clarity and execution pressure: local proof work, standalone Testnet verifier evidence, and the Squads-governed integrated verifier path must stay distinct until each layer has its own transaction evidence.

Capability Matrix

LayerWhat It ProvesLive NowVerification PathWhat Is Not ClaimedBoundary
Vote validity proofA committed vote can be checked against a bounded public signal setLive off-chainnpm run zk:prove:vote and npm run zk:verify:voteno verifier CPI on Solanaadditive to current protocol
Delegation authorization proofDelegated authority binds to the proposal-scoped delegation intentLive off-chainnpm run zk:prove:delegation and npm run zk:verify:delegationno production-grade delegated privacy path on-chainadditive to current protocol
Tally integrity proofA bounded tally sample is coherent with its public signalsLive off-chainnpm run zk:prove:tally and npm run zk:verify:tallynot a full hidden tally replacementbounded reveal sample, not a full hidden tally replacement
Public-signal consistencyGenerated outputs stay aligned with the expected public inputsVerifiednpm run verify:zk-consistencynot a cryptographic verifier contractsample-output coherence check
Tampered public-signal rejectionModified public signals fail the verifier pathVerifiednpm run verify:zk-negativenot an on-chain slash or enforcement pathoff-chain verification safeguard
Tampered proof rejectionModified proof objects fail the verifier pathVerifiednpm run verify:zk-negativenot an on-chain slash or enforcement pathoff-chain verification safeguard
Proposal-bound proof anchorsProof-related state can be anchored to proposal context for reviewabilityLive and anchoreddocs/frontier-integrations.generated.md, docs/test-wallet-live-proof-v3.generated.mdnot a complete on-chain verifier CPIreviewer-facing on-chain anchoring
ZK registry integrityThe repository keeps a machine-readable map of zk artifacts and their rolesVerifiednpm run build:zk-registry and npm run verify:zk-registrynot a wallet execution guaranteemachine-readable review layer
ZK provenance transcriptSetup, circuit, and artifact lineage remain traceableVerifiednpm run build:zk-transcript and npm run verify:zk-transcriptnot an external audit opinionreviewer-readable artifact traceability
ZK attestationRegistry, transcript, and verification commands stay tied togetherVerifiednpm run build:zk-attestation and npm run verify:zk-attestationnot a production launch approvalmachine-readable registry and transcript summary
ZK doc coherenceThe zk docs and artifact surfaces stay consistentVerifiednpm run verify:zk-docsnot protocol enforcementreviewer-surface discipline
ZK review-surface integrationZK links remain connected to proof, audit, and operations surfacesVerifiednpm run verify:zk-surface and npm run verify:allnot a claim that ZK is the only review pathdocs, registry, signals, and tamper checks stay aligned
zk_enforced finalize pathA stricter proposal path can require stronger receipts and review postureLive but boundeddocs/zk-verifier-strategy.md, docs/governance-hardening-v3.md, docs/test-wallet-live-proof-v3.generated.mdnot the dominant production recommendation yetstronger path, still additive and truth-aligned
Standalone on-chain verifierA separate Solana Testnet verifier program emits a BN254/Groth16 receiptTestnet deployeddocs/zk-standalone-verifier-testnet-2026-05-23.md, program 5H7Afyqdh5yPekkZJ5UM2j3HNB2bRvU8aVv8XoqeAW1j, receipt zwqNsA3kNP1mgcaS6zNdR92LLdssFULXfsRdkMK3UxraKLM6wYDoPaWCwV3J9PqApK5xJJH8TpxsGyCRcdEah67not integrated governance CPIreviewer-visible on-chain verifier evidence
Program-integrated verifier pathCurrent PrivateDAO binary path can absorb stricter verifier/runtime integration under Squads governanceStaged behind timelockdocs/squads-current-binary-upgrade-proposal-2026-05-25.md, proposal index 3, buffer HXcaUbT7Q8euufUbDKuhoRkSSYQPwUwmhw69TdePV6uY, release 2026-05-27T02:25:39Znot executed until Squads timelock releases and proposal index 3 executesactive protocol release path
Anonymous private treasury executionTreasury execution remains fully private and anonymous end-to-endNot implementednot claimedno anonymous private treasury executionoutside current scope
Full hidden on-chain tally replacementTally stays fully hidden and enforced on-chain rather than reviewer-boundedNot implementednot claimedno full hidden tally replacementfuture zk phase

Our Reading Of The Matrix

This is the PrivateDAO-specific reading that matters:

  • ZK is real inside the repository and reviewer stack.
  • ZK is already tied to proof packets, runtime evidence, and proposal-bound anchors.
  • ZK is not being presented here as a fake "fully trustless everything" system.
  • Standalone on-chain verifier evidence exists on Testnet now.
  • Integrated governance verifier work is staged through Squads proposal index 3 and must execute after the enforced timelock before it becomes a live protocol claim.
  • zk_enforced is useful and live as a stricter path, but it is not yet described as the universal production default.

Reviewer Shortcut

If you want the shortest high-signal path for this matrix:

  1. Read docs/zk-layer.md
  2. Read docs/zk-capability-matrix.md
  3. Read docs/zk-provenance.md
  4. Open docs/zk-transcript.generated.md
  5. Open docs/zk-attestation.generated.json
  6. Open docs/test-wallet-live-proof-v3.generated.md
  7. Open docs/frontier-integrations.generated.md
  8. Open docs/cryptographic-onchain-matrix-2026-05-25.md

Reviewer Reading Guide

What is strong today:

  • real Circom circuits
  • real Groth16 proofs
  • real setup artifacts
  • replay-bounded public outputs
  • consistency checks
  • tamper rejection
  • registry-backed zk review surface
  • standalone Testnet verifier program and receipt
  • Squads-governed integrated binary staged behind timelock

What is intentionally not claimed:

  • fully integrated governance verifier CPI already executed
  • private treasury execution
  • anonymous mainnet governance execution
  • full hidden tally replacement

Canonical Commands

npm run zk:all
npm run verify:zk-registry
npm run verify:zk-transcript
npm run verify:zk-attestation
npm run verify:zk-docs
npm run verify:zk-consistency
npm run verify:zk-negative
npm run verify:zk-surface
npm run verify:cryptographic-onchain-matrix
npm run verify:all