MAINNET PREVIEW · NIST FIPS 204 · NVIDIA-LOCKED

Post-quantum distributed trust,
NVIDIA GPU-attested by design.

QSDM is the Quantum-Secure Dynamic Mesh Ledger — a non-AI, hardware-agnostic electronic cash and smart-contract fabric with a native coin, Cell (CELL). It is built on ML-DSA-87 post-quantum signatures, a dynamic 2D/3D mesh topology, and Proof-of-Entanglement BFT consensus that runs on CPU-only validators. An additive NVIDIA-locked GPU mining layer (v2 protocol) mints Cell via attested proofs from operator-enrolled GPUs; validators can additionally publish NGC bundles as a transparency signal.

Signature scheme
ML-DSA-87
NIST FIPS 204 · 256-bit PQ security
Verify speed
0.19 ms
1.76× faster than ECDSA (0.33 ms)
Sig compression
~50%
zstd on signatures; 60–70% on tx storage
Batch signing
10–100×
vs single-tx baseline
Consensus
Proof-of-Entanglement
CPU validators · no proof-of-work · mesh-native
Storage engines
SQLite → ScyllaDB
Zstandard-compressed, linear migration path
PLATFORM

One ledger, two node roles.

QSDM is the unified platform; Cell (CELL) is its native coin. The node software ships in two roles that share the same cryptography, wire format, and mesh topology: validators run Proof-of-Entanglement BFT consensus on CPU-only VPS-class hardware and earn transaction fees, while miners run an additive GPU proof-of-work layer that emits Cell from home rigs.

Validator · CPU-only · VPS

QSDM Validator Node

The consensus tier. A lattice-based, mesh-structured electronic cash system engineered from the first block to be quantum-resistant — no retrofits, no hybrids. Validators never require a GPU; Proof-of-Entanglement BFT runs on CPU. Optional NGC attestation acts as a transparency signal, not as a consensus rule.

  • ML-DSA-87 signatures (NIST FIPS 204) via liboqs
  • libp2p networking with GossipSub + PEX
  • SQLite or ScyllaDB storage with Zstandard compression
  • Proof-of-Entanglement consensus (PoE) with multi-parent cell validation
  • 2D/3D mesh topology, submesh profiles, and WASM contract SDK
  • Dashboard, WebSocket topology, Prometheus scrape, audit reports, governance snapshots
  • Ubuntu 24.04+ and Windows 10+ supported; macOS in development
Miner · v2 NVIDIA-locked · enrollment + slashing

QSDM Miner (Cell emission)

The emission tier. An additive GPU proof-of-work layer for Cell (CELL) minting that runs independently of consensus. Under the v2 NVIDIA-locked protocol, every accepted proof must carry an NVIDIA attestation (nvidia-cc-v1 on Hopper/Blackwell Confidential-Compute GPUs, or nvidia-hmac-v1 on consumer RTX GPUs via a registered operator key). Miners enroll on-chain with a 10 CELL stake bond, receive a validator-signed challenge nonce, and can be slashed for forged or replayed attestations. The qsdmminer-console front-end ships the v2 client; the CUDA production miner lands after external audit.

  • Mandatory NVIDIA attestation on every proof (Tiered: CC for datacenter, HMAC for consumer)
  • On-chain enrollment: 10 CELL stake bond, 7-day unbond window, qsdm/enroll/v1 contract
  • Slashing: qsdm/slash/v1 transactions forfeit stake. Forged-attestation and double-mining verifiers are active; freshness-cheat awaits BFT-finality
  • 60-second freshness window on validator-signed challenge nonces (replay-proof)
  • Native coin Cell (CELL), 8 decimals, smallest unit dust
  • Halving emission schedule; 0% pre-mine, treasury cap 10%
  • Miners do not participate in consensus; separate qsdmminer-console binary
NVIDIA GPU EDGE

Silicon as a sybil-resistance primitive.

Most ledgers treat nodes as interchangeable processes — easy to spin up, easy to fake. QSDM binds two different node classes to real silicon in two different ways:

  • Validators (CPU-only BFT consensus) optionally publish HMAC-signed NGC bundles as a transparency signal. Attestation is not a consensus rule; Proof-of-Entanglement admits validators without a GPU.
  • Miners (GPU proof-of-work for Cell emission) must attach an NVIDIA attestation on every accepted proof under the v2 protocol. Enrollment carries a 10 CELL bond; forged, replayed, or freshness-violating proofs are slashable.

