- 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>
1.4 KiB
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