B7: confirmations with merkle proof, adoption of the confirmed version, RBF bumper and reconciler (TX-30..33, DAT-85)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Sonnet 5.5 committed 2026-11-16 16:29:08 +01:00
1 parent feff993584
commit fa57d2e5ab
20 files changed
+1165 -20

No files matched your search

+39
View File
@@ -420,3 +420,42 @@ Nel pannello `/admin` (vedi [guida-admin.md](guida-admin.md) e
correzioni in corso anche `rbf_bump_failed` ([TX-24]) e
`pending_tx_resurrected` ([TX-23]);
- **Round** — stato di ogni round, vincitore e txid del pagamento.
## Transazioni sul sito Django (B7)
Il sito Django riscrive conferma, accelerazione e riconciliazione sull'ORM (`ChainTransaction`, [DAT-83]). Per ora riguardano le
**scommesse**; prelievi e pagamenti (B8, B9) usano gli stessi meccanismi. Restano fuori, e sono B10: il rilevamento delle
riorganizzazioni (finestra degli ultimi header, [ELC-22]…[ELC-24]) e le monete già accreditate che poi spariscono ([DEP-06]…[DEP-08]).
- **[TX-30]** **Conferma verificata, con tutte le versioni.** Il worker legge la cronologia dell'indirizzo che spende ogni transazione
`pending` e cerca **ogni** versione ([DAT-83]); una versione con altezza maggiore di 0 è candidata e si confermerà solo con la prova
merkle di [TX-22] (header dell'altezza con lavoro valido per il profilo, prova data dagli altri server a maggioranza,
[ELC-14]). Senza prova la riga resta `pending` e si riprova. Tre fasi: lettura del database, rete senza database aperto, scrittura.
*Stato:* implementato (B7) · *Codice:* `apps/lottery/confirmation.py`, `apps/lottery/electrum_chain.py:ElectrumChain.observe_confirmations` ·
*Test:* `tests/django/test_chain_confirmation.py`, `tests/integration/test_confirmation_regtest.py`
- **[TX-31]** **Si adotta la versione confermata.** Se a confermarsi è una versione **diversa** da `current_txid` (l'originale mentre
una sostituzione era in volo, o una sostituzione che il processo non aveva fatto in tempo a registrare), la riga adotta quel txid e quella
transazione grezza, e lo propaga a scommessa (`bet_txid`) e monete spese (`spent_txid`). Alla conferma di una scommessa: la
`Participation` diventa `confirmed` con `confirmed_at` ed entra nell'estrazione, il movimento di puntata diventa `confirmed`, le monete
spese risultano spese, e l'audit scrive `tx_confirmed`; tutto nella stessa transazione del database ([TX-26]).
*Stato:* implementato (B7) · *Codice:* `apps/lottery/confirmation.py:apply_confirmations` ·
*Test:* `tests/django/test_chain_confirmation.py::test_a_bet_is_confirmed_and_enters_the_draw`, `test_an_earlier_version_that_confirms_is_adopted`
- **[TX-32]** **Accelerazione (RBF).** Una transazione `pending` il cui ultimo invio è più vecchio di `rbf_timeout_seconds`
(`LotteryConfig`, 900 s) è ricostruita con una commissione di 1 sat/vB in più (mai oltre 5 000, mai meno dell'aumento minimo di BIP125),
spendendo le stesse monete; l'aumento si toglie **solo** dal resto del giocatore, e se ne resterebbe meno di 294 sat il resto sparisce
e quella è l'ultima accelerazione ([TX-10], [TX-11]). La sostituzione firmata è registrata come versione **prima** di trasmetterla
([TX-12]); dopo l'invio (accettato o incerto) la riga passa alla nuova versione con un aggiornamento condizionato a stato `pending` e
`current_txid` invariato, altrimenti è un conflitto e la candidata resta registrata ([TX-13]). Se la rete rifiuta la sostituzione o
l'accelerazione è impossibile, la riga non cambia e si scrive `rbf_bump_failed` una sola volta per coppia (txid, motivo) ([TX-24]).
*Stato:* implementato (B7) · *Codice:* `apps/lottery/rbf.py` ·
*Test:* `tests/django/test_chain_rbf.py`, `tests/integration/test_confirmation_regtest.py`
- **[TX-33]** **Riconciliazione e abbandono solo con prova.** Il worker esamina le transazioni `building` da oltre 120 s e `pending` da oltre
6 ore dal primo invio. Se almeno un server conosce una versione, la riga è viva: `building` passa a `pending` (`pending_tx_recovered`).
Se nessuno la conosce, si **ritrasmette** la versione più recente: accettata = viva; rifiutata con prova **per ingressi mancanti o già spesi**
= abbandono (la transazione è `failed` con il motivo, le monete ancora impegnate da *questa* transazione tornano libere, la scommessa è
respinta, il movimento non conta più, `tx_abandoned`); rifiutata per altro (commissione) o incerta = nessun abbandono. Le righe `failed`
restano sorvegliate 14 giorni: se una loro versione risulta confermata si scrive una sola volta `tx_resurrected` e le nuove puntate
si sospendono per l'operatore ([TX-23]). Non esiste un tempo massimo che abbandoni una transazione che un server tiene in mempool.
*Stato:* implementato (B7); la seconda prova di [TX-17] (ingresso speso in un blocco da un'altra transazione) è B10 ·
*Codice:* `apps/lottery/reconcile.py` · *Test:* `tests/django/test_chain_reconcile.py`