The result: identity that is physically grounded. You cannot clone a miner without cloning the silicon behind it — and if you try, the bond burns.

01 · Tiered Trust (v2)
CC + HMAC attestation
nvidia-cc-v1 uses NVIDIA Confidential-Compute AIK quotes on Hopper/Blackwell datacenter GPUs — the Phase 2c-iv verifier (pkg/mining/attest/cc/verifier.go) is now fully wired: cert chain rooted in genesis-pinned NVIDIA roots, ECDSA AIK quote verify, nonce/issued_at binding, freshness window, replay cache, PCR firmware floor, with 28 unit tests covering happy + 13 negative cases. nvidia-hmac-v1 uses a registered operator key for consumer RTX GPUs.
02 · On-chain Enrollment (v2)
Stake-bonded operator registry
qsdm/enroll/v1 contract. Miners bond 10 CELL to enroll an operator key; a 7-day (201,600-block) unbond window applies on exit.
03 · Slashing (v2)
Evidence-based forfeiture
qsdm/slash/v1 transactions forfeit bonded stake. Two of three slashers are active: forged-attestation (pkg/mining/slashing/forgedattest) catches HMAC / GPU-UUID / challenge-bind / deny-listed-GPU forgery, and double-mining (pkg/mining/slashing/doublemining) catches any operator that signs two distinct, valid v2 proofs at the same (epoch, height). The third (freshness-cheat) is wire-reserved pending BFT-finality. Up to 50% of the slashed stake rewards the slasher. Any slash that leaves the offender below the 10 CELL enrollment minimum auto-revokes the record into the standard 7-day unbond window — sub-bonded operators cannot keep mining for free.
04 · Challenge nonce (v2)
60-second freshness
Validators mint short-lived, signed challenges (GET /api/v1/mining/challenge). Miners bind each proof to a fresh nonce; replayed proofs fail the freshness gate.
05 · Observability (v2)
Prometheus + structured events
Every slashing and enrollment transition emits a labeled Prometheus counter (qsdm_slash_applied_total{kind}, qsdm_slash_rejected_total{reason}, qsdm_slash_auto_revoked_total{reason}, qsdm_enrollment_*) AND a typed audit event (MiningSlashEvent, EnrollmentEvent) on chain.ChainEventPublisher. Live gauges (qsdm_enrollment_active_count, qsdm_enrollment_bonded_dust, qsdm_enrollment_pending_unbond_count) snapshot the registry under one mutex per scrape. The pkg/chainpkg/monitoring seam is dependency-inverted, so binaries without monitoring pay zero overhead. Eleven shipped alert rules across qsdm-v2-mining-{slashing,enrollment,liveness} groups in deploy/prometheus/alerts_qsdm.example.yml page on mass-slash bursts (>50 CELL drained / 15m), coordinated unbond exits (pending_unbond > 50% sustained), empty-registry stalls, and chain-height freezes — with calibrated thresholds + runbook annotations naming the labelled break-out queries. CI runs promtool check rules on every change.
CONSENSUS BOUNDARY

PoE is consensus. GPU mining is emission.

Proof-of-Entanglement and BFT finality do every piece of consensus work on QSDM — block proposal, transaction ordering, and finality — on CPU-only validator nodes. GPUs on the mesh serve one narrow, additive role: NVIDIA-locked Cell emission (v2 protocol). Validator NGC bundles remain an optional transparency signal. Neither mining nor validator attestation gates consensus finality.

