Files
plm-lottery/docs/adr/ADR-17-commissione-pagamento-esce-dalla-quota-vincitore.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.3 KiB
Raw Blame History

ADR-17 — La commissione del pagamento esce dalla quota del vincitore; la riserva per l'RBF esce dalla quota della piattaforma

  • 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

La commissione del pagamento esce dalla quota del vincitore; la riserva per l'RBF esce dalla quota della piattaforma. Ogni pagamento ha un'uscita di riserva di max(DUST_LIMIT_SATS, dimensione stimata × 10 sat/vB) verso l'indirizzo di riserva del montepremi (ADR-03); un'accelerazione riduce quell'uscita. La commissione verso fee_address è quindi il 30% meno la riserva.

  • Motivazione: il pagamento spende di norma tutte e sole le monete del round, quindi non ha resto e non si potrebbe mai accelerare: un pagamento fermo in mempool terrebbe il round in paying_out per sempre (B-79). La riserva la paga la piattaforma perché è la piattaforma a scegliere il fee rate.
  • Alternative scartate: riserva presa dalla quota del vincitore (il montepremi annunciato scenderebbe ancora); CPFP da un'uscita del vincitore (richiede una seconda transazione e una moneta del vincitore); pagamento senza riserva e abbandono dopo un timeout (vietato da ADR-51).
  • Conseguenze: il montepremi annunciato (il 70% delle scommesse confermate) supera di poco quanto il vincitore riceve davvero; la differenza, la commissione del pagamento, non è nota finché il pagamento non è costruito. ADR-29 rifiuta di aprire round con una configurazione in cui un round da un partecipante non coprirebbe commissione del vincitore, riserva e una commissione sopra la soglia di polvere. Regole in ciclo-di-vita-del-round.md (B-79).

Codice: plm_engine/psbt_builder.py:build_payout_transaction · Test: tests/unit/test_payout_builder.py::test_payout_deducts_fee_only_from_winner_share, tests/unit/test_payout_builder.py::test_payout_at_the_participant_cap_pays_the_reserve_out_of_the_platform_share, tests/unit/test_broadcast.py::test_a_payout_is_bumped_out_of_its_reserve_output_and_nothing_else