Files
plm-lottery/docs/adr/ADR-58-alfa-su-regtest-profilo-di-rete-configurabile.md
T

41 lines
2.2 KiB
Markdown

# ADR-58 — L'alfa gira su regtest; la rete è un profilo di configurazione
- **Stato:** Accettata — implementazione da completare
- **Area:** Custodia, chiavi e indirizzi
- **Funzionalità:** ELC, REG, ARC
- **Collegata a:** [ADR-04](ADR-04-accesso-rete-via-protocollo-electrum.md), [ADR-05](ADR-05-indirizzi-bech32-plm-plm1-come-destinazione.md)
## Contesto
Per i test alfa non si usa denaro reale. L'ambiente `plm-regtest` fornisce
un nodo Palladium in regtest e un server Fulcrum, dove i blocchi si generano a
richiesta, così un round completo si prova in pochi minuti e le
riorganizzazioni si simulano. I parametri vengono da `palladiumcore`
(`chainparams.cpp`): hrp `rplm`, genesis `0f9188f1…2206`, powLimit
`7fff…ff`, porta P2P 28444, prefissi base58 e chiavi estese come testnet.
## Decisione
**La rete è un profilo selezionato dalla configurazione (`PLM_NETWORK` =
`regtest` | `mainnet`)**, che fissa hrp, prefissi, genesis atteso dall'handshake
([ELC-30]), powLimit e coin type. Il pilota usa `regtest`. Il profilo `mainnet`
resta vietato finché le verifiche della Fase C non sono chiuse: l'avvio con
`mainnet` richiede una conferma esplicita in configurazione.
## Alternative scartate
- Testnet pubblica — blocchi non controllabili, lenta per i test dei round.
- Fondi simulati ovunque — non prova nulla del motore PLM (vedi [ADR-59](ADR-59-motore-plm-pacchetto-senza-framework-ledger-simulato.md) per la sola Fase A).
## Conseguenze
- Gli indirizzi dell'alfa iniziano con `rplm1…`: la validazione dei prelievi
([ADR-05](ADR-05-indirizzi-bech32-plm-plm1-come-destinazione.md)) usa l'hrp del profilo.
- I test di integrazione automatici possono usare il regtest locale.
- Requisiti: `ELC` e `REG` da aggiornare con l'implementazione.
*Codice:* `plm_engine/network.py:Profile`, `MAINNET`, `REGTEST`, `plm_engine/address.py:is_valid_address`, `plm_engine/hd.py`, `config/settings.py` (`PLM_NETWORK`, `PLM_MAINNET_CONFIRMED`, `PLM_PROFILE`) ·
*Test:* `tests/django/test_network_profile.py`
*Stato (B2):* il profilo esiste e governa indirizzi, derivazione, genesis dell'handshake e soglia di lavoro; `mainnet` si avvia solo con `PLM_MAINNET_CONFIRMED=yes` e mai con il ledger simulato. Il nodo regtest vero arriva con B3.