CONSENSUS · ALWAYS-ON
Proof-of-Entanglement + BFT
Runs on validators (CPU). Multi-parent cell validation, stake-weighted BFT voting, finality-gadget depth checks. No GPU, no proof-of-work, no waste cycles. The chain lives here.
ATTESTATION · OPT-IN
NVIDIA NGC proofs
Validators can opt into a signed GPU-attestation badge. Purely a transparency signal on the API boundary — it is not a consensus rule; blocks are never rejected for a missing proof.
MINING · ADDITIVE · CPU REFERENCE SHIPPED
GPU coin emission
A separable reward track: home operators submit hash-based proofs to earn newly-issued supply on a published schedule. The CPU reference miner (qsdmminer) and the friendly console front-end (qsdmminer-console) ship today; the CUDA production miner is gated on external audit. Mining never proposes blocks, never orders transactions, and can halt with zero effect on chain liveness.
HARD GUARANTEE
Validators are CPU-only
Validator builds ship without CUDA code, K8s manifests pin CPU-only nodes, and a startup guard fails fast if mining is mistakenly enabled. Running a validator requires zero GPU hardware — now and after the mining layer ships.

PoE + BFT consensus is live today. The mining layer is an additive subsystem — the CPU reference miner and a friendly console front-end are shipped in-tree; the CUDA production miner is gated on external audit. Mining does not change validator hardware requirements, consensus rules, or finality guarantees.

PARTICIPATE · MINE AT HOME

Mine Cell at home — NVIDIA-locked (v2 protocol).

The mining layer is the additive emission track for Cell (CELL). It is deliberately separate from consensus: miners never propose blocks, never order transactions, and can halt with zero effect on chain liveness. Under the v2 NVIDIA-locked protocol, every accepted proof must carry an NVIDIA attestation bound to an enrolled operator key, and forged or replayed proofs are slashable. Mining Cell is how new coins enter circulation — rewards depend on network difficulty and the current block reward, both of which change over time. qsdmminer-console ships today with a friendly console UI, first-run setup wizard, and the v2 client library; the CUDA production miner lands after external audit.

FRIENDLY CONSOLE · v2 SHIPPED
qsdmminer-console — start here
Run with no flags and a setup wizard prompts for your reward address and validator URL, saves the answers to ~/.qsdm/miner.toml, then opens a live console panel showing hashrate, accepted/rejected proofs, current epoch, and uptime. --plain switches to a one-line-per-event log mode for systemd / journalctl. The v2 NVIDIA-locked path is now fully wired end-to-end: --gen-hmac-key produces a 0o600 hex key file plus a copy-pasteable qsdmcli enroll snippet, an opt-in v2 sub-wizard walks operators through key generation and enrollment, and --protocol=v2 drives the runLoop through /api/v1/mining/challenge → HMAC bundle → Version=2 submit. The console panel grows a live v2 NVIDIA row carrying node, arch, attestation count, and challenge age, plus a sibling v2 enroll row painted by the in-binary EnrollmentPoller (--enrollment-poll, default 30 s, floor 5 s) which watches GET /api/v1/mining/enrollment/{node_id} and surfaces phase / stake / slashable inline — green for active, yellow for pending_unbond, red for revoked / not_found; phase transitions emit dedicated dashboard events so a slash-driven auto-revoke or a mistyped node_id shows up in seconds, not whenever proofs start failing. Coverage gated by TestIntegration_RunLoop_v2_EndToEnd and enrollment_poller_test.go (15 cases incl. a build-time api.EnrollmentRecordView wire-shape lock-in).
V2 PROTOCOL · CONSENSUS-ENFORCED
NVIDIA attestation + enrollment + slashing
Tiered trust model: nvidia-cc-v1 (AIK-signed quote on Hopper/Blackwell CC GPUs) or nvidia-hmac-v1 (operator-HMAC bundle on consumer RTX). Miners enroll on-chain with a 10 CELL bond (qsdm/enroll/v1), fetch a validator-signed challenge nonce (60s freshness), and face slashing (qsdm/slash/v1) for forged or replayed proofs. Stake unbonds after 7 days (201,600 blocks).
CUDA PRODUCTION · PLANNED
CUDA miner
Optimized for NVIDIA (CUDA 11+, ≥ 8 GB VRAM, RTX 20/30/40/50-class and Hopper/Blackwell). Under v2 the protocol is NVIDIA-locked by design: tensor-core PoW re-tuning is the Tier-3 scope item. Gated on external audit before release.
HOW YOU EARN
Block rewards — halving schedule
New Cell is emitted on every block according to the published emission schedule — 90 M lifetime mining cap, 4-year halvings, 0 % pre-mine, 10 % treasury cap. There are no daily-earnings promises here: difficulty and the block reward are both moving targets.

