- 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>
2.5 KiB
ADR-03 — Ogni round ha il proprio indirizzo del montepremi
- Stato: Accettata — implementazione da completare (B-80)
- Area: Custodia, chiavi e indirizzi
- 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
Ogni round ha il proprio indirizzo del montepremi
(decisione del 2026-09-28), derivato dalla stessa master key sul ramo
m/84'/746'/0'/2/<round_id> e salvato sulla riga del round
(rounds.pool_address). Le scommesse di un round pagano solo il suo
indirizzo e il pagamento spende solo le monete di quell'indirizzo. Il vecchio
indirizzo unico m/84'/746'/0'/1/0 diventa l'indirizzo di riserva del
montepremi, che riceve la riserva per l'RBF di ogni pagamento (ADR-17);
i round aperti prima della modifica mantengono quell'indirizzo come
montepremi. Un prelievo verso un indirizzo del montepremi, di riserva o delle
commissioni è rifiutato. Il ramo 0 resta riservato agli utenti.
- Motivazione: con un indirizzo unico la cronologia cresce senza limite (e con essa le risposte del server, B-75), il denaro di round diversi e le monete estranee si mescolano, e un backup ripristinato ripete un round contro ciò che il montepremi contiene oggi (B-90). Separare gli indirizzi isola denaro, cronologia e pagamento di ogni round.
- Alternative scartate: un indirizzo unico con contabilità per round nel database (non limita la cronologia e non isola le monete estranee); consolidamento periodico dell'indirizzo unico (sposta il problema, non lo toglie).
- Conseguenze: nessun segreto aggiuntivo (tutto deriva dalla master key); una moneta estranea inviata all'indirizzo di un round chiuso resta lì, visibile ma fuori da ogni pagamento; il margine fra partecipanti e ingressi del pagamento (ADR-21) non si consuma più nel tempo ([LIM-17]). Regole in ciclo-di-vita-del-round.md e scommesse-e-prelievi.md (B-80).
Codice: app/wallet/hd.py:derive_pool_key · app/wallet/hd.py:derive_pool_address · app/rounds/service.py:open_new_round_if_needed ·
Test: tests/unit/test_pending_address.py
Stato: da implementare (B-80) · Oggi: un unico indirizzo del montepremi
(1/0) riceve le scommesse di tutti i round e il pagamento sceglie fra
tutte le sue monete.