Skip to content

Commit a26e36a

Browse files
authored
Create architecture.md
1 parent dbfe539 commit a26e36a

File tree

1 file changed

+50
-0
lines changed

1 file changed

+50
-0
lines changed

docs/architecture.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
# Component-Level Architecture
2+
```
3+
+===========================================================+
4+
| QuantumOS Blockchain |
5+
| (Substrate Runtime with Custom Pallets) |
6+
|-----------------------------------------------------------|
7+
| - pallet-task: Task creation, assignment, reward logic |
8+
| - pallet-verifier: ZKP & result validation |
9+
| - pallet-balances / staking / governance |
10+
+============================▲==============================+
11+
|
12+
Submit result + proof (tx)
13+
|
14+
+============================|==============================+
15+
| Miner Node (Rust Daemon) |
16+
|-----------------------------------------------------------|
17+
| [ TaskFetcher ] <--- JSON-RPC / Subxt ---> Chain API |
18+
| [ PhysicsEngine ]: Runs simulation (e.g., spin model) |
19+
| [ ZK-Prover ]: Generates SNARK/STARK proof of work |
20+
| [ IPFSUploader ]: Uploads raw result to IPFS/Filecoin |
21+
| [ Submitter ]: Sends CID + ZKP to chain |
22+
+============================|==============================+
23+
|
24+
v
25+
+===========================================================+
26+
| Off-chain Storage (IPFS / Filecoin integration) |
27+
| - Store simulation outputs (data, logs, models, etc.) |
28+
| - Referenced by CID in blockchain state |
29+
+===========================================================+
30+
31+
32+
|
33+
v
34+
35+
+========================= QuantumOS dApp ==========================+
36+
| - Web UI to browse, create, and verify simulation tasks |
37+
| - Connect wallet (Polkadot.js, Talisman, etc.) |
38+
| - Display CID-linked results + proof status |
39+
| - Explorer, Miner leaderboard, staking, governance |
40+
+==================================================================+
41+
42+
```
43+
## Key Components
44+
- Component Description
45+
- pallet-task On-chain logic to define simulation tasks
46+
- pallet-verifier Verifies result + attached ZKP
47+
- PhysicsEngine Runs simulation workload (off-chain)
48+
- ZK-Prover Generates zero-knowledge proof of correctness
49+
- IPFSUploader Stores result data to decentralized storage
50+
- dApp Web-based frontend to interact with the chain

0 commit comments

Comments
 (0)