NVIDIA-only mining — hardware tiers

Under the v2 protocol QSDM mining is NVIDIA-locked by consensus: every accepted proof carries an NVIDIA attestation. Two tiers of trust anchor exist. The Confidential-Compute tier (nvidia-cc-v1) uses hardware-rooted AIK quotes on Hopper/Blackwell datacenter GPUs — rare in home setups but tamper-resistant end-to-end. The operator-HMAC tier (nvidia-hmac-v1) is the consumer path: operators register a key on-chain with a 10 CELL bond and sign their device-property bundles, backed by slashing.

Tier Hardware Attestation path (v2) Relative hashrate Enrollment / bond
Entry NVIDIA
RTX 3050 / 3060
CUDA 11+, 8 GB+ VRAM, NVIDIA Container Toolkit nvidia-hmac-v1 (operator-registered key) 1× baseline for v2 mining 10 CELL bond · 7-day unbond
Mid-range NVIDIA
RTX 3080 / 4070
CUDA 11+, ≥ 10 GB VRAM nvidia-hmac-v1 Scales with SM count + memory bandwidth 10 CELL bond · 7-day unbond
High-end consumer
RTX 4090 / 5090
CUDA 12+, ≥ 16 GB VRAM nvidia-hmac-v1 Rack-grade per-GPU economics 10 CELL bond · 7-day unbond
Datacenter · CC
H100 / H200 / B100 (CC mode)
Hopper/Blackwell in Confidential-Compute mode nvidia-cc-v1 (hardware AIK quote, no bond required) Highest per-watt; rare in home setups No bond · CC-pinned identity
Non-NVIDIA / CPU
AMD · Intel · x86 CPU
Not accepted under v2 (consensus reject) n/a n/a

Qualitative tiers, not benchmark commits. Actual hashrate depends on driver version, thermal/power budget, DAG size, and the current mesh3D epoch.

CONSUMER PATH · HMAC
10 CELL bond, operator-registered key
On-chain enrollment via POST /api/v1/mining/enroll (qsdm/enroll/v1 contract). Your registered key signs a bundle of CUDA device properties on every proof, and each proof binds to a fresh validator-signed challenge nonce (60 s freshness window). Forged / replayed / stale proofs are slashable — the 10 CELL bond is your skin in the game.
DATACENTER PATH · CC
No bond, AIK-signed hardware quote
Hopper/Blackwell in Confidential-Compute mode sign attestation quotes with a hardware-rooted AIK. The validator verifies the quote chain against NVIDIA's root; no operator bond is required because the trust anchor is the silicon itself. Consumer GPUs do not support CC.
SHIPPED KERNELS
CUDA is the supported fast path
pkg/mesh3d/cuda.go links libmesh3d_kernels.so, compiled with nvcc in the miner Dockerfile and built by CI on every main commit. Tensor-Core PoW re-tuning is the next tier of v2 work.

Jurisdictional restrictions, tax treatment, electricity costs, and heat/noise output vary widely by location and hardware. Evaluate your own situation before running a miner. Nothing on this page is financial or legal advice.

PARTICIPATE · RUN A VALIDATOR

Run a validator — VPS-class, CPU-only.

Validators are the consensus tier. They run Proof-of-Entanglement + BFT on CPU-only VPS-class hardware and earn transaction fees. No GPU is required — the NVIDIA lock applies to the mining emission layer, not to consensus. Startup guards in the validator build refuse to boot if mining is mistakenly enabled, so a validator operator never has to reason about GPU drivers, CUDA, or thermal budgets. NGC attestation is available if you want a transparency badge, but it is not required to participate in consensus and does not affect block validity.

HARDWARE
Modest CPU VPS
4–8 vCPU, 8–16 GB RAM, 200 GB NVMe, 1 Gbps symmetric. No GPU. Ubuntu 24.04+ or Windows 10+ supported today; macOS in development. Dockerfile and Kubernetes manifests ship CPU-only by default.
NETWORK ROLE
PoE + BFT consensus
Multi-parent cell validation, stake-weighted BFT voting, finality-gadget depth checks. libp2p + GossipSub networking. Validators earn transaction fees — mining rewards go to the separable miner track.
OPTIONAL · TRANSPARENCY
NGC attestation opt-in
Opt in to publish a signed NVIDIA NGC proof bundle and earn the "Attested" badge on the public trust page. This is an API-boundary policy — not a consensus rule — and validators that opt out are fully first-class on the network.
WHY IT MATTERS

