igneum/docs/spec
igneum-labs 0ff59033ff Spec: close F2, F3, P5, P8, C9, E7, G7, X6 by rule or decision (3 October 2026)
- 03-finality: Q2 participation from every vote seen in blocks (votes are
  block payload); 3.3.2 the eclipse case closed by the 56.7% floor with the
  sim v2 F2 numbers; 3.4.1 why aggregators cannot grind participation.
- 07-execution (new): EVM semantics on the DAG, shard sortition (8 provers,
  10 s, then open, no shard bond), bridges (none official, no bridged
  stablecoins at genesis, proof bridge with the consensus proof in phase two).
- 08-client-security (new): reproducible builds, release key in genesis and
  in hardware, no silent updates, consensus only by 90% signalling, notarised
  builds, official sources with the hash, seed confirmed before mining,
  hardware wallet, the permanent seed line.
- 00, 02, 05, README, 06: cross-references, O-2.8 removed, O-3.3, O-3.7,
  O-5.1, O-5.2, O-5.6 narrowed, O-8.1 added, counts kept at 60.
- Ledger: eight Status lines, status table, count table, overclaims 38, 40, 71.
- FUD fixes: rows 23, 26, 38, 62, 64, 66, 67, 70, 72, section 3 and 4.
- Site: bridge and stablecoin sentences no longer launch features; the seed
  line wherever the app appears.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-10-03 18:58:39 +00:00
..
00-overview.md Spec: close F2, F3, P5, P8, C9, E7, G7, X6 by rule or decision (3 October 2026) 2026-10-03 18:58:39 +00:00
01-lottery-hash.md Spec 0.1: lottery hash, consensus delta, finality v2 with the quorum floor, seeds and VDF, fees, open items 2026-10-03 17:45:08 +00:00
02-consensus.md Spec: close F2, F3, P5, P8, C9, E7, G7, X6 by rule or decision (3 October 2026) 2026-10-03 18:58:39 +00:00
03-finality.md Spec: close F2, F3, P5, P8, C9, E7, G7, X6 by rule or decision (3 October 2026) 2026-10-03 18:58:39 +00:00
04-seeds-and-vdf.md Spec 0.1: lottery hash, consensus delta, finality v2 with the quorum floor, seeds and VDF, fees, open items 2026-10-03 17:45:08 +00:00
05-fees-and-economics.md Spec: close F2, F3, P5, P8, C9, E7, G7, X6 by rule or decision (3 October 2026) 2026-10-03 18:58:39 +00:00
06-open-items.md Spec: close F2, F3, P5, P8, C9, E7, G7, X6 by rule or decision (3 October 2026) 2026-10-03 18:58:39 +00:00
07-execution.md Spec: close F2, F3, P5, P8, C9, E7, G7, X6 by rule or decision (3 October 2026) 2026-10-03 18:58:39 +00:00
08-client-security.md Spec: close F2, F3, P5, P8, C9, E7, G7, X6 by rule or decision (3 October 2026) 2026-10-03 18:58:39 +00:00
README.md Spec: close F2, F3, P5, P8, C9, E7, G7, X6 by rule or decision (3 October 2026) 2026-10-03 18:58:39 +00:00

Igneum protocol specification, version 0.1

3 October 2026. Written so that a stranger can reimplement a node, a miner and a verifier and reach the same bits. Conventions, number labels (Measured, Implemented, Designed, Target) and the break-submission route are in section 0.

Section File Status One line
0 00-overview.md Designed Scope, normative language, what is implemented and what is designed, versioning, how to submit a break
1 01-lottery-hash.md Measured (construction, vectors on three GPU vendors and two CPU references); Designed (header binding, day key, growth, era schedule); Open where marked Seed words, generator, memory-hard cache and items, 32-lane unit and the wave64 rule, CPU verifier, epoch, day and era schedules, test vectors, determinism, conformance, the prototype-value list
2 02-consensus.md Designed The ordering layer as a delta on rusty-kaspa: 1 BPS and the steps, k, merge depth, DAA, header fields, emission, duplicate inclusion
3 03-finality.md Designed (simulated without a DAG, not implemented, not reviewed) Weight W1 to W5, checkpoints C1 to C5, quorum Q1 to Q4 with the 56.7% floor and the simulation that justifies it, the eclipse case closed by the floor (3.3.2), participation from votes in blocks (Q2, 3.4.1), sortition, fork choice, equivocation, residual risks, the first month, exchange guidance
4 04-seeds-and-vdf.md Measured (primitive, one machine); Designed (pipeline); Open (fallback) Class-group Wesolowski VDF, T from a genesis reference rate, 20-minute and 2-hour leads, proof format, who evaluates, fallback options
5 05-fees-and-economics.md Designed Base fee burned, priority fee 80/20 with per-frame attribution and the factory rule, proving pool, job market 90/10, no development fund, parameter signalling at 60%, upgrades at 90%, no stake, no treasury
6 06-open-items.md Open 60 items, each with the experiment or decision that closes it and its gate; O-2.8 closed and O-3.3, O-3.7, O-5.1, O-5.2 and O-5.6 narrowed on 3 October 2026
7 07-execution.md Designed (normative extract of docs/design/execution-layer.md; nothing implemented or measured) EVM semantics on the DAG (number, timestamp and its monotonicity rule, blockhash, PREVRANDAO from the epoch VDF, coinbase, gas limit, chain id, the quoted gas price), shard assignment by sortition (8 provers, 10-s window, then open, no bond), bridges (none official, no bridged stablecoins at genesis, proof bridge with the consensus proof in phase two)
8 08-client-security.md Decided (3 October 2026; nothing implemented) Reproducible builds with hashes in the repository, the release key published in genesis and held in hardware, the client refuses unsigned updates and never updates silently, the client cannot change consensus (90% signalling), notarised builds, official download sources with the hash beside the button, seed shown and confirmed before mining, hardware wallet option, the permanent line "Nobody from Igneum will ever ask for your seed."

Prototype values (carried by the implementation today, part of the test vectors, confirmed or replaced at gate 1): seed derivation; 64 instructions x 8 iterations; 8 registers; the op weights including the 25% load weight; the output fold rotations; the 256 MiB cache, 64 lines per segment and ChaCha12; 8 item rounds and the mixer shape; the 1 GiB pack dataset against the 2 GiB genesis size; the 3,600 DAA s epoch; the era length, draw bounds and reserve list; the header binding of the init words. The full table with what fixes each is section 1.16.

Normative code: igneum-pow/. Measurements: docs/bench-log.md. Criticisms and their status: docs/fud-ledger.md. Simulations: sim/. Prototypes: proto-metal/, proto-cuda/, proto-opencl/, proto-vdf/.