Files
plm-lottery/docs/adr/ADR-02-indirizzo-utente-permanente-tutti-usi.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

1.4 KiB

ADR-02 — Un indirizzo per utente, permanente, per tutti gli usi

  • Stato: Accettata
  • 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

Un indirizzo per utente, permanente, per tutti gli usi. Alla registrazione il server deriva un indirizzo P2WPKH BIP84 (m/84'/746'/0'/0/<indice>, un indice per utente, assegnato come massimo esistente + 1). Lo stesso indirizzo è indirizzo di deposito, riceve le vincite e riceve il resto di ogni scommessa e prelievo. Non esiste un «indirizzo vincitore» separato.

  • Motivazione: un solo indirizzo da osservare per utente, un solo saldo da ricostruire (utxo_events), e le vincite accreditate dal normale percorso dei depositi senza logica dedicata.
  • Conseguenze: nessuna privacy fra depositi, vincite e resti; un prelievo verso il proprio indirizzo è rifiutato (renderebbe indistinguibili destinatario e resto); il pagamento di un round si considera accreditato quando il listener vede la moneta sull'indirizzo del vincitore (vedi registrazione-e-depositi.md).

Codice: app/auth/routes.py:register · app/wallet/hd.py:derive_user_address · app/rounds/confirmation.py:_on_payout_confirmed · Test: tests/unit/test_hd.py, tests/unit/test_users.py