Benefits of GPU-anchored, post-quantum mesh.

Put together, these properties let QSDM offer guarantees that traditional blockchains and DAGs cannot — without resorting to energy-hungry proof-of-work in the consensus path or stake concentrations that reintroduce custodial risk.

POST-QUANTUM

Harvest-now-decrypt-later-safe

ML-DSA-87 signatures protect ledger history from quantum adversaries that will break ECDSA and RSA. Today's signatures are still valid in 2040.

HARDWARE-BOUND

Sybil-resistant by silicon

GPU fingerprints + signed NGC proofs mean each validator is tied to a real device. Cloning a node means cloning a GPU — and we detect that.

THROUGHPUT

Mesh, not a chain

Cells can have multiple parents. Submeshes route by fee and geotag. There is no global block interval to throttle you.

ENERGY

No proof-of-work in consensus

Proof-of-Entanglement uses cryptographic linkage, not brute-force hashing. The planned GPU mining layer is an additive emission track — it never proposes or orders blocks.

NON-AI

Deterministic governance

Rule-based quarantines, snapshot voting, manual submesh templates. Auditable, reproducible, AI-free.

OPEN

libp2p + WASM + standard APIs

GossipSub transport, WASM smart contracts, REST + Prometheus endpoints. Nothing proprietary at the seams.

OPERABLE

Single-binary, dual-platform

One Go binary. Ubuntu 24.04+ and Windows 10+ supported today; macOS in development. Systemd + Caddy deploy in under an hour.

AUDITABLE

Metrics and reports by default

Prometheus /api/metrics/prometheus, audit markdown/JSON reports with severity gates, topology WebSocket, and signed release artifacts.

TECHNOLOGY COMPARISON

QSDM vs. traditional blockchains and DAGs.

A like-for-like comparison against representative systems. Values reflect the default, in-the-box configuration of each technology — not maximal lab setups.

Dimension QSDM Bitcoin · PoW Ethereum · PoS IOTA / Hedera · DAG
Data structure Dynamic 2D/3D mesh, multi-parent cells Linear block chain Linear block chain Directed acyclic graph
Consensus Proof-of-Entanglement (PoE) + BFT · CPU-only validators Proof-of-Work Proof-of-Stake (Gasper) Tangle / Hashgraph
Mining / emission Additive GPU track (planned) · never decides block order or finality Mining is consensus No mining; staking = consensus No mining; DAG voting = consensus
Quantum-safe signatures ML-DSA-87 (FIPS 204, 256-bit) ECDSA (secp256k1) BLS12-381 / ECDSA varies; mostly classical
GPU-attested validators NVIDIA NGC proofs + P2P gate
Energy profile Low; CUDA for validation, not PoW Very high (hash mining) Low (staking) Low
Throughput scaling Submesh parallelism + fee routing ~7 tps mainnet ~15–30 tps (L1) High (DAG parallelism)
Finality PoE + finality gadget, reorg-bounded Probabilistic (6 blocks) Epoch-based (~12–15 min) Varies; often probabilistic
AI/ML dependencies None — rule-based governance None None (core); apps vary Varies
Smart contracts WASM SDK (wallet, validator) Script (non-Turing) EVM EVM (Hedera), limited (IOTA)
Storage SQLite + Zstd → ScyllaDB path Flat files / LevelDB Merkle-Patricia trie Custom / DAG pruning
Deployment footprint 1 Go binary · Linux/Windows Full node required Execution + consensus client Protocol-specific tooling
Operator tooling Dashboard, Prometheus, audit reports, mTLS RPC + 3rd party RPC + 3rd party RPC + 3rd party

Figures shown are representative of default mainnet configurations. QSDM quantum-safe primitives are based on NIST FIPS 204 (ML-DSA) standardized in 2024.

ROADMAP

