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:
1 parent
feff993584
commit
fa57d2e5ab
20 files changed
+1165
-20
No files matched your search
@@ -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`
|
||||
|
||||
Reference in new issue
Block a user