39 lines
2.5 KiB
Markdown
39 lines
2.5 KiB
Markdown
# 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](ADR-17-commissione-pagamento-esce-dalla-quota-vincitore.md));
|
||
|
|
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](ADR-21-tre-limiti-distinti-sul-numero-monete.md)) non si consuma più nel tempo ([LIM-17]).
|
||
|
|
Regole in [ciclo-di-vita-del-round.md](../ciclo-di-vita-del-round.md#4--pagamento)
|
||
|
|
e [scommesse-e-prelievi.md](../scommesse-e-prelievi.md#prelievo) (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.
|