Documents
The repository is the documentation. This page is the index.
Every claim and every figure on this site comes from one of these files. Each link goes
to the file on GitHub, on the main branch. Read them in this order and
each one stands on the one before it.
What each file answers
-
README.md
What Qnero is, what runs today, the Monero mapping, the numbers, the five-project comparison, the build and run commands, the status and the caveats. Start here.
-
docs/DESIGN.md
The design draft, v0.1. The four priorities, the Monero-to-Qnero replacement table, the primitives, the runtime layout, the milestone log and the open questions.
-
docs/CIRCUIT.md
The circuit specification: the leaf's fragments and public-input layout, the two aggregation layers, settlement, and section 10.7, which lists everything a v1 block publishes.
-
docs/BENCH.md
The measurement log. Every gate count, proof size, proving time, memory figure and mining run on this site is in here with the command that produced it.
-
docs/WALLET.md
The wallet reference: scanning rules, how a leaf's kind is decided, and what a lying node can and cannot do.
-
chain/MINING.md
Mining: the miner key, the node's own miner, the stratum flags and what the endpoint bounds, seed rotation and difficulty.
-
docs/OPS-DEV.md
Build preconditions and the end-to-end devnet transcripts, including the known limits of an unauthenticated stratum endpoint.
Qloak, silQ Road and the chain
-
wallet-web/README.md
Qloak: the build, the runtime JSON that points it at a chain, what a host has to send, what it does, and the threat model in full.
-
explorer/README.md
silQ Road: the routes, the configuration, the deploy shape, the eight refusals and the two decoder seams.
-
chain/README.md
The forked chain: its own workspace, its build, and how to run a node.
-
LICENSE
MIT. Qnero is MIT licensed, and the upstream notices are kept where the licence requires them.
-
The repository
All of it. Clone it, build it, run a devnet, and check every figure on this site against your own machine.
Start with the design, finish with a devnet
Read docs/DESIGN.md first, then docs/CIRCUIT.md for the constraints and section 10.7 for the disclosure list. Then clone the repository and start a chain of your own: every instruction on this site is a local devnet instruction, and every figure is one you can take again.
Disagreements belong in the repository. What is audited, what is not, and what is still open is written out on the about page.