Three phases. One mesh.

QSDM ships in phases, with each phase deliverable and production-usable on its own. All three product phases are shipped: Phase 1 delivers consensus and storage, Phase 2 adds submesh routing and the ScyllaDB migration path, and Phase 3 brings 3D mesh validation with a live topology feed and reorg-safe partition healing.

2D Mesh Launch

Stable 2D mesh, manual bootstrapping, Proof-of-Entanglement, ML-DSA-87, SQLite with Zstd.

  • libp2p + GossipSub networking
  • Optimized signing (memory pool, batch 10–100×)
  • Operator dashboard, HTTPS via Caddy, UFW hardening
Shipped

Scalability & Optimization

Dynamic submeshes, priority routing, WASM contract SDK, ScyllaDB migration path.

  • Fee + geotag submesh rules (loadable .toml profiles)
  • WASM wallet and validator integration
  • SQLite → ScyllaDB migrate with dry-run & stats
Shipped

3D Mesh & Self-Healing

3D mesh validation, quarantine auto-recovery, reputation, CUDA acceleration.

  • NVIDIA-locked validators enforced end-to-end
  • Topology WebSocket + live 3D viewer
  • Reputation + reorg-safe partition heal
Shipped

After Phase 3: the in-repo arc continued with the Major Update — a rebrand to plain QSDM, the native coin Cell (CELL), a reference miner under MINING_PROTOCOL.md, and the attestation transparency surface with external CI and Prometheus enforcement.

