B4: chain tables, HD index assignment and signing key reserved to the worker (DAT-81..84, ARC-78)
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
0092596b07
commit
f1d09075a1
18 files changed
+741
-8
No files matched your search
+28
-1
@@ -1493,7 +1493,7 @@ scrive la stringa vuota).
|
||||
Lo schema del sito Django (`apps/lottery/models.py`, `apps/accounts/models.py`) sostituisce quello
|
||||
SQLAlchemy descritto sopra (roadmap A2–D1); fino ad allora il resto del documento è lo stato storico.
|
||||
Le regole che devono valere comunque sono **vincoli del database**, non convenzioni ([ARC-72]).
|
||||
Le tabelle di catena (UTXO, versioni delle transazioni, depositi, indici HD) arrivano con la Fase B (B4).
|
||||
Le tabelle di catena (UTXO, versioni delle transazioni, depositi, indici HD) sono la Fase B (B4: [DAT-81]…[DAT-84]).
|
||||
|
||||
- **[DAT-76]** **Il denaro non si cancella.** Ogni chiave esterna delle tabelle `lottery_*` verso utenti, round,
|
||||
partecipazioni e transazioni è `PROTECT`: un utente, un round o una transazione con righe collegate non
|
||||
@@ -1531,3 +1531,30 @@ Le tabelle di catena (UTXO, versioni delle transazioni, depositi, indici HD) arr
|
||||
accanto alle righe, quindi non può divergere da esse.
|
||||
*Stato:* implementato (A3) · *Codice:* `apps/lottery/balances.py:balance_of` ·
|
||||
*Test:* `tests/django/test_ledger.py::test_a_pending_deposit_is_incoming_not_spendable`, `test_a_whole_round_conserves_the_money`
|
||||
- **[DAT-81]** **Indirizzo di deposito e indice HD.** Ogni giocatore ha **un solo** indirizzo di deposito
|
||||
(`DepositAddress`): l'indice di derivazione (`0/<indice>` sotto l'account del profilo di rete, [ADR-58](adr/ADR-58-alfa-su-regtest-profilo-di-rete-configurabile.md))
|
||||
è **unico** e l'indirizzo è unico; l'indice è il successivo al massimo assegnato e due assegnazioni
|
||||
concorrenti non possono avere lo stesso, perché è il vincolo del database a deciderlo (chi perde riprova).
|
||||
L'assegnazione è idempotente: lo stesso utente riceve sempre lo stesso indirizzo, e a parità di chiave e indice
|
||||
l'indirizzo è sempre lo stesso. Si deriva dalla sola chiave **pubblica** dell'account ([ARC-78]).
|
||||
*Stato:* implementato (B4) · *Codice:* `apps/lottery/models.py:DepositAddress`, `apps/lottery/chain.py:assign_deposit_address` ·
|
||||
*Test:* `tests/django/test_chain_models.py::test_a_player_gets_one_address_and_always_the_same`, `test_derivation_is_identical_for_the_same_input`, `test_two_players_never_share_an_index`
|
||||
- **[DAT-82]** **UTXO.** `Utxo` è un output che la piattaforma controlla: `(txid, vout)` unico, importo positivo, indirizzo,
|
||||
a chi appartiene (un giocatore, per un deposito, oppure un round, per il suo montepremi; mai entrambi),
|
||||
altezza di conferma (vuota finché non è confermato), `spent_txid` (vuoto finché non è speso) e la prenotazione
|
||||
`reserved_by` verso la transazione della piattaforma che lo sta spendendo ([ARC-72], B6). Un `txid` ha sempre 64 caratteri.
|
||||
*Stato:* implementato (B4); la prenotazione atomica è B6 · *Codice:* `apps/lottery/models.py:Utxo` ·
|
||||
*Test:* `tests/django/test_chain_models.py::test_an_outpoint_is_stored_once`, `test_a_utxo_belongs_to_a_player_or_a_round_never_both`, `test_amounts_and_txids_are_checked_by_the_database`
|
||||
- **[DAT-83]** **Tutte le versioni di una transazione** ([TX-19]). `TransactionVersion` registra ogni txid che una
|
||||
`ChainTransaction` ha avuto (la prima, ogni sostituzione RBF, ogni candidata scritta prima del bump) con la
|
||||
transazione grezza; il `txid` è **unico in tutta la tabella** (appartiene a una sola transazione) e le righe sono
|
||||
**in sola aggiunta** (il modello e il database rifiutano modifiche e cancellazioni). `register_version` è
|
||||
idempotente e aggiorna `current_txid` nella stessa transazione del database.
|
||||
*Stato:* implementato (B4) · *Codice:* `apps/lottery/models.py:TransactionVersion`, `apps/lottery/chain.py:register_version` ·
|
||||
*Test:* `tests/django/test_chain_models.py::test_every_version_of_a_transaction_is_kept`, `test_a_txid_belongs_to_one_transaction`, `test_versions_cannot_be_changed_or_deleted`
|
||||
- **[DAT-84]** **Depositi.** `Deposit` lega un `Utxo` a un giocatore: stati `detected` (visto sulla catena),
|
||||
`credited` (accreditato con un `Movement` di tipo `deposit`) e `orphaned` (sparito per una riorganizzazione).
|
||||
Un output è un solo deposito e un `credited` ha sempre il movimento e la data di accredito.
|
||||
*Stato:* tabella implementata (B4); il listener e l'accredito sono B5 · *Codice:* `apps/lottery/models.py:Deposit` ·
|
||||
*Test:* `tests/django/test_chain_models.py::test_a_credited_deposit_has_its_movement_and_date`, `test_an_output_is_one_deposit`
|
||||
|
||||
Reference in new issue
Block a user