The customer-facing format for H33-PQ Verified. The pillars are for auditors. The artifact is for customers.
Why this exists
Customers don't ask for five separate bundles. They ask: "Give me the proof package." The PQ-Verified Artifact is that package — a single self-contained JSON file carrying the artifact manifest, five inline pillar attestations, and triple-family PQ signatures over the manifest. One drag-and-drop. One verifier command. One verdict.
| Property | Value |
|---|---|
| Schema ID | h33-pq-verified-artifact/v1 |
| File extension | .h33pqv.json |
| Encoding | UTF-8 JSON, pretty-printed (2-space indent) |
| Typical size | ~30–50 KB self-attestation; varies with subject |
| Canonicalization | Object keys sorted lexicographically; minimized for hashing |
| Hash algorithm | SHA3-384 throughout (96 hex chars) |
| Signatures | Triple-family PQ: ML-DSA-87 · SLH-DSA-256s · FALCON-1024 (base64) |
| Check | How |
|---|---|
| Schema version | Must equal h33-pq-verified-artifact/v1 |
| Top-level fields | 11 required: schema_version, artifact_id, cycle_id, issued_at, issuer, subject, attestations, manifest_hash, signatures, verifier_command, publishing_rule |
| Each embedded attestation | Verified against its own pillar schema (required fields, publishing_rule const, fingerprint regex, result enum) |
| attestation_hashes | Recomputed canonical SHA3-384 over each attestation; mismatch → FAILED |
| manifest_hash | Recomputed canonical SHA3-384 over (cycle, issuer, subject, hashes); mismatch → FAILED |
| Signatures | PRESENT (all 3 PQ sigs valid) · PENDING_CEREMONY (3× PENDING markers) · PARTIAL · MISSING |
| Cycle consistency | Every embedded attestation's cycle_id matches the artifact's |
| Verdict | Meaning |
|---|---|
| VERIFIED | All structural + hash + signature checks pass. Triple-family signatures present and valid. |
| VERIFIED_PENDING_SIGNATURES | Structure and hashes valid. Signatures pending (pre-ceremony state). Treat as "the math is right, but the production keys haven't signed yet." |
| FAILED | Any check failed. The why list enumerates exactly what. |
Drag-and-drop (zero install):
https://h33.ai/pq-verified/verify/ — runs entirely in your browser. Files never leave the page.
CLI:
Exit code 0 = VERIFIED · 1 = FAILED · 2 = ERROR. Output is structured JSON.
pq-verified-artifact-v1.schema.json · JSON Schema draft-07.
| Surface | Outcome |
|---|---|
| Every H33 demo (Solana Privacy · Zcash · HATS · Agent Zero · Governance Replay · Commerce) | Ends with "Download PQ-Verified Artifact" CTA |
| Every H33 release | Bundled alongside the release manifest |
| Every customer self-attestation | Customer publishes their .h33pqv.json at their own attestation URL |
| Regulatory submissions | Attach the artifact to the submission package |
| Audit evidence | Auditor receives ONE file instead of a folder of bundles |