Files
plm-lottery/docs/adr/ADR-21-tre-limiti-distinti-sul-numero-monete.md
T
davideandClaude Sonnet 5.5 3ee60a23da 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>
2026-11-16 15:31:47 +01:00

2.2 KiB

ADR-21 — Tre limiti distinti sul numero di monete e di giocatori:

  • Stato: Accettata
  • Area: Economia del gioco
  • Fonte di verità per: la scelta di progetto descritta qui sotto; i requisiti (PREFISSO-NN) che la attuano stanno nei documenti di dominio, indicati nelle Conseguenze.

Decisione

Tre limiti distinti sul numero di monete e di giocatori:

Costante Valore Protegge da
MAX_TX_INPUTS 50 una transazione utente (scommessa, prelievo) che erode l'importo in commissioni per un indirizzo troppo frammentato; oltre, too_many_inputs
MAX_PAYOUT_TX_INPUTS 500 un pagamento troppo grande per le regole di inoltro (~1470 ingressi a 100 kvB); un terzo del margine
MAX_PARTICIPANTS_PER_ROUND 400 un round impagabile: il 401° giocatore è rifiutato con round_full prima che si muova denaro
  • Motivazione: il pagamento spende una moneta del montepremi per scommessa; usare per esso il limite utente rendeva impagabile ogni round oltre ~50 giocatori e fermava la lotteria (B-52). Con un indirizzo per round (ADR-03, B-80) il pagamento spende solo le monete del round, quindi i 100 di differenza fra 400 e 500 restano un margine fisso invece di consumarsi con le monete avanzate dai round precedenti (come accade oggi con l'indirizzo unico).
  • Conseguenze: «ogni round si può pagare» è un invariante verificato all'ingresso, non una scoperta al momento del pagamento. Il conteggio dei partecipanti include quelli non ancora confermati (direzione prudente). Un tetto opzionale al montepremi del round (max_round_pool_sats, 0 = disattivato) rifiuta con round_full anche le scommesse oltre quel valore (B-95); se e come legarlo al costo di un attacco al 51% è una decisione non ancora presa ([LIM-24]).

Codice: plm_engine/psbt_builder.py:select_utxos · app/bets/service.py:place_bet · plm_engine/psbt_builder.py:build_payout_transaction · Test: tests/unit/test_psbt_builder.py::test_select_utxos_never_exceeds_the_input_cap, tests/unit/test_bets.py::test_place_bet_rejects_the_bet_past_the_participant_cap, tests/unit/test_payout_builder.py::test_payout_at_the_participant_cap_stays_well_inside_relay_limits