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>
2.0 KiB
ADR-59 — Il motore PLM è un pacchetto senza framework; la Fase A usa un ledger simulato
- Stato: Accettata — implementazione da completare
- Area: Architettura
- Funzionalità: ARC, TX, RND
- Collegata a: ADR-54, ADR-55
Contesto
Derivazione degli indirizzi, costruzione e firma delle transazioni, client Electrum, validazione degli header e calcolo dell'estrazione non dipendono dal database né da FastAPI. I servizi di puntata, prelievo, deposito, scheduler e riconciliazione sì (SQLAlchemy). Il TODO vuole un round completo verificabile dal browser prima di integrare il motore.
Decisione
I moduli senza database passano così come sono in un pacchetto separato
(plm_engine), senza dipendere da Django; i servizi che toccano il database
vengono riscritti sull'ORM Django con la stessa logica. I 758 test del
motore puro restano e sono la prova di equivalenza (stessi indirizzi, importi,
output e risultato a parità di input).
Nella Fase A i movimenti di denaro passano da un ledger simulato dietro la stessa interfaccia dei servizi (deposito, puntata, pagamento). Nella Fase B l'implementazione simulata si sostituisce con quella che usa Electrum, senza cambiare viste né modelli.
Alternative scartate
- Riscrivere tutto da zero — perde 758 test e anni di correzioni (B-nn).
- Integrare subito il motore — il sito sarebbe verificabile solo con la catena disponibile; il ledger simulato isola i problemi.
Conseguenze
- Il ledger simulato non esiste in produzione: è escluso dal profilo
mainnet. - Requisiti:
ARCda aggiornare con l'implementazione.
Codice: plm_engine/ (draw.py, headers.py, network.py, address.py, hd.py, psbt_builder.py, electrum/); il caricamento della chiave cifrata resta in app/wallet/hd.py (stack vecchio) · Test: tests/django/test_engine_package.py (nessun import di framework), i test del motore sotto tests/unit/ invariati