Views
No views yet
A quantum provenance dashboard that links physical device behavior
to cryptographically verifiable, signed fingerprints.
A complete trust chain connecting physical quantum behavior to digital verification. The code shown here is a simplified V0 example only and does not represent the exact workings. The dataset shown is the same data used for the Proof-of-Concept tests.
| Layer | Technology | Purpose |
|---|---|---|
| Quantum Execution | Qiskit | Circuit transpilation and IBM backend interface |
| Runtime | qiskit_ibm_runtime.SamplerV2 | Hardware job submission |
| Cryptography | cryptography.hazmat | HMAC & RSA (SHA-256) |
| Visualization | Streamlit | Interactive provenance dashboard |
| Storage | JSON + filesystem | Immutable provenance store |
| Environment | Python ≥ 3.10 | Recommended for full reproducibility |
1# Clone repository
2git clone https://github.com/osamah-nn/qDNA-ID.git
3cd qDNA-ID
4
5# (Optional) create environment
6python -m venv qdnaidex
7source qdnaidex/bin/activate # or .\qdnaidex\Scripts\activate on Windows
8
9# Install dependencies
10pip install -r qdna_id.yml
11Dependencies:
12qiskit, qiskit-ibm-runtime, cryptography, numpy, streamlit, pandas
13
14
15🔑 Environment Configuration
16Before running, set cryptographic and IBM environment variables:
17Copy code
18IBM (Configure devices.py by your IBM Cloud ConfigurationS)
19# === Your static configuration (with ENV overrides allowed) ===
20# Windows
21setx QISKIT_IBM_RUNTIME_API_TOKEN "Your API IBM TOKEN"
22# Linux
23export QISKIT_IBM_RUNTIME_API_TOKEN="Your API IBM TOKEN"
24🚀 Running a Quantum Session
25Run directly from command line:
26
27bash
28Copy code
29python challenge.py --backend ibm_torino --shots 1024
30Output Example
31
32ini
33Copy code
34CHSH_S=2.39
35RAW_FILE=qdna_sessions/ibm_kyiv/QDNAID20251017163045_raw.json
36FEATURES_FILE=qdna_sessions/ibm_kyiv/QDNAID20251017163045_features.json
37SIGN_FILE=qdna_sessions/ibm_kyiv/QDNAID20251017163045_sign.json
38Or start the dashboard:
39
40bash
41Copy code
42streamlit run app.py
43📊 Output Files
44File Description
45*_raw.json Original quantum counts + full provenance metadata
46*_features.json Extracted metrics including chsh_S
47*_sign.json Digital signatures (HMAC + RSA) + pubkey fingerprint
48
49🔬 Quantum Provenance Workflow
50java
51Copy code
52Quantum Hardware → Counts → CHSH Verification
53 ↓
54 Feature Vectorization
55 ↓
56 Cryptographic Signing (HMAC + RSA)
57 ↓
58 Provenance Store (Immutable JSON)
59 ↓
60 Streamlit Dashboard / Verification API
61Each record forms a verifiable “QDNA-ID” chain, connecting physical behavior
62to digital authentication — enabling reproducibility, security, and trust.
63
64🧾 Example Signatures Block
65json
66Copy code
67"signatures": {
68 "hmac_sha256": "b4e9b1f...c74",
69 "rsa_sha256_hex": "9d3b...1f",
70 "algorithms": {
71 "hmac": "HMAC-SHA256",
72 "rsa": "RSA-PSS-SHA256"
73 },
74 "key_ids": {
75 "hmac": "dev-hmac-01",
76 "rsa": "dev-rsa-01"
77 },
78 "pubkey_fingerprint_sha256": "e3c0...9fa",
79 "created_at_utc": "2025-10-17T15:23:12Z"
80}
81🧮 Academic Context
82Discipline: Quantum Computing, Cryptography, Provenance Informatics
83
84Institution: Karabuk University
85
86Research Group: Quantum Provenance Initiative
87
88
89Lead Developer: Osamah N. Neamah
90
91This project serves as an academic Proof-of-Concept (PoC) — demonstrating a full-chain
92quantum trust model from hardware to digital signature.
93
94⚠️ License & Notice
95© 2025 QDNA-ID — Academic PoC License
96
97This work is provided for academic and research use only.
98Unauthorized commercial use, redistribution, or derivative production is prohibited
99without explicit written consent from the author.
100
101📬 Contact
102Author: Osamah N. Neamah
103
104Institution: Karabuk University — Quantum Provenance Initiative
105
106Email: osamannehme@gmail.com
107
108LinkedIn: linkedin.com/in/osamah-n-neamah-b2774118b
109
110Website: qdnaid.org (coming soon)