- Add docs/README.md as the index of all documentation. - Split the 52 DEC entries of decisioni-e-limiti.md into docs/adr/ADR-NN files (same numbers), add ADR-53 (audit log), TEMPLATE.md and an ADR index with a feature -> ADR table. - Rename decisioni-e-limiti.md to limiti-noti.md (LIM only) and rewrite all DEC-nn references as links to the ADRs. - Document the docs-first / SSOT / ADR rules in processo-di-modifica.md and map the docs in CLAUDE.md and README.md. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2.3 KiB
2.3 KiB
ADR-17 — La commissione del pagamento esce dalla quota del vincitore; la riserva per l'RBF esce dalla quota della piattaforma
- Stato: Accettata — implementazione da completare (B-79)
- 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_outper 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: app/wallet/psbt_builder.py:build_payout_transaction ·
Test: tests/unit/test_payout_builder.py::test_payout_deducts_fee_only_from_winner_share
Stato: da implementare (B-79) · Oggi: nessuna riserva: il 30% va intero a
fee_address e, nel caso normale, il pagamento non ha resto.