HD derivation (pure part), PSBT builder, Electrum client/merkle/quorum/scripthash, network profile, addresses and header checks move to plm_engine; the old stack imports them from there. A test forbids framework imports in the package. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
59 lines
3.8 KiB
Markdown
59 lines
3.8 KiB
Markdown
# ADR-24 — L'estrazione è un commit-reveal fra il server e un blocco futuro
|
|
|
|
- **Stato:** Accettata
|
|
- **Area:** Round ed estrazione
|
|
- **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
|
|
|
|
**L'estrazione è un commit-reveal fra il server e un blocco
|
|
futuro** (decisione del 2026-09-28). All'apertura del round il server genera
|
|
un segreto casuale di 32 byte (`server_seed`), lo salva e pubblica solo la
|
|
sua impronta `server_seed_hash = sha256(server_seed)`. All'ingresso in
|
|
`drawing` si fissano l'elenco dei partecipanti confermati, ordinato per txid
|
|
della scommessa crescente, la sua impronta `participants_hash` (sha256 delle
|
|
righe `txid:vout:indirizzo`) e l'altezza del blocco di estrazione
|
|
(`draw_height`, [ADR-25](ADR-25-blocco-estrazione-fissato-altezza-successivo-chiusura.md)). Il seme è
|
|
`sha256(server_seed || block_hash || participants_hash)` letto come intero,
|
|
l'indice del vincitore è seme modulo numero di partecipanti. Dopo il
|
|
salvataggio del vincitore il server rivela `server_seed` e pubblica la prova
|
|
completa (`GET /rounds/{id}/proof`), da cui chiunque ricalcola l'esito.
|
|
L'algoritmo resta un **componente sostituibile**: il resto del sistema non
|
|
va architettato attorno alla sua forma, ma ogni sostituto deve mantenere le
|
|
stesse quattro proprietà — impegno pubblicato prima delle scommesse, elenco
|
|
dei partecipanti fissato prima del blocco, esito ricalcolabile dai dati
|
|
pubblicati, esito non calcolabile da chi produce o trasmette i blocchi.
|
|
- *Motivazione:* il vincitore non deve essere calcolabile da chi controlla
|
|
la produzione dei blocchi: la potenza di calcolo di PLM (~22 TH/s) si può
|
|
affittare. Un minatore che non conosce `server_seed` non sa chi vincerebbe
|
|
con il suo blocco e quindi non ha motivo di scartarlo; l'operatore non
|
|
può cambiare `server_seed` dopo averne pubblicato l'impronta e non conosce
|
|
il blocco quando si impegna. L'ordine per txid e l'impronta dell'elenco
|
|
rendono l'esito riproducibile e impediscono di aggiungere o togliere
|
|
partecipanti dopo aver visto il blocco (B-73).
|
|
- *Alternative scartate:*
|
|
- *hash del solo blocco* (la forma precedente): un minatore con biglietti
|
|
in gioco trattiene i blocchi finché uno lo fa vincere, e il server
|
|
Electrum attivo sceglie quale blocco reale usare semplicemente non
|
|
annunciandone uno;
|
|
- *hash di più blocchi consecutivi*: chi produce l'ultimo blocco della
|
|
serie può ancora scartarlo e riprovare, quindi resta manipolabile;
|
|
- *segreti forniti dai giocatori* (commit-reveal fra partecipanti): chi non
|
|
rivela blocca o condiziona l'estrazione, e servirebbe un'azione in più a
|
|
ogni giocatore;
|
|
- *sorgente di casualità esterna* (beacon): una dipendenza di rete in più,
|
|
di cui fidarsi quanto del server.
|
|
- *Conseguenze:* l'operatore, che conosce `server_seed`, può calcolare
|
|
l'esito appena il blocco è noto: una collusione fra operatore e minatore
|
|
resta possibile ed è accettata ([LIM-25]), perché l'operatore è già
|
|
fidato come custode ([LIM-26]). `server_seed` non è esposto da nessun
|
|
endpoint prima della rivelazione, e nel database è cifrato con la chiave
|
|
della master xprv finché non viene rivelato
|
|
([sicurezza.md](../sicurezza.md#sec-56) SEC-56): una copia del database da
|
|
sola non basta a conoscerlo. Regole in
|
|
[ciclo-di-vita-del-round.md](../ciclo-di-vita-del-round.md#3--estrazione),
|
|
endpoint in [api.md](../api.md) (B-73).
|
|
|
|
*Codice:* `plm_engine/draw.py:draw_winner` · `app/rounds/scheduler.py:RoundScheduler._close_and_draw` · `app/rounds/scheduler.py:RoundScheduler._complete_draw` · `app/rounds/service.py:open_new_round_if_needed` · `app/api/routes/rounds.py:round_proof` ·
|
|
*Test:* `tests/unit/test_draw.py`, `tests/unit/test_draw_proof.py`
|