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

2.2 KiB

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-05

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 per la sola Fase A).

Conseguenze

  • Gli indirizzi dell'alfa iniziano con rplm1…: la validazione dei prelievi (ADR-05) 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.