feat(chain): network profiles and consensus constants

src/Core/Chain/ChainProfiles.cs

@@ -0,0 +1,90 @@
+namespace PalladiumWallet.Core.Chain;
+
+/// <summary>
+/// I tre profili di rete del wallet (blueprint §3). Valori mainnet verificati
+/// contro il sorgente del nodo (chainparams.cpp / pow.cpp) secondo il blueprint.
+/// </summary>
+public static class ChainProfiles
+{
+    public static ChainProfile Mainnet { get; } = new()
+    {
+        Kind = NetKind.Mainnet,
+        NetName = "mainnet",
+        CoinUnit = "PLM",
+        WifPrefix = 0x80,
+        AddrP2pkh = 55,   // indirizzi che iniziano con 'P'
+        AddrP2sh = 5,     // indirizzi che iniziano con '3'
+        SegwitHrp = "plm",
+        Bolt11Hrp = "plm",
+        // La mainnet riusa la genesi di Bitcoin (blueprint §3).
+        GenesisHash = "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f",
+        DefaultTcpPort = 50001,
+        DefaultSslPort = 50002,
+        NodeP2pPort = 2333,
+        Bip44CoinType = 746,
+        UriScheme = "palladium",
+        ExplorerUrl = "https://explorer.palladium-coin.com/",
+        SkipPowValidation = true,
+        BlockTimeSeconds = 120,
+        ExtKeyHeaders = new Dictionary<ScriptKind, ExtKeyHeaders>
+        {
+            [ScriptKind.Legacy] = new(0x0488ade4, 0x0488b21e),                // xprv / xpub
+            [ScriptKind.WrappedSegwit] = new(0x049d7878, 0x049d7cb2),         // yprv / ypub
+            [ScriptKind.WrappedSegwitMultisig] = new(0x0295b005, 0x0295b43f), // Yprv / Ypub
+            [ScriptKind.NativeSegwit] = new(0x04b2430c, 0x04b24746),          // zprv / zpub
+            [ScriptKind.NativeSegwitMultisig] = new(0x02aa7a99, 0x02aa7ed3),  // Zprv / Zpub
+        },
+        // TODO: popolare con i server reali prima della release (host:tcp:ssl).
+        BootstrapServers = [],
+        // TODO: popolare con [hash, bits] reali della catena (§7.3) prima della release.
+        Checkpoints = [],
+    };
+
+    public static ChainProfile Testnet { get; } = Mainnet with
+    {
+        Kind = NetKind.Testnet,
+        NetName = "testnet",
+        WifPrefix = 0xff,
+        AddrP2pkh = 127,
+        AddrP2sh = 115,
+        SegwitHrp = "tplm",
+        Bolt11Hrp = "tplm",
+        // TODO: verificare contro chainparams.cpp del nodo (il blueprint non la riporta;
+        // qui si assume la genesi di Bitcoin testnet3, da confermare).
+        GenesisHash = "000000000933ea01ad0ee984209779baaec3ced90fa3f408719526f8d77f4943",
+        NodeP2pPort = 12333,
+        Bip44CoinType = 1,
+        ExtKeyHeaders = new Dictionary<ScriptKind, ExtKeyHeaders>
+        {
+            // tprv/tpub dal blueprint; le varianti SLIP-132 testnet (u/v/U/V) sono
+            // i valori standard Electrum.
+            [ScriptKind.Legacy] = new(0x04358394, 0x043587cf),                // tprv / tpub
+            [ScriptKind.WrappedSegwit] = new(0x044a4e28, 0x044a5262),         // uprv / upub
+            [ScriptKind.WrappedSegwitMultisig] = new(0x024285b5, 0x024289ef), // Uprv / Upub
+            [ScriptKind.NativeSegwit] = new(0x045f18bc, 0x045f1cf6),          // vprv / vpub
+            [ScriptKind.NativeSegwitMultisig] = new(0x02575048, 0x02575483),  // Vprv / Vpub
+        },
+        BootstrapServers = [],
+        Checkpoints = [],
+    };
+
+    public static ChainProfile Regtest { get; } = Testnet with
+    {
+        Kind = NetKind.Regtest,
+        NetName = "regtest",
+        SegwitHrp = "rplm",
+        Bolt11Hrp = "rplm",
+        // TODO: verificare contro chainparams.cpp del nodo (assunta genesi regtest Bitcoin).
+        GenesisHash = "0f9188f13cb7b2c71f2a335e3a4fc328bf5beb436012afca590b1a11466e2206",
+        NodeP2pPort = 28444,
+        Checkpoints = [],
+    };
+
+    public static ChainProfile For(NetKind kind) => kind switch
+    {
+        NetKind.Mainnet => Mainnet,
+        NetKind.Testnet => Testnet,
+        NetKind.Regtest => Regtest,
+        _ => throw new ArgumentOutOfRangeException(nameof(kind)),
+    };
+}