B5: real deposits on the ORM, Electrum scan with quorum and merkle proof, configurable threshold (DEP-20..23, ELC-31)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Sonnet 5.5 committed 2026-11-16 16:09:36 +01:00
1 parent f1d09075a1
commit 2acd4ccd1c
21 files changed
+1223 -49

No files matched your search

+32
View File
@@ -393,3 +393,35 @@ corso (`has_pending`).
la scommessa [scommesse-e-prelievi.md](scommesse-e-prelievi.md), B-96).
*Codice:* `app/withdrawals/service.py:request_withdrawal`, `app/bets/service.py:place_bet` ·
*Test:* `tests/unit/test_withdrawals.py`
## Depositi sul sito Django (B5)
Il sito Django riscrive i depositi sull'ORM con lo stesso comportamento di [DEP-01]…[DEP-08] dove non diversamente detto.
Le parti dopo l'accredito (monete spese altrove, reintegro, riorganizzazioni oltre la soglia: [DEP-06]…[DEP-08]) sono B7.
- **[DEP-20]** **Tre fasi, il database mai aperto durante la rete.** Un giro del worker (`scan_deposits`) **legge** dal database
indirizzi di deposito, monete note, txid della piattaforma e soglie; **interroga** i server Electrum senza alcuna
transazione aperta; **scrive** solo i casi verificati, ricontrollando lo stato di ogni moneta al salvataggio. Un
server che non risponde non produce scritture: l'indirizzo si riprova al giro dopo. Il giro gira solo con `LEDGER_BACKEND=chain`.
*Stato:* implementato (B5) · *Codice:* `apps/lottery/deposits.py:scan_deposits`, `apps/lottery/electrum_chain.py:ElectrumChain.observe` ·
*Test:* `tests/django/test_deposits.py`, `tests/integration/test_deposits_regtest.py`
- **[DEP-21]** **Soglie.** Una moneta sotto `DUST_LIMIT_SATS` (294) o ancora in mempool (altezza 0) è ignorata. Le conferme sono
`punta − altezza + 1`. La soglia è **1** per una transazione della piattaforma (uno qualunque dei suoi txid,
[DAT-83]), **120** per una coinbase (stabilita dalla transazione grezza, accettata solo se il suo hash è il txid),
altrimenti **`deposit_confirmations`** di `LotteryConfig` ([DAT-77]), letta a ogni giro.
*Stato:* implementato (B5) · *Codice:* `apps/lottery/deposits.py:threshold_for`, `apps/lottery/electrum_chain.py:ElectrumChain.is_coinbase` ·
*Test:* `tests/django/test_deposits.py::test_a_deposit_is_credited_exactly_at_its_threshold`, `test_the_threshold_is_the_configured_one`, `test_a_coinbase_needs_120`, `test_our_own_transactions_need_one`, `test_dust_and_mempool_coins_are_ignored`
- **[DEP-22]** **Accredito verificato e idempotente.** Una moneta sopra la soglia è accreditata solo se la corroborano gli altri
server ([ELC-14], [ELC-17]) **e** una prova merkle verificata contro un header che ha lavoro valido per il profilo di rete
la colloca nel blocco indicato ([ELC-26]). L'accredito è un solo `Movement` di tipo `deposit` che passa da `pending` a
`confirmed`, il `Deposit` passa a `credited` e l'audit scrive `deposit_credited`, nella stessa transazione. Una moneta già
accreditata non si accredita mai due volte (unicità dell'outpoint, [DAT-82]). Se la verifica non riesce, l'accredito è
rimandato al giro dopo, non perso.
*Stato:* implementato (B5) · *Codice:* `apps/lottery/deposits.py:apply_observations` ·
*Test:* `tests/django/test_deposits.py::test_an_unverified_deposit_is_deferred_not_lost`, `test_scanning_twice_credits_once`, `test_the_credit_is_audited`
- **[DEP-23]** **Depositi in attesa e sparizione prima dell'accredito.** Una moneta confermata ma sotto soglia è un `Deposit`
`detected` con un `Movement` `pending` (il giocatore la vede «in conferma», [WEB-21]). Se sparisce dall'elenco, e gli
altri server confermano che non c'è più, il deposito diventa `orphaned` e il movimento `failed`; se ricompare torna `detected`.
*Stato:* implementato (B5) · *Codice:* `apps/lottery/deposits.py:apply_observations` ·
*Test:* `tests/django/test_deposits.py::test_a_waiting_deposit_shows_as_incoming`, `test_a_vanished_waiting_deposit_is_orphaned_and_can_return`