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:
1 parent
f1d09075a1
commit
2acd4ccd1c
21 files changed
+1223
-49
No files matched your search
@@ -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`
|
||||
|
||||
Reference in new issue
Block a user