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>
This commit is contained in:
1 parent
7ba8e22bb4
commit
b424f670c5
76 files changed
+2147
-1530
No files matched your search
@@ -0,0 +1,49 @@
|
||||
# ADR-52 — Le riorganizzazioni della catena si contengono invece di ignorarle
|
||||
|
||||
- **Stato:** Accettata — implementazione da completare (B-82, B-85)
|
||||
- **Area:** Conferme e fiducia nella rete
|
||||
- **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
|
||||
|
||||
**Le riorganizzazioni della catena si contengono invece di
|
||||
ignorarle** (decisione del 2026-09-28). Tre misure:
|
||||
- *si rilevano*: il listener tiene gli ultimi 10 header e segue una
|
||||
biforcazione fino al punto comune; ogni riorganizzazione scrive
|
||||
`chain_reorg_detected` con profondità e altezze. Una biforcazione che non
|
||||
trova il punto comune entro 10 header è trattata come un header non
|
||||
valido (fine della sessione e rotazione, [ADR-26](ADR-26-validazione-degli-header-concatenata-senza-ricalcolo.md));
|
||||
- *si fermano quelle profonde*: una profondità ≥ 2 mette in pausa la
|
||||
lotteria (`paused_reason = 'reorg'`, [ADR-28](ADR-28-pausa-manutenzione-ferma-round-successivo.md)) finché l'operatore non la
|
||||
riprende;
|
||||
- *si paga solo ciò che è in catena*: prima di costruire un pagamento le
|
||||
monete dell'indirizzo del round si verificano con il quorum; i
|
||||
partecipanti la cui scommessa non c'è più diventano `reorged_out` e la
|
||||
ripartizione 70/30 si calcola su ciò che resta. Se manca la scommessa del
|
||||
vincitore, il pagamento è trattenuto (`payout_blocked`) e la lotteria va in
|
||||
pausa.
|
||||
|
||||
Regole in [connessione-electrum.md](../connessione-electrum.md#4-header-validati-non-creduti)
|
||||
e [ciclo-di-vita-del-round.md](../ciclo-di-vita-del-round.md#4--pagamento)
|
||||
(B-82, B-85).
|
||||
- *Motivazione:* la regola precedente («1 conferma, nessun rollback»)
|
||||
presupponeva riorganizzazioni rare e innocue. Con la potenza di PLM in
|
||||
affitto una riorganizzazione è un attacco possibile, e senza queste misure
|
||||
una sola scommessa sparita rende il round impagabile per sempre (B-82),
|
||||
mentre una riorganizzazione di un blocco, normale in qualunque catena,
|
||||
veniva scambiata per un server ostile (B-74).
|
||||
- *Alternative scartate:* ignorare le riorganizzazioni (la regola
|
||||
precedente); un rollback completo (ricalcolare saldi già spesi e ripetere
|
||||
estrazioni già rivelate non è sempre possibile e sposterebbe denaro senza
|
||||
l'operatore); pausa anche per profondità 1 (una riorganizzazione di un
|
||||
blocco è frequente e non tocca i depositi a 6 conferme, [ADR-06](ADR-06-depositi-richiedono-deposit-confirmations-conferme-6.md)).
|
||||
- *Conseguenze:* un attacco al 51% resta possibile; queste misure lo
|
||||
rendono visibile, fanno sì che non blocchi la lotteria in modo
|
||||
irrecuperabile e limitano il danno a ciò che l'attaccante ha rimosso
|
||||
([LIM-24]).
|
||||
|
||||
*Codice:* `app/electrum/listener.py:ElectrumListener._apply_header` · `app/rounds/scheduler.py:RoundScheduler._trigger_payout` · `app/rounds/service.py:open_new_round_if_needed` ·
|
||||
*Test:* —
|
||||
*Stato:* da implementare (B-82, B-85) · *Oggi:* nessuna riorganizzazione è
|
||||
rilevata; un header concorrente è ignorato, uno che non si concatena chiude
|
||||
la sessione; il pagamento non verifica le monete del round.
|
||||
Reference in new issue
Block a user