v2 NVIDIA-locked protocol (landed): every accepted mining proof now carries an NVIDIA attestation (nvidia-cc-v1 or nvidia-hmac-v1), miners enroll on-chain with a 10 CELL stake bond (qsdm/enroll/v1), validators mint challenge nonces with a 60-second freshness window, and forged / replayed / stale proofs are slashable via qsdm/slash/v1. The reference miner client (pkg/mining/v2client) ships in-tree and is wired into qsdmminer-console. Two concrete slashers are active: the forged-attestation verifier (pkg/mining/slashing/forgedattest) re-runs the nvidia-hmac-v1 acceptance flow against the enrollment registry and drains the offender's bond on HMAC mismatch, GPU-UUID mismatch, challenge-bind mismatch, or deny-listed-GPU offences; the double-mining verifier (pkg/mining/slashing/doublemining) drains the bond of any operator caught signing two distinct, crypto-valid v2 proofs at the same (epoch, height) (the encoder canonicalises pair order so the chain-side replay protection treats (a, b) and (b, a) as the same offence). And any successful slash that leaves the offender's stake below the 10 CELL enrollment minimum now auto-revokes the record into the standard 7-day unbond window with the gpu_uuid binding released for re-enrollment — closing the "slash-to-zero, keep mining for free" loophole at the chain layer (pkg/chain/SlashApplier.AutoRevokeMinStakeDust). Slashing and enrollment are now fully observable: every applied, rejected, auto-revoked, and swept transition emits both a Prometheus counter (qsdm_slash_applied_total, qsdm_slash_rejected_total{reason}, qsdm_slash_auto_revoked_total{reason}, qsdm_enrollment_*) and a structured MiningSlashEvent / EnrollmentEvent on the chain.ChainEventPublisher bus, with point-in-time gauges (qsdm_enrollment_active_count, qsdm_enrollment_bonded_dust, qsdm_enrollment_pending_unbond_count) backed by an EnrollmentStateProvider that walks the on-chain registry under one mutex acquisition per scrape. The seam between pkg/chain and pkg/monitoring is dependency-inverted (chain.MetricsRecorder), so binaries that omit monitoring pay zero overhead and the historical import cycle that kept slashing under-instrumented is closed. All of this is now actually wired into the production binary: cmd/qsdm/main.go calls internal/v2wiring.Wire(...) at boot, which constructs the on-chain enrollment state, the EnrollmentApplier, the production slash dispatcher + SlashApplier, the stacked mempool admission gate (slashing.AdmissionChecker > enrollment.AdmissionChecker > operator’s POL/BFT base predicate), the full HTTP mining surface (POST /api/v1/mining/{enroll,unenroll,slash} for writes, GET /api/v1/mining/enrollment/{node_id}, GET /api/v1/mining/enrollments (paginated — cursor/limit/phase, cursor-stable under concurrent enrollment churn so dashboards never silently skip or double-count records), and GET /api/v1/mining/slash/{tx_id} for reads — the per-record query carries phase + slashable derived so slash submitters can confirm a target carries real stake before posting evidence; the list endpoint reuses the exact same EnrollmentRecordView shape so clients only learn one record format; the slash-receipt endpoint is backed by a bounded in-memory SlashReceiptStore that subscribes to the SlashApplier.Publisher chain via composition, so every applied or rejected slash leaves an auditable receipt without operators having to scrape logs or Prometheus to back-correlate heighttx_id), and the four qsdm_enrollment_* Prometheus gauges in one ordered call — backed by an integration suite that mirrors the production wiring shape (write → applier → publisher → receipt store → HTTP read) and catches any drift between main.go and the chain contracts before a regression reaches mainnet. The lifecycle operations are also exposed through qsdmcli: qsdmcli enroll, unenroll, slash, enrollment-status, enrollments (with --phase, --limit, --cursor, and --all for full-walk dumps that follow next_cursor until has_more is false), and slash-receipt build canonical payloads through the same pkg/mining/{enrollment,slashing} codecs the mempool admission gate validates against — one source of truth, no parallel hand-rolled JSON. qsdmcli slash-helper closes the last "users would have to write Go to do this" gap with three offline subcommands (forged-attestation, double-mining, inspect) that emit the canonical EvidenceBlob bytes the chain-side forgedattest / doublemining decoders consume, run pre-flight checks (proof version, NodeID binding, equal (Epoch, Height), distinct canonical bytes) so a watcher-bot doesn't burn a tx fee on a guaranteed verifier_failed, and canonicalise (proof_a, proof_b) ordering so two slashers observing the same equivocation produce byte-identical evidence. --print-cmd emits a copy-pasteable qsdmcli slash … snippet to stderr (never stdout, so the bytes pipe stays clean). CLI tests cover envelope shape, base64 round-trip, missing-flag rejection, hex-decode failure surfacing, HTTP path escaping, multi-page --all walks, and 4xx propagation across all six subcommands, plus 21 dedicated cases for slash-helper's happy paths, every pre-flight rejection, encoder round-trip, and stdout/stderr stream-safety guarantees. Pre-this commit, every collaborator above was code without a caller in any production binary; grep NewEnrollmentApplier cmd/qsdm/main.go returned zero matches. The Tier-3 milestone is meaningful now because the surface is alive in the binary, not just under go test. Remaining deferred scope (Tensor-Core PoW kernel, swap-in real nvtrust bundle framing for the now-shipped CC verifier, the freshness-cheat slasher pending BFT-finality, and the qsdm/gov/v1 runtime tuning hook) is tracked in MINING_PROTOCOL_V2.md §12.

Remaining mainnet gates are wall-clock events owned outside the repo (counsel, independent auditor, incentivized testnet launch) and are tracked in NEXT_STEPS.md.

ARCHITECTURE

How the pieces fit.

A single QSDM node speaks libp2p to its peers, terminates TLS at Caddy, exposes a REST API and a Prometheus endpoint for operators, and optionally ingests NGC proof bundles from an NVIDIA sidecar.

Browser / SDKs Go · JS · WASM clients Caddy · TLS edge qsdm.tech / api / dashboard QSDM binary · API /api/v1/auth, /wallet, /health JWT · mTLS admin · audit log :8443 (HTTP behind Caddy) Operator Dashboard WebSocket topology · Prometheus Login → /api/v1/auth proxy :8081 Proof-of-Entanglement CPU-only · no proof-of-work Mempool · BFT · Finality gadget Storage SQLite + Zstd → ScyllaDB (opt) Row-level compression, MVs libp2p · :4001 GossipSub · PEX Tx · Blocks · Evidence NVIDIA NGC sidecar CUDA fingerprint · signed proof bundle POST /api/v1/monitoring/ngc-proof · HMAC-signed P2P gate Drop tx from peers w/o recent valid GPU proof

Ready to explore?

Log in to the operator dashboard, hit the public API, or read the source.