Hive Canon · Provable Layer · Born Here

SpectralZK v1. Prove the rule. Hide the rule.

A SpectralZK receipt proves that an agent ran inside a named policy without revealing what the policy says. The auditor learns the policy was honored. The competitor learns nothing. The regulator gets a verifiable proof, not a screenshot.

Schema live · v1 Doctrine · Provable Layer Offline verifier · ~50ms No prover network required

What the proof attests

A SpectralZK v1 proof binds three statements into a single non-interactive zero-knowledge object. Every statement is bound by Fiat-Shamir transcript, so flipping a single bit anywhere breaks the proof.

PROVE 1 · PREIMAGE

Policy knowledge

The prover knows a policy P such that C = SHA-256(policy_id || merkle_root(constraints)). Proven via Schnorr signature of knowledge over Ed25519.

PROVE 2 · MEMBERSHIP

Constraint inclusion

A satisfying constraint exists in the policy's Merkle tree. Path commitments are blinded so the verifier cannot identify which leaf satisfied.

PROVE 3 · SATISFACTION

Action conforms

The recorded action falls inside the hidden constraint's predicate range. Bound to the transcript so the action cannot be swapped after signing.

What stays hidden

HIDE

Policy text

Trade secrets, pricing tiers, customer lists, allowlists, model selection rules. The constraint set never leaves the issuer.

HIDE

Which constraint matched

The Merkle path is blinded by per-node nonces. Verifier learns tree depth but cannot identify the satisfying leaf.

HIDE

Counterparties

Optional. Holder controls disclosure scope. Pair with ViewKey for selective reveal to regulators only.

HIDE

Other constraints

Sibling constraints in the policy tree are committed but never revealed. A regulator learns nothing about unused rules.

Verify a sample proof in your terminal

No backend call. No prover network. Three curl commands, one pip install, one python invocation. ~50ms end-to-end.

# 1. fetch the sample proof, the schema, and the offline verifier
curl -sSL https://thehiveryiq.com/canon/spectralzk/sample-proof.json   -o proof.json
curl -sSL https://thehiveryiq.com/canon/spectralzk/spectralzk_v1.py    -o spectralzk_v1.py
pip install cryptography

# 2. verify offline
python3 spectralzk_v1.py verify proof.json

# 3. expected output
  RESULT:           PASS
  protocol:         spectralzk/1
  policy_commit:    2J6l5ZKt_G3BEqK0EoNF75YgOYVtfziencyZsj7gZXQ
  merkle_root:      Cd-oNZoDQXTa5FOiraKdj0mftZmyXdOFAt4FNjMqYyc
  action:           spend_usd_per_day = 145
  issuer_pubkey:    ed25519:-_HdEFXF_wfSt1n9DO41fga7B1i8Wo03R79_usXCmTA
  path_depth:       2 blinded nodes
  challenge_sha256: gkx30gXSPb0_ll5VQEfO7ILSbciHFHD-rPY_BV8ch3M
  verified offline. no prover network contacted.
  reason:           all three statements verified
Soundness verified. Flipping any byte in action.value, merkle_root, schnorr_sig, or any path[].commit causes the verifier to return RESULT: FAIL with the exact reason (Fiat-Shamir challenge mismatch or signature failure). The proof is bound end-to-end.

Construction

LayerPrimitivePurpose
CommitmentSHA-256(policy_id || merkle_root)Public commitment C that hides policy text and constraint count behind a 32-byte hash
InclusionMerkle tree, SHA-256Logarithmic-depth membership proof for the satisfying constraint
PrivacyPedersen-style blinded path commitsPer-node blinding factors prevent the verifier from identifying which leaf matched
KnowledgeSchnorr-style sig over Ed25519Non-malleable proof of policy preimage knowledge, bound via Fiat-Shamir transcript
CanonicalizationRFC 8785 JCSSort keys, no whitespace, UTF-8. Byte-identical between prover and verifier across implementations
TranscriptSHA-256 of canonical bytesBinds (C, root, action, path, issuer_pubkey) into a single challenge; any tamper invalidates the signature

Schema

$idhttps://thehiveryiq.com/.well-known/schemas/spectralzk-v1.json
URNurn:hive:spectralzk:v1
DraftJSON Schema 2020-12
StatusSCHEMA LIVE · v1
PatentHIVE-2026-SZK-001 (provisional, USPTO filing in progress)

Where it sits in the Canon

SpectralZK is the zero-knowledge counterpart to HAHS. HAHS is a transparent receipt — the scope ceiling and composed scope are in plaintext for the auditor. SpectralZK is the privacy-preserving variant for situations where the policy itself is sensitive. The receipt format pairs cleanly with HAHS, ViewKey, and SHOD on the same envelope.

No miner network is required. No staking. No external prover quorum. The math is the prover. Anyone with the schema, the verifier, and the issuer's pubkey can establish PASS or FAIL with cryptographic certainty.