Files
plm-lottery/docs/adr/ADR-26-validazione-degli-header-concatenata-senza-ricalcolo.md
T
davideandClaude Sonnet 5.5 b424f670c5 Restructure docs: docs-first, SSOT, one ADR per decision
- Add docs/README.md as the index of all documentation.
- Split the 52 DEC entries of decisioni-e-limiti.md into docs/adr/ADR-NN
  files (same numbers), add ADR-53 (audit log), TEMPLATE.md and an ADR index
  with a feature -> ADR table.
- Rename decisioni-e-limiti.md to limiti-noti.md (LIM only) and rewrite all
  DEC-nn references as links to the ADRs.
- Document the docs-first / SSOT / ADR rules in processo-di-modifica.md and
  map the docs in CLAUDE.md and README.md.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-14 12:05:57 +02:00

2.8 KiB

ADR-26 — Validazione degli header concatenata, senza ricalcolo della difficoltà

  • Stato: Accettata — implementazione da completare (B-74, B-85)
  • Area: Round ed estrazione
  • Fonte di verità per: la scelta di progetto descritta qui sotto; i requisiti (PREFISSO-NN) che la attuano stanno nei documenti di dominio, indicati nelle Conseguenze.

Decisione

Validazione degli header concatenata, senza ricalcolo della difficoltà. Un header deve dichiarare un bersaglio non più facile del limite di rete (powLimit, 0x00000000ffff…), rispettare quel bersaglio e concatenarsi alla catena che teniamo: su un avanzamento di più blocchi si scaricano gli header intermedi e si verifica tutta la catena. Il listener tiene gli ultimi 10 header; un header che non si concatena alla punta ma a uno di essi è una riorganizzazione da seguire (ADR-52), non un server ostile. Un header senza hex è ignorato senza chiudere la sessione. Regole in connessione-electrum.md (B-74, B-85).

  • Motivazione: il controllo «rispetta il bersaglio che dichiara», da solo, non è una difesa: il bersaglio lo sceglie chi produce l'header, e con bits=0x207fffff un header passa senza lavoro. Un salto di più blocchi non collegato alla punta permetteva di fissare un'altezza enorme, che non regredisce mai, e congelare ogni estrazione (B-74). Trattare ogni riorganizzazione di un blocco come un server ostile chiudeva la sessione su tutti i server fino al blocco successivo.
  • Alternative scartate: validazione completa della catena con le regole di ricalcolo della difficoltà di PLM (fuori scopo: servirebbe la storia delle difficoltà, e il commit-reveal di ADR-24 toglie a un header fabbricato il potere di scegliere il vincitore).
  • Conseguenze: un header a difficoltà minima costa ancora poco lavoro ([LIM-14]); a fermare una catena fabbricata sono la concatenazione, il quorum (ADR-07) e il fatto che il seme dipende anche da server_seed.

Codice: app/electrum/listener.py:ElectrumListener._apply_header · app/rounds/draw.py:header_meets_its_own_target · Test: tests/unit/test_electrum_listener.py::test_apply_header_rejects_one_that_does_not_chain_from_the_tip, tests/unit/test_electrum_listener.py::test_apply_header_ignores_a_competing_header_at_the_current_tip_height Stato: da implementare (B-74, B-85) · Oggi: nessun confronto con powLimit, concatenazione verificata solo sull'avanzamento di un blocco esatto, un header concorrente alla stessa altezza ignorato, un header che non si concatena chiude la sessione.