B1: plm_engine takes the modules without a database (ADR-59)
HD derivation (pure part), PSBT builder, Electrum client/merkle/quorum/scripthash, network profile, addresses and header checks move to plm_engine; the old stack imports them from there. A test forbids framework imports in the package. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
c9784efa07
commit
3ee60a23da
87 files changed
+290
-260
No files matched your search
@@ -11,7 +11,7 @@ delle risposte e il catalogo completo dei codici di errore sono in
|
||||
[api.md](api.md); cosa succede a una transazione dopo l'invio in
|
||||
[transazioni-e-riconciliazione.md](transazioni-e-riconciliazione.md).
|
||||
|
||||
Costanti citate in questo documento (tutte in `app/wallet/psbt_builder.py`):
|
||||
Costanti citate in questo documento (tutte in `plm_engine/psbt_builder.py`):
|
||||
|
||||
| Costante | Valore | Significato |
|
||||
|---|---|---|
|
||||
@@ -58,7 +58,7 @@ cifra. Il **costo** è quello del round ([BET-21]):
|
||||
| **[BET-10]** | Il costo meno la commissione di rete resta positivo e di almeno 294 sat | `amount_below_network_fee`, `amount_below_dust_limit` |
|
||||
|
||||
*Codice:* `app/bets/service.py:place_bet`, `app/rounds/service.py:round_accepts_bets`,
|
||||
`app/wallet/psbt_builder.py:select_utxos`, `app/wallet/psbt_builder.py:build_signed_transaction` ·
|
||||
`plm_engine/psbt_builder.py:select_utxos`, `plm_engine/psbt_builder.py:build_signed_transaction` ·
|
||||
*Test:* `tests/unit/test_bets.py`, `tests/unit/test_withdrawals.py`, `tests/unit/test_psbt_builder.py`
|
||||
(nessun test verifica `no_round_open`)
|
||||
|
||||
@@ -74,7 +74,7 @@ ancora `open` oltre la scadenza.
|
||||
lascia 1 PLM di resto. Lo stesso vale per il prelievo: la riduzione di
|
||||
[WDR-09] scatta solo quando nessuna combinazione di monete lascia un resto
|
||||
sufficiente.
|
||||
*Codice:* `app/wallet/psbt_builder.py:select_utxos` ·
|
||||
*Codice:* `plm_engine/psbt_builder.py:select_utxos` ·
|
||||
*Test:* `tests/unit/test_psbt_builder.py`
|
||||
|
||||
- **[BET-21]** Il **costo** di una scommessa è il `bet_amount_sats`
|
||||
@@ -107,7 +107,7 @@ ancora `open` oltre la scadenza.
|
||||
il numero di monete non impedisca mai di pagare un round. La differenza
|
||||
lascia spazio ad altre monete presenti sull'indirizzo del montepremi del
|
||||
round (pagamenti arrivati da fuori).
|
||||
*Codice:* `app/wallet/psbt_builder.py:MAX_PARTICIPANTS_PER_ROUND`, `app/bets/service.py:place_bet` ·
|
||||
*Codice:* `plm_engine/psbt_builder.py:MAX_PARTICIPANTS_PER_ROUND`, `app/bets/service.py:place_bet` ·
|
||||
*Test:* `tests/unit/test_payout_builder.py`, `tests/unit/test_bets.py`
|
||||
|
||||
Con un indirizzo per round
|
||||
@@ -151,7 +151,7 @@ flowchart TB
|
||||
l'**indirizzo del montepremi del round** (`rounds.pool_address`,
|
||||
[RND-35](ciclo-di-vita-del-round.md#0--apertura)), e il resto (monete
|
||||
spese meno il costo) verso l'indirizzo dell'utente.
|
||||
*Codice:* `app/wallet/psbt_builder.py:select_utxos`, `app/wallet/psbt_builder.py:build_signed_transaction`, `app/bets/service.py:place_bet` ·
|
||||
*Codice:* `plm_engine/psbt_builder.py:select_utxos`, `plm_engine/psbt_builder.py:build_signed_transaction`, `app/bets/service.py:place_bet` ·
|
||||
*Test:* `tests/unit/test_psbt_builder.py`, `tests/unit/test_round_pool_address.py`
|
||||
- **[BET-13]** La **commissione di rete** è la dimensione stimata della
|
||||
transazione per `fee_rate_sat_vb` (1 sat/vB predefinito, modificabile da
|
||||
@@ -160,7 +160,7 @@ flowchart TB
|
||||
(`bet_amount_sats`) è proprio questo netto. Per questo il montepremi si
|
||||
calcola sommando gli importi effettivi delle scommesse, non moltiplicando il
|
||||
numero di giocatori per il costo.
|
||||
*Codice:* `app/wallet/psbt_builder.py:build_signed_transaction`, `app/bets/service.py:place_bet` ·
|
||||
*Codice:* `plm_engine/psbt_builder.py:build_signed_transaction`, `app/bets/service.py:place_bet` ·
|
||||
*Test:* `tests/unit/test_psbt_builder.py`, `tests/unit/test_rounds_route.py`
|
||||
- **[BET-14]** Il **resto** torna sempre allo stesso indirizzo dell'utente ed è
|
||||
sempre di almeno 294 sat (`DUST_LIMIT_SATS`). A differenza del prelievo, la
|
||||
@@ -171,7 +171,7 @@ flowchart TB
|
||||
[TX-11](transazioni-e-riconciliazione.md#rbf-accelerare-una-transazione-lenta):
|
||||
un resto di 294 sat non regge una riduzione (l'aumento minimo è di 141 sat a
|
||||
1 sat/vB), quindi garantisce una sola accelerazione, che lo elimina.
|
||||
*Codice:* `app/wallet/psbt_builder.py:build_signed_transaction` ·
|
||||
*Codice:* `plm_engine/psbt_builder.py:build_signed_transaction` ·
|
||||
*Test:* `tests/unit/test_withdrawals.py` (i test del resto delle scommesse
|
||||
sono lì: `test_a_bet_from_a_balance_equal_to_the_bet_is_refused`,
|
||||
`test_a_bet_with_a_dust_limit_of_headroom_is_accepted`),
|
||||
@@ -225,7 +225,7 @@ flowchart TB
|
||||
- **[BET-19]** Tutte le scommesse hanno **la stessa probabilità** di vincere,
|
||||
indipendentemente dall'importo netto e da tutto il resto
|
||||
([RND-17](ciclo-di-vita-del-round.md#3--estrazione)).
|
||||
*Codice:* `app/rounds/draw.py:draw_winner` ·
|
||||
*Codice:* `plm_engine/draw.py:draw_winner` ·
|
||||
*Test:* `tests/unit/test_draw.py`
|
||||
|
||||
## Prelievo
|
||||
@@ -254,8 +254,8 @@ HTTP 400 prima che si muova qualunque cifra:
|
||||
| **[WDR-06]** | L'importo si copre con al massimo 50 monete (`MAX_TX_INPUTS`) | `too_many_inputs` (parametro `max_inputs`) |
|
||||
| **[WDR-07]** | L'importo meno la commissione di rete resta positivo e di almeno 294 sat | `amount_below_network_fee`, `amount_below_dust_limit` |
|
||||
|
||||
*Codice:* `app/withdrawals/service.py:request_withdrawal`, `app/wallet/address.py:is_valid_plm_address`,
|
||||
`app/wallet/psbt_builder.py:build_signed_transaction` ·
|
||||
*Codice:* `app/withdrawals/service.py:request_withdrawal`, `plm_engine/address.py:is_valid_plm_address`,
|
||||
`plm_engine/psbt_builder.py:build_signed_transaction` ·
|
||||
*Test:* `tests/unit/test_withdrawals.py`, `tests/unit/test_psbt_builder.py`
|
||||
|
||||
La struttura è identica alla scommessa: transazione firmata dall'indirizzo
|
||||
@@ -267,7 +267,7 @@ solo se la rete rifiuta esplicitamente, RBF se non conferma in tempo.
|
||||
grande, ingressi sostituibili BIP125); all'indirizzo esterno arriva
|
||||
l'importo meno la commissione di rete, il resto torna all'indirizzo
|
||||
dell'utente.
|
||||
*Codice:* `app/wallet/psbt_builder.py:build_signed_transaction` ·
|
||||
*Codice:* `plm_engine/psbt_builder.py:build_signed_transaction` ·
|
||||
*Test:* `tests/unit/test_psbt_builder.py`, `tests/unit/test_withdrawals.py`
|
||||
- **[WDR-09]** **Resto garantito.** Se l'importo richiesto lascerebbe un resto
|
||||
inferiore a 294 sat (`DUST_LIMIT_SATS`) — ad esempio il prelievo
|
||||
@@ -279,7 +279,7 @@ solo se la rete rifiuta esplicitamente, RBF se non conferma in tempo.
|
||||
(`amount_sent_sats`). Come per la scommessa ([BET-14]), questo resto è
|
||||
l'uscita che l'RBF riduce o elimina
|
||||
([TX-11](transazioni-e-riconciliazione.md#rbf-accelerare-una-transazione-lenta)).
|
||||
*Codice:* `app/wallet/psbt_builder.py:build_signed_transaction`, `app/withdrawals/service.py:request_withdrawal` ·
|
||||
*Codice:* `plm_engine/psbt_builder.py:build_signed_transaction`, `app/withdrawals/service.py:request_withdrawal` ·
|
||||
*Test:* `tests/unit/test_withdrawals.py`, `tests/unit/test_psbt_builder.py`
|
||||
- **[WDR-15]** L'importo ridotto da [WDR-09] viene verificato di nuovo
|
||||
contro il minimo di [WDR-04]: se è sceso sotto `bet_amount_sats`, il
|
||||
|
||||
Reference in new issue
Block a user