Complete the target spec for the 2026-09-28 review (B-73..B-98)

Finishes what 88221b0 started: sicurezza.md, audit-log.md and storico-bug.md
now describe the target behaviour too, the operator guides are corrected
against today's code, and api.md gains the missing /health/ready and
/admin/electrum sections plus every new error code in its catalog.

Harmonised names and owners across documents (the `resurrected_tx` pause
reason, the reconciler as the one that watches failed rows, the full
`winner_drawn` payload, a reason for an unanswered pre-payout pool check,
one corroboration-failure row per hash instead of one per tick).

Adds B-98 (coin selection stops at the first covering UTXO and refuses a
payable bet), tightens RND-40 to check both 1 and 400 participants and to
guard PUT /admin/config, and gives a stalled `closing` round a signal
(TX-29, closing_stalled).

Records three decisions confirmed on 2026-09-29: the draw's server_seed is
stored Fernet-encrypted until revealed (SEC-56, DAT-64), the chosen abuse
and key-check thresholds (SEC-49, SEC-54, SEC-55), and a broadcast
rejection is verified against every server before any coin is released,
so matching "already known" text is a shortcut, not a safety condition
(TX-04).

Spec only; no code changed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Opus 5.5 committed 2026-09-29 09:17:52 +02:00
1 parent 88221b0dbd
commit 4be58709d1
16 files changed
+1377 -323

No files matched your search

+34
View File
@@ -44,6 +44,39 @@ chiunque usi PLM, non solo la lotteria. Queste misure fanno sì che non
convenga e che non blocchi la lotteria; non lo rendono impossibile. Vedi
[decisioni-e-limiti.md](decisioni-e-limiti.md).
### Decisioni confermate il 2026-09-29
Scelte di dettaglio emerse scrivendo la specifica, confermate prima di
iniziare l'implementazione:
1. **Il segreto dell'estrazione è cifrato a riposo.** Fino alla rivelazione
il database contiene `server_seed` solo cifrato con la chiave della master
xprv, così una copia del database o un backup non bastano a prevedere il
vincitore di un round aperto. All'avvio il server verifica di poterlo
decifrare.
→ [sicurezza.md](sicurezza.md#sec-56) SEC-56,
[modello-dati.md](modello-dati.md) DAT-64, B-73
2. **Soglie di protezione:**
- cambio password: dal 5° tentativo sbagliato attese che raddoppiano da 2
a 300 secondi, azzerate dopo 900 secondi senza errori o a un cambio
riuscito ([sicurezza.md](sicurezza.md) SEC-54);
- segnalazioni di bug: al massimo 10 all'ora per IP
([sicurezza.md](sicurezza.md) SEC-55);
- verifica della chiave all'avvio: indirizzo di riserva, i 10 utenti con
indice più basso e i 10 con indice più alto, gli ultimi 10 round con
indirizzo proprio, e il segreto di ogni round non ancora rivelato
([sicurezza.md](sicurezza.md#sec-49) SEC-49).
→ B-89, B-94
3. **Un rifiuto dell'invio si verifica prima di liberare le monete.** Il
testo degli errori Electrum non distingue in modo affidabile un rifiuto da
un "già in mempool", e il protocollo non ha un codice standard. Dopo ogni
rifiuto si chiede la transazione a tutti i server: basta che uno la conosca
perché l'invio valga come accettato, e si annulla solo se nessuno la
conosce. Il riconoscimento del testo resta una scorciatoia, non una
condizione di sicurezza.
→ [transazioni-e-riconciliazione.md](transazioni-e-riconciliazione.md#invio-rifiutato)
TX-04, B-76
## Ordine di implementazione
Le fasi vanno eseguite in ordine: ognuna si appoggia sulle precedenti.
@@ -106,6 +139,7 @@ test di regressione, secondo [processo-di-modifica.md](processo-di-modifica.md).
|---|---|---|
| B-94 | Limiti su cambio password, login, bug report; errori strutturati | media |
| B-96 | Incoerenze minori (sette voci, un test ciascuna) | media |
| B-98 | Selezione delle monete che garantisce il resto quando il saldo lo permette | media |
### Fase 7 — Prova su rete reale