Files
plm-lottery/docs/adr/ADR-03-ogni-round-ha-proprio-indirizzo-montepremi.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.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.