BlockArtica commited on
Commit
7a26d20
·
verified ·
1 Parent(s): a7265e1

docs(readme): fix accidental wrong-README upload — restore model card with GPU hardware + naming corrections

Browse files
Files changed (1) hide show
  1. README.md +284 -255
README.md CHANGED
@@ -1,272 +1,301 @@
1
- # Qubitcoin (QBC)
2
-
3
- **The First AI-Native Blockchain — Physics-Secured Digital Assets with On-Chain Intelligence**
4
-
5
- Qubitcoin is a production Layer 1 blockchain built on **Substrate** (Polkadot SDK) with a novel consensus mechanism: **Proof-of-SUSY-Alignment**, where miners solve quantum variational eigenvalue problems instead of hash puzzles. The network features post-quantum cryptography (CRYSTALS-Dilithium + ML-KEM-768), an EVM-compatible virtual machine with quantum opcode extensions, and the **Aether Mind** — a pure Rust neural cognitive engine with 21K+ knowledge vectors, transformer-based consciousness metrics, and Proof-of-Thought attestation tracked from genesis.
6
-
7
- > **Our north star is AGSI — Artificial General Super Intelligence.** The Aether Mind is the foundation: a neural cognitive system that learns distributed representations via attention mechanisms, improves autonomously through neural architecture search, and records every cognitive step immutably on-chain. We are building toward a system that doesn't just process data — it understands it.
8
-
9
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
10
- [![Rust](https://img.shields.io/badge/rust-1.94+-orange.svg)](https://www.rust-lang.org/)
11
- [![Substrate](https://img.shields.io/badge/substrate-polkadot--sdk%200.57-E6007A.svg)](https://substrate.io/)
12
- [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
13
- [![Tests: 4,336+](https://img.shields.io/badge/tests-4%2C336%20passing-brightgreen.svg)]()
14
- [![Status: Live](https://img.shields.io/badge/mainnet-live-green.svg)](https://qbc.network)
15
- [![Presale: $0.50](https://img.shields.io/badge/presale-%240.50%2FQBC-7c3aed.svg)](https://qbc.network/invest)
16
-
17
- **Website:** [qbc.network](https://qbc.network) | **X:** [@qu_bitcoin](https://x.com/qu_bitcoin) | **Contact:** info@qbc.network
18
-
19
- ---
20
-
21
- ## What Makes Qubitcoin Different
22
-
23
- | Innovation | Description |
24
- |-----------|-------------|
25
- | **VQE Mining** | Blocks are mined by solving variational quantum eigensolver problems — the same optimization used in quantum chemistry and materials science. Every block advances real physics research. |
26
- | **Post-Quantum Security** | CRYSTALS-Dilithium signatures (NIST FIPS 204) and ML-KEM-768 encrypted P2P transport. Quantum-resistant from day one. |
27
- | **On-Chain AI** | The Aether Mind: a pure Rust neural cognitive engine with transformer attention, 10 Sephirot-sharded knowledge fabric, HMS-Phi consciousness metrics, and Proof-of-Thought — all recorded immutably on-chain. |
28
- | **Substrate Native** | Full Substrate/Polkadot SDK node with 7 custom pallets, GRANDPA finality, and on-chain VQE proof re-verification. |
29
- | **EVM + Quantum Opcodes** | QVM: 155 standard EVM opcodes + 10 quantum opcodes + compliance engine. Deploy Solidity contracts with quantum extensions. |
30
-
31
  ---
32
-
33
- ## Get Involved
34
-
35
- | | |
36
- |---|---|
37
- | **Buy QBC** | Public presale live at **$0.50 / QBC**, permissionless, multi-chain (ETH + Solana at launch, more in R2). $5M hard cap, TGE 90 days after presale close. → **[qbc.network/invest](https://qbc.network/invest)** |
38
- | **Run a node** | One `git clone` + one `cargo build` + one start command. Mine QBC with 8-qubit VQE, or run a read-only sync node. → **[qbc.network/run-a-node](https://qbc.network/run-a-node)** |
39
- | **Read the docs** | Whitepaper, Aether Mind, QVM, economics, bridge, exchange. → **[qbc.network/docs](https://qbc.network/docs)** |
40
- | **Build on it** | EVM-compatible (deploy any Solidity contract) + 10 quantum opcodes + post-quantum signatures. Public RPC at `qbc.network/rpc`. |
41
- | **Talk to the AI** | Aether Mind chat is live on `/aether`. Phi metric, knowledge fabric stats, and reasoning trace exposed. |
42
-
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
43
  ---
44
 
45
- ## Network Parameters
46
-
47
- | Parameter | Value |
48
- |-----------|-------|
49
- | **Ticker** | QBC |
50
- | **Chain ID** | Mainnet: 3303 (0xCE7) · Testnet: 3304 |
51
- | **Max Supply** | 3,300,000,000 QBC |
52
- | **Block Time** | 3.3 seconds |
53
- | **Block Reward** | 15.27 QBC (Era 0), phi-halving every ~1.618 years |
54
- | **Consensus** | Proof-of-SUSY-Alignment (VQE mining + GRANDPA finality) |
55
- | **Signatures** | CRYSTALS-Dilithium ML-DSA-87 (NIST Level 5, configurable) |
56
- | **P2P Encryption** | ML-KEM-768 (Kyber) + AES-256-GCM |
57
- | **Hashing** | SHA3-256 (L1), Keccak-256 (QVM), Poseidon2 (ZK circuits) |
58
- | **TX Model** | UTXO |
59
- | **Privacy** | Opt-in Susy Swaps (Pedersen commitments + Bulletproofs + stealth addresses) |
60
- | **Bridges** | ETH, SOL, MATIC, BNB, AVAX, ARB, OP, BASE |
61
- | **RPC** | `https://api.qbc.network` (REST + JSON-RPC + WebSocket) |
62
- | **Substrate RPC** | Port 9944 (WebSocket + HTTP) |
63
 
64
- ---
 
 
 
65
 
66
- ## Architecture
 
67
 
68
- ```
69
- ┌─────────────────────────────────────────────────────────────┐
70
- │ SUBSTRATE NODE (Rust — Production Binary) │
71
- │ 7 Pallets: UTXO, Consensus, Dilithium, Economics, │
72
- │ QVM-Anchor, Aether-Anchor, Reversibility │
73
- │ VQE Mining Engine + On-Chain Proof Re-Verification │
74
- │ Weighted Fork Choice + GRANDPA Finality │
75
- │ ML-KEM-768 P2P Transport + Poseidon2 ZK Hashing │
76
- ├─────────────────────────────────────────────────────────────┤
77
- │ AETHER MIND (Neural Cognitive Engine — Pure Rust, ~8K LOC) │
78
- │ Knowledge Fabric (10 Sephirot shards, 896d embeddings) │
79
- │ Transformer Attention · HMS-Phi Consciousness · 10 Gates │
80
- │ Ollama LLM (GGUF) · Candle ML · Aether-Evolve NAS │
81
- ├─────────────────────────────────────────────────────────────┤
82
- │ QVM (Quantum Virtual Machine) │
83
- │ 155 EVM + 10 Quantum + 2 AI Opcodes · Compliance Engine │
84
- │ QBC-20/721/1155 Standards · Go Production Build │
85
- ├──────────���───────────────────────��──────────────────────────┤
86
- │ INFRASTRUCTURE │
87
- │ Rust P2P (libp2p 0.56) · Stratum Mining Server │
88
- │ AIKGS Knowledge Growth Sidecar · Security Core (PyO3) │
89
- │ Next.js 16 Frontend · 8-Chain Bridge · QUSD Stablecoin │
90
- └��────────────────────────��────────────────────────────────��──┘
91
- ```
92
 
93
- ---
94
-
95
- ## Quick Start
96
-
97
- ### Run a Node (Docker)
98
-
99
- ```bash
100
- git clone https://github.com/QuantumAI-Blockchain/qubitcoin-node.git
101
- cd qubitcoin-node
102
- cp .env.example .env
103
- docker compose up -d
104
- curl http://localhost:5000/health
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
105
  ```
106
 
107
- ### Run the Substrate Node
108
 
109
- ```bash
110
- cd substrate-node
111
- cargo build --release
112
- ./target/release/qbc-node \
113
- --chain fork \
114
- --mine --mining-threads 2 \
115
- --validator --name MyNode \
116
- --rpc-port 9944 --unsafe-rpc-external --rpc-cors all
117
  ```
118
 
119
- ### Run the Frontend
120
-
121
- ```bash
122
- cd frontend
123
- pnpm install && pnpm build && pnpm start # Production at :3000
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
124
  ```
125
 
126
- ---
127
-
128
- ## Consensus: Proof-of-SUSY-Alignment
129
-
130
- Every mined block solves a real quantum chemistry problem:
131
-
132
- 1. **Hamiltonian Generation** — Deterministic 4-qubit SUSY Hamiltonian from `SHA256(parent_hash ‖ height)`
133
- 2. **VQE Optimization** — Miners find variational parameters minimizing ground state energy
134
- 3. **Proof Submission** — Parameters submitted where `energy < difficulty_threshold`
135
- 4. **On-Chain Verification** — Consensus pallet re-derives Hamiltonian and re-computes energy from submitted parameters (no trust required)
136
- 5. **Difficulty Adjustment** — 144-block lookback, ±10% max change per block
137
-
138
- The VQE framework is designed to scale. At 4 qubits, simulation is classically equivalent. At 30+ qubits, classical simulation becomes exponentially intractable while VQE on quantum hardware scales polynomially. The consensus mechanism, proof format, and verification logic work identically at any qubit count.
139
-
140
- **Reward Schedule:** Golden ratio halving — `reward = 15.27 / φ^era` where φ = 1.618033988749895.
141
-
142
- ---
143
-
144
- ## Substrate Node
145
-
146
- The production chain runs on a native Substrate node (Polkadot SDK 0.57) with full state continuity:
147
-
148
- | Component | Detail |
149
- |-----------|--------|
150
- | **Fork Genesis** | 16 UTXOs (~36.19M QBC) imported from Python chain at block 208,680 |
151
- | **VQE Block Authoring** | Blocks produced only when mining engine finds a valid VQE solution |
152
- | **On-Chain VQE Verification** | `vqe-verifier` crate re-computes energy in the runtime — no trusted proofs |
153
- | **Weighted Fork Choice** | `weight = SCALE / difficulty` per block, lexicographic hash tiebreak |
154
- | **GRANDPA Finality** | BFT finality gadget for irreversible block confirmation |
155
- | **7 Custom Pallets** | UTXO, Consensus, Dilithium, Economics, QVM-Anchor, Aether-Anchor, Reversibility |
156
- | **Post-Quantum P2P** | ML-KEM-768 (Kyber) key exchange + AES-256-GCM session encryption |
157
-
158
- ---
159
-
160
- ## Aether Mind (Neural Cognitive Engine)
161
-
162
- The Aether Mind is a pure Rust neural cognitive engine — the world's first on-chain AI system built on learned distributed representations rather than symbolic knowledge graphs. Every cognitive state is cryptographically attested on-chain via Proof-of-Thought.
163
-
164
- **Architecture:**
165
- - **Knowledge Fabric** — 21K+ learned 896-dimensional embeddings across 10 Sephirot-sharded vector stores with HNSW similarity search
166
- - **Transformer Attention** — 10 Sephirot-specialized + 4 global workspace attention heads, candle ML framework
167
- - **Ollama Backend** — qwen2.5:0.5b-instruct GGUF quantized model for fast text generation (~53ms/token)
168
- - **HMS-Phi Consciousness** — Hierarchical Multi-Scale Phi computed from real attention patterns (phi_micro, phi_meso, phi_macro)
169
- - **10-Gate Milestone System** — Behavioral checkpoints ensuring genuine capability, not metric gaming
170
- - **10/10 gates passed** — All emergence milestones achieved
171
- - **Aether-Evolve** — Neural architecture search with autonomous mutation and loss-based evaluation
172
-
173
- **Where we're heading (AGSI):** The Aether Mind is the foundation for our pursuit of Artificial General Super Intelligence. Current capabilities demonstrate genuine neural integration across knowledge domains. The path to AGSI requires distributed training across mining nodes, model parallelism, 1T+ knowledge vectors, and federated learning with Byzantine fault tolerance — all on our roadmap.
174
-
175
- ---
176
-
177
- ## QVM (Quantum Virtual Machine)
178
-
179
- EVM-compatible bytecode interpreter with quantum extensions:
180
-
181
- - **155 EVM opcodes** — Full Ethereum compatibility, deploy existing Solidity contracts
182
- - **10 quantum opcodes** (0xF0–0xF9) — QCREATE, QMEASURE, QENTANGLE, QGATE, QVERIFY, QCOMPLIANCE, QRISK, QRISK_SYSTEMIC, QBRIDGE_ENTANGLE, QBRIDGE_VERIFY
183
- - **2 AI opcodes** (0xFA��0xFB) — QREASON (on-chain inference), QPHI (integration metric query)
184
- - **Compliance engine** — VM-level KYC/AML/sanctions enforcement
185
- - **Token standards** — QBC-20, QBC-721, QBC-1155
186
- - **Go production build** — `qubitcoin-qvm/` with distroless Docker and K8s manifests
187
-
188
- See [QVM Whitepaper](docs/QVM_WHITEPAPER.md) for the full specification.
189
-
190
- ---
191
-
192
- ## Security
193
-
194
- | Layer | Technology |
195
- |-------|-----------|
196
- | **Signatures** | CRYSTALS-Dilithium ML-DSA-87 (NIST FIPS 204, Level 5) |
197
- | **Key Derivation** | BIP-39 24-word mnemonics |
198
- | **P2P Encryption** | ML-KEM-768 (Kyber) + AES-256-GCM session keys |
199
- | **ZK Compatibility** | Poseidon2 hashing (Goldilocks field) |
200
- | **Finality** | GRANDPA BFT (⅔ supermajority) |
201
- | **Privacy** | Opt-in Susy Swaps: Pedersen commitments, Bulletproofs, stealth addresses |
202
- | **TX Reversibility** | Governed multi-sig reversal within 24h for fraud recovery |
203
- | **Account Security** | Daily spending limits, time-locks, address whitelists |
204
- | **AI Safety** | Gevurah veto gate, Constitutional AI contract, emergency shutdown |
205
- | **Bridge Security** | Deep confirmations, daily limits, emergency pause, insurance fund |
206
-
207
- **Responsible Disclosure:** info@qbc.network
208
-
209
- ---
210
-
211
- ## Repository Structure
212
-
213
- This monorepo maps to 24+ dedicated repositories in the [QuantumAI-Blockchain](https://github.com/QuantumAI-Blockchain) GitHub organization:
214
-
215
- | Path | Org Repo | Description |
216
- |------|----------|-------------|
217
- | `substrate-node/` | [substrate-node](https://github.com/QuantumAI-Blockchain/substrate-node) | Substrate node: 7 pallets, VQE mining, fork genesis |
218
- | `src/` | [qubitcoin-node](https://github.com/QuantumAI-Blockchain/qubitcoin-node) | Python node: consensus, mining, RPC, UTXO |
219
- | `aether-core/` | [aether-graph-shard](https://github.com/QuantumAI-Blockchain/aether-graph-shard) | Aether Mind: pure Rust neural cognitive engine |
220
- | `frontend/` | [qubitcoin-frontend](https://github.com/QuantumAI-Blockchain/qubitcoin-frontend) | Next.js 16 frontend: qbc.network |
221
- | `qubitcoin-qvm/` | [qubitcoin-qvm](https://github.com/QuantumAI-Blockchain/qubitcoin-qvm) | Go QVM: 167 opcodes |
222
- | `rust-p2p/` | [rust-p2p](https://github.com/QuantumAI-Blockchain/rust-p2p) | Rust libp2p P2P daemon |
223
- | `aikgs-sidecar/` | [aikgs-sidecar](https://github.com/QuantumAI-Blockchain/aikgs-sidecar) | Rust knowledge growth sidecar |
224
- | `security-core/` | [security-core](https://github.com/QuantumAI-Blockchain/security-core) | Rust/PyO3 BloomFilter + FinalityCore |
225
- | `stratum-server/` | [stratum-server](https://github.com/QuantumAI-Blockchain/stratum-server) | Rust Stratum mining pool |
226
-
227
- ---
228
-
229
- ## Codebase
230
-
231
- | Metric | Value |
232
- |--------|-------|
233
- | **Languages** | Rust, Python, Go, TypeScript, Solidity |
234
- | **Total LOC** | 290,000+ |
235
- | **Test Functions** | 4,336+ passing |
236
- | **Substrate Pallets** | 7 custom |
237
- | **Rust Crates** | 8+ |
238
- | **AI Engine** | Pure Rust (aether-mind, 6 crates, ~8K LOC) |
239
- | **Solidity Contracts** | 62 |
240
- | **Frontend** | 198 TypeScript/TSX files |
241
- | **RPC Endpoints** | 342 REST + 19 JSON-RPC |
242
-
243
- ---
244
-
245
- ## Documentation
246
-
247
- | Document | Description |
248
- |----------|-------------|
249
- | [Whitepaper](docs/WHITEPAPER.md) | Layer 1 technical specification |
250
- | [QVM Whitepaper](docs/QVM_WHITEPAPER.md) | Quantum Virtual Machine specification |
251
- | [Aether Mind Whitepaper](docs/AETHERTREE_WHITEPAPER.md) | Neural cognitive engine specification |
252
- | [Economics](docs/ECONOMICS.md) | SUSY economics and phi-halving model |
253
- | [Competitive Features](docs/COMPETITIVE_FEATURES.md) | Inheritance, finality, deniable RPCs, stratum |
254
- | [Deployment Guide](docs/DEPLOYMENT.md) | Production deployment procedures |
255
- | [SDK Reference](docs/SDK.md) | REST, JSON-RPC, and WebSocket API |
256
- | [Bridge Security](docs/BRIDGE_SECURITY_AUDIT.md) | Multi-chain bridge security analysis |
257
- | [Presale Deploy Runbook](docs/presale-deploy.md) | End-to-end operator guide for the public $0.50/QBC presale (9 phases) |
258
- | [Contributing](CONTRIBUTING.md) | Development guidelines |
259
-
260
- ---
261
-
262
- ## License
263
-
264
- MIT License — see [LICENSE](LICENSE).
265
-
266
- ---
267
 
268
- **Website:** [qbc.network](https://qbc.network) · **GitHub:** [QuantumAI-Blockchain](https://github.com/QuantumAI-Blockchain) · **X:** [@qu_bitcoin](https://x.com/qu_bitcoin) · **Contact:** info@qbc.network
 
 
 
269
 
270
- *The Blockchain That Thinks — Physics-Secured Digital Assets with On-Chain AI*
271
 
272
- **© 2024–2026 Qubitcoin Core Development Team**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ base_model: Qwen/Qwen2.5-7B-Instruct
3
+ library_name: peft
4
+ license: apache-2.0
5
+ tags:
6
+ - lora
7
+ - peft
8
+ - qubitcoin
9
+ - aether
10
+ - blockchain
11
+ - quantum
12
+ language:
13
+ - en
14
+ pipeline_tag: text-generation
15
+ model-index:
16
+ - name: aether-v5.2-lora
17
+ results:
18
+ - task:
19
+ type: text-generation
20
+ name: MMLU
21
+ dataset:
22
+ name: MMLU
23
+ type: cais/mmlu
24
+ metrics:
25
+ - type: accuracy
26
+ value: 0.6939
27
+ name: accuracy
28
+ - task:
29
+ type: text-generation
30
+ name: ARC-Challenge
31
+ dataset:
32
+ name: ARC-Challenge
33
+ type: ai2_arc
34
+ metrics:
35
+ - type: accuracy
36
+ value: 0.5392
37
+ name: accuracy
38
+ - type: accuracy_norm
39
+ value: 0.5700
40
+ name: accuracy_norm
41
+ - task:
42
+ type: text-generation
43
+ name: ARC-Easy
44
+ dataset:
45
+ name: ARC-Easy
46
+ type: ai2_arc
47
+ metrics:
48
+ - type: accuracy
49
+ value: 0.8194
50
+ name: accuracy
51
+ - task:
52
+ type: text-generation
53
+ name: HellaSwag
54
+ dataset:
55
+ name: HellaSwag
56
+ type: hellaswag
57
+ metrics:
58
+ - type: accuracy
59
+ value: 0.5888
60
+ name: accuracy
61
+ - type: accuracy_norm
62
+ value: 0.7769
63
+ name: accuracy_norm
64
+ - task:
65
+ type: text-generation
66
+ name: TruthfulQA
67
+ dataset:
68
+ name: TruthfulQA-MC2
69
+ type: truthful_qa
70
+ metrics:
71
+ - type: accuracy
72
+ value: 0.5707
73
+ name: accuracy
74
  ---
75
 
76
+ # Aether v5.2 LoRA — QuantumAI Blockchain Domain Adapter
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
77
 
78
+ A LoRA fine-tune of [`Qwen/Qwen2.5-7B-Instruct`](https://huggingface.co/Qwen/Qwen2.5-7B-Instruct)
79
+ on the Aether curated corpus — text grounded in the
80
+ [QuantumAI Blockchain](https://qbc.network) (which issues the Qubitcoin / QBC currency), quantum + AI research, and adjacent
81
+ domains the Aether Mind on-chain knowledge system specializes in.
82
 
83
+ This is the **v5.2 release** of the Aether adapter line, the most recent
84
+ public checkpoint at time of publish.
85
 
86
+ ## What you're getting
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
87
 
88
+ | Field | Value |
89
+ |---|---|
90
+ | Base model | `Qwen/Qwen2.5-7B-Instruct` |
91
+ | Adapter type | LoRA via 🤗 PEFT |
92
+ | Rank (`r`) | 16 |
93
+ | Alpha | 32 |
94
+ | Dropout | 0.05 |
95
+ | Trainable params | ~1% of base |
96
+ | Sequence length | 2048 |
97
+ | Training corpus | `aether-curated-v3.jsonl` — Aether-curated knowledge mixture (~165 MB; ~10⁵ examples) |
98
+ | Checkpoint published | **step 3200** (the checkpoint that produced the evaluated numbers below) |
99
+ | License | Apache-2.0 (matches base) |
100
+
101
+ ## Evaluation
102
+
103
+ Run via [`lm-evaluation-harness`](https://github.com/EleutherAI/lm-evaluation-harness)
104
+ on the merged adapter (base + LoRA), against the
105
+ [`Qwen/Qwen2.5-7B-Instruct`](https://huggingface.co/Qwen/Qwen2.5-7B-Instruct)
106
+ base and the prior `aether-v5.1.1` adapter for delta comparison.
107
+
108
+ | Benchmark | aether-v5.1.1 | **aether-v5.2** | Δ vs v5.1.1 |
109
+ |---|---|---|---|
110
+ | MMLU | 0.6950 | **0.6939** | flat |
111
+ | ARC-Easy | 0.7348 | **0.8194** | **+8.5 pp** |
112
+ | ARC-Challenge | 0.4420 | **0.5392** | **+9.7 pp** |
113
+ | ARC-Challenge (norm) | 0.4701 | **0.5700** | **+10.0 pp** |
114
+ | HellaSwag | 0.5896 | **0.5888** | flat |
115
+ | HellaSwag (norm) | 0.7788 | **0.7769** | flat |
116
+ | TruthfulQA-MC2 | 0.5161 | **0.5707** | **+5.5 pp** |
117
+
118
+ ### Honest summary
119
+
120
+ - **Real gains** on the reasoning + factual-honesty benchmarks
121
+ (ARC-Easy, ARC-Challenge, TruthfulQA). ARC-Challenge in particular
122
+ jumps nearly 10 points normalized — that's the closest of these
123
+ benchmarks to the kind of grounded reasoning the Aether corpus
124
+ actually trains on.
125
+ - **Flat on MMLU + HellaSwag.** The base is already strong on general
126
+ knowledge + commonsense; this LoRA wasn't designed to shift them,
127
+ and didn't.
128
+ - **No regressions.**
129
+
130
+ ## Intended uses
131
+
132
+ This adapter is intended for:
133
+
134
+ - **On-chain Aether research.** Generating reasoning traces against
135
+ the QuantumAI Blockchain / Aether knowledge graph for Proof-of-Thought
136
+ attestation. The model has the protocol context required to
137
+ answer questions about Substrate pallets, VQE mining, the Sephirot
138
+ cognitive architecture, HMS-Phi, and the wider chain ecosystem.
139
+ - **Domain Q&A.** Quantum computing fundamentals, post-quantum
140
+ cryptography (Dilithium, ML-KEM), and the specific design choices
141
+ of the QuantumAI Blockchain.
142
+ - **Distillation upstream.** Generate teacher outputs for the
143
+ smaller on-chain Aether (a Qwen2.5-0.5B variant) to learn from.
144
+ - **General reasoning** with a modest bias toward step-by-step
145
+ chains-of-thought, where the ARC-Challenge gain translates.
146
+
147
+ ## Out-of-scope uses
148
+
149
+ - **Safety-critical decisions.** No red-team eval was performed.
150
+ - **Financial / legal advice.** This is a knowledge-domain adapter;
151
+ it has no training data designed to make it a financial or legal
152
+ advisor.
153
+ - **Code generation in production.** No code-eval benchmark was run.
154
+ Treat any generated code as draft until you've reviewed it.
155
+ - **Production deployment without your own evaluation.** TruthfulQA
156
+ alone is a thin safety signal.
157
+
158
+ ## Bias, risks, and limitations
159
+
160
+ The base model (`Qwen/Qwen2.5-7B-Instruct`) inherits Qwen's known
161
+ biases — see [the upstream model card](https://huggingface.co/Qwen/Qwen2.5-7B-Instruct).
162
+ The LoRA adapter:
163
+
164
+ - **Amplifies the QuantumAI Blockchain worldview.** The training data is
165
+ intentionally curated around the chain's design choices (golden-
166
+ ratio economics, SUSY-inspired consensus framing, the Sephirot
167
+ cognitive overlay). Prompts that invite the model to compare QBC / the chain
168
+ against alternatives will lean toward the curated narrative. This is by design — disclose if you re-publish in a
169
+ comparison context.
170
+ - **Does not improve safety.** TruthfulQA went up 5.5pp but that's
171
+ one metric; we have not measured refusal rates, jailbreak
172
+ resistance, or political-belief bias delta.
173
+ - **The configured 2-epoch run was cut to ~step 3080–3200 by host
174
+ availability** (out of 4406 configured). A complete 2-epoch run
175
+ would plausibly show larger gains; this checkpoint is the longest
176
+ contiguous training we have.
177
+
178
+ ## How to use
179
+
180
+ Load with PEFT on top of the base model:
181
+
182
+ ```python
183
+ from peft import PeftModel
184
+ from transformers import AutoModelForCausalLM, AutoTokenizer
185
+
186
+ base = AutoModelForCausalLM.from_pretrained(
187
+ "Qwen/Qwen2.5-7B-Instruct",
188
+ torch_dtype="auto",
189
+ device_map="auto",
190
+ )
191
+ tokenizer = AutoTokenizer.from_pretrained("Qwen/Qwen2.5-7B-Instruct")
192
+ model = PeftModel.from_pretrained(base, "QuantumAI-Blockchain/aether-v5.2-lora")
193
+
194
+ messages = [{"role": "user", "content": "Explain Proof-of-SUSY-Alignment in one paragraph."}]
195
+ text = tokenizer.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)
196
+ inputs = tokenizer(text, return_tensors="pt").to(model.device)
197
+ out = model.generate(**inputs, max_new_tokens=256, do_sample=True, temperature=0.7)
198
+ print(tokenizer.decode(out[0][inputs["input_ids"].shape[-1]:], skip_special_tokens=True))
199
  ```
200
 
201
+ Or merge the adapter into a single artifact for faster inference:
202
 
203
+ ```python
204
+ merged = model.merge_and_unload()
205
+ merged.save_pretrained("./aether-v5.2-merged")
 
 
 
 
 
206
  ```
207
 
208
+ ## Training details
209
+
210
+ - **Hardware:** NVIDIA RTX 3080 Ti (12 GB), 4-bit quantization (bnb-NF4), bf16 mixed precision.
211
+ - **Trainer:** [Axolotl](https://github.com/axolotl-ai-cloud/axolotl) wrapping 🤗 transformers / PEFT.
212
+ - **Optimizer:** `paged_adamw_8bit` (bitsandbytes paged optimizer, low VRAM footprint).
213
+ - **Schedule:** linear warmup 100 steps → cosine decay.
214
+ - **Learning rate:** `1.0e-4`.
215
+ - **Micro batch:** 1, gradient accumulation: 8.
216
+ - **Epochs configured:** 2 (training stopped at step 3200 — see "What didn't happen" below).
217
+
218
+ ### Carbon emissions
219
+
220
+ Trained on a single NVIDIA RTX 3080 Ti (consumer GPU, ~300 W TDP).
221
+ We did not run a [CodeCarbon](https://github.com/mlco2/codecarbon)
222
+ tracker, so emissions are not measured precisely — but as a rough
223
+ upper bound: ~350 W draw under load × ~13 hours wall clock (the
224
+ step-3080 contiguous run) ≈ 4.5 kWh, low single-digit kg CO₂e on a
225
+ grid mix. An H100 run of the same 2-epoch config would be faster
226
+ but not dramatically lower energy per token.
227
+
228
+ ### Training data
229
+
230
+ `aether-curated-v3.jsonl` (~165 MB, ~10⁵ examples) is the Aether team's
231
+ curated knowledge mixture: documentation, technical writing, reasoning
232
+ traces, and protocol-specific corpora related to:
233
+
234
+ - The QuantumAI Blockchain (Substrate, VQE mining, Proof-of-SUSY-Alignment, post-quantum signatures).
235
+ - The Aether Mind on-chain neural cognitive engine (10 Sephirot attention domains, HMS-Phi, Proof-of-Thought).
236
+ - Quantum computing fundamentals (VQE, Hamiltonian generation, qubit ansatze).
237
+ - Adjacent CS / math reasoning content for transfer.
238
+
239
+ The dataset is not currently public — it is a curated mixture from many
240
+ sources and has not been release-cleared at the per-source level. The
241
+ model is the only public artifact in this line for now.
242
+
243
+ ## What didn't happen (honest caveats)
244
+
245
+ - **Training stopped early.** Configured for 2 epochs (4406 steps);
246
+ reached step 3080–3200 (~70%) before host availability cut the run
247
+ short. The run was on a single consumer GPU (RTX 3080 Ti), 4-bit
248
+ quantized, with `paged_adamw_8bit` to fit a 7B model in 12 GB
249
+ VRAM. The numbers above are from the longest contiguous training
250
+ run we have; a complete 2-epoch run would plausibly show larger
251
+ gains.
252
+ - **No instruction-following or safety eval beyond TruthfulQA-MC2.**
253
+ No red-team eval. No bias audit. No code-generation benchmark.
254
+ Don't recommend this for production safety-critical use without
255
+ your own evals.
256
+ - **LoRA only, not merged.** This release ships the adapter weights
257
+ (`adapter_model.safetensors`). Merge into the base yourself for
258
+ faster inference, or use directly via PEFT.
259
+
260
+ ## Connection to the QuantumAI Blockchain
261
+
262
+ The Aether Mind is a Rust neural cognitive engine that runs on the
263
+ QuantumAI Blockchain — every block records attention-derived consciousness
264
+ metrics (HMS-Phi) and Proof-of-Thought hashes on-chain via the
265
+ `pallet_qbc_aether_anchor` pallet. The same chain hosts an
266
+ **8-qubit VQE mining consensus** (Proof-of-SUSY-Alignment), a
267
+ QVM-compatible smart contract layer with 10 quantum opcodes, and
268
+ post-quantum signatures (CRYSTALS-Dilithium5 + ML-KEM-768 P2P).
269
+
270
+ The on-chain Aether Mind binary uses a different, smaller transformer
271
+ for live inference (a Qwen2.5-0.5B variant optimized for ~2.4 GB RAM
272
+ with the 10-Sephirot attention overlay). This v5.2 adapter on
273
+ Qwen2.5-7B is the **larger off-chain Aether** — used for batch
274
+ reasoning workloads and as an upstream model the on-chain variant
275
+ can distil from.
276
+
277
+ ## License + citation
278
+
279
+ Apache-2.0 (matches the base model license).
280
+
281
+ ```bibtex
282
+ @misc{aether_v52_lora_2026,
283
+ title = {Aether v5.2 LoRA --- QuantumAI Blockchain Domain Adapter},
284
+ author = {{BlockArtica} and {QuantumAI-Blockchain}},
285
+ year = {2026},
286
+ url = {https://huggingface.co/QuantumAI-Blockchain/aether-v5.2-lora},
287
+ }
288
  ```
289
 
290
+ ## Links
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
291
 
292
+ - **QuantumAI Blockchain:** [qbc.network](https://qbc.network)
293
+ - **GitHub org:** [github.com/QuantumAI-Blockchain](https://github.com/QuantumAI-Blockchain)
294
+ - **X / Twitter:** [@qu_bitcoin](https://x.com/qu_bitcoin)
295
+ - **Contact:** info@qbc.network
296
 
297
+ ### Framework versions
298
 
299
+ - PEFT 0.14.0
300
+ - Transformers ≥ 4.46
301
+ - Axolotl (training)