@neuraiproject/neurai-key 2.8.6 → 2.8.8

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Neuraiproject
+Copyright (c) 2026 Neuraiproject
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -5,7 +5,7 @@ Generate Neurai addresses from a mnemonic phrase following the standards BIP32,
 That is, use your 12 words to get addresses for Neurai mainnet and testnet.
 
 **NPM**: https://www.npmjs.com/package/@neuraiproject/neurai-key   
-**CDN**: https://cdn.jsdelivr.net/npm/@neuraiproject/neurai-key@2.8.5/dist/NeuraiKey.js   
+**CDN**: https://cdn.jsdelivr.net/npm/@neuraiproject/neurai-key@2.8.8/dist/NeuraiKey.js   
 
 ## Features
 
@@ -14,7 +14,24 @@ That is, use your 12 words to get addresses for Neurai mainnet and testnet.
 - ✅ Support for passphrase (25th word) for additional security
 - ✅ Multi-language mnemonic support (English, Spanish, French, Italian, etc.)
 - ✅ Mainnet and Testnet support for Neurai (XNA)
+- ✅ Support for both XNA (BIP44: 1900) and XNA Legacy (BIP44: 0) networks
 - ✅ Convert raw public keys into Neurai mainnet or testnet addresses
+- ✅ PostQuantum addresses using ML-DSA-44 (FIPS 204) with Bech32m encoding
+
+## Network Types
+
+This library supports three Neurai network configurations:
+
+- **`xna` / `xna-test`**: Current Neurai standard (BIP44 coin type: 1900)
+- **`xna-legacy` / `xna-legacy-test`**: Legacy Neurai addresses (BIP44 coin type: 0)
+- **`xna-pq` / `xna-pq-test`**: PostQuantum ML-DSA-44 addresses (Bech32m, witness v1)
+
+The main difference is the derivation path and address encoding:
+- **XNA**: `m/44'/1900'/0'/0/0` — Base58Check, prefix `N` (recommended for new wallets)
+- **XNA Legacy**: `m/44'/0'/0'/0/0` — Base58Check, prefix `N` (for compatibility with older wallets)
+- **XNA PostQuantum**: `m/100'/1900'/0'/0/0` — Bech32m, prefix `nq1` (for future quantum-resistant fork)
+
+**Note**: Using different network types will generate completely different addresses from the same mnemonic.
 
 
 ## Example get external and internal (change) addresses by path
@@ -31,7 +48,7 @@ import NeuraiKey from "@neuraiproject/neurai-key";
 const mnemonic = NeuraiKey.generateMnemonic();
 const ACCOUNT = 0; //default is zero
 const POSITION = 1; //the second address for this wallet
-const network = "xna"; //or xna-test for testnet
+const network = "xna"; //or xna-test for testnet, xna-legacy for legacy addresses
 const addressPair = NeuraiKey.getAddressPair(
   network,
   mnemonic,
@@ -166,6 +183,75 @@ console.log(testAddress); // tPXGaMRNwZuV1UKSrD9gABPscrJWUmedQ9
 
 `publicKeyToAddress` throws if the key length is not 33 or 65 bytes so invalid inputs are surfaced immediately.
 
+## PostQuantum (ML-DSA-44) Addresses
+
+Generate quantum-resistant addresses using the ML-DSA-44 signature scheme (FIPS 204). These addresses use Bech32m encoding with witness version 1, preparing for a future post-quantum fork.
+
+### Generate a PQ address
+
+```javascript
+import NeuraiKey from "@neuraiproject/neurai-key";
+
+const mnemonic = NeuraiKey.generateMnemonic();
+const network = "xna-pq"; // or "xna-pq-test" for testnet
+const ACCOUNT = 0;
+const INDEX = 0;
+
+const pqAddress = NeuraiKey.getPQAddress(network, mnemonic, ACCOUNT, INDEX);
+console.log(pqAddress);
+```
+
+Outputs
+
+```
+{
+  address: 'nq1...',                    // Bech32m address
+  path: "m/100'/1900'/0'/0/0",          // PQ derivation path
+  publicKey: '...',                     // ML-DSA-44 public key (2624 hex chars = 1312 bytes)
+  privateKey: '...',                    // ML-DSA-44 private key (5120 hex chars = 2560 bytes)
+  seedKey: '...'                        // 32-byte BIP32 seed used for ML-DSA keygen (64 hex chars)
+}
+```
+
+### Generate a random PQ wallet
+
+```javascript
+const pqWallet = NeuraiKey.generatePQAddressObject("xna-pq");
+console.log(pqWallet.mnemonic);  // 12-word mnemonic
+console.log(pqWallet.address);   // nq1...
+```
+
+### Reconstruct a PQ address from its public key
+
+```javascript
+const pqAddress = NeuraiKey.getPQAddress("xna-pq", mnemonic, 0, 0);
+const reconstructed = NeuraiKey.pqPublicKeyToAddress("xna-pq", pqAddress.publicKey);
+// reconstructed === pqAddress.address
+```
+
+### Advanced: derive by path with HD key reuse
+
+```javascript
+const hdKey = NeuraiKey.getPQHDKey("xna-pq", mnemonic);
+const addr0 = NeuraiKey.getPQAddressByPath("xna-pq", hdKey, "m/100'/1900'/0'/0/0");
+const addr1 = NeuraiKey.getPQAddressByPath("xna-pq", hdKey, "m/100'/1900'/0'/0/1");
+```
+
+### PQ Address Details
+
+| Property | Value |
+|----------|-------|
+| Signature algorithm | ML-DSA-44 (FIPS 204) |
+| Address encoding | Bech32m (witness version 1) |
+| Mainnet HRP / prefix | `nq` / `nq1...` |
+| Testnet HRP / prefix | `tnq` / `tnq1...` |
+| Public key size | 1312 bytes |
+| Derivation path (mainnet) | `m/100'/1900'/0'/0/index` |
+| Derivation path (testnet) | `m/100'/1900'/0'/1/index` |
+| Address hash | HASH160(0x05 \|\| pubkey) |
+
+**Note**: PQ addresses do not have a WIF (Wallet Import Format) field since WIF is specific to secp256k1 keys. The `seedKey` field contains the 32-byte BIP32-derived seed used for deterministic ML-DSA-44 key generation, useful for cross-implementation verification.
+
 ## Get public key from WIF
 
 If you have a private key in Wallet Import Format (WIF) and want the corresponding compressed public key:

package/coins/xna-legacy.js

@@ -0,0 +1,82 @@
+/**
+ * Neurai Legacy (XNA-LEGACY) chain configuration data
+ * This replaces the dependency on @hyperbitjs/chains with only the data needed for Neurai Legacy
+ */
+
+const xnaLegacy = {
+  mainnet: {
+    name: "Neurai",
+    unit: "XNA",
+    symbol: "xna",
+    decimalPlaces: 100000000,
+    messagePrefix: "Neurai Signed Message:\n",
+    confirmations: 6,
+    website: "https://neurai.org/",
+    projectUrl: "https://github.com/NeuraiProject",
+    id: "94C49B3B-2C88-4408-B566-3D277C596778",
+    network: "mainnet",
+    hashGenesisBlock: "00000044d33c0c0ba019be5c0249730424a69cb4c222153322f68c6104484806",
+    port: 19000,
+    portRpc: 19001,
+    protocol: {
+      magic: 1381320014
+    },
+    seedsDns: [
+      "seed1.neurai.org",
+      "seed2.neurai.org",
+      "neurai-ipv4.neuraiexplorer.com"
+    ],
+    versions: {
+      bip32: {
+        private: 76066276,
+        public: 76067358
+      },
+      bip44: 0,
+      private: 128,
+      public: 53,
+      scripthash: 117
+    }
+  },
+  testnet: {
+    name: "Neurai",
+    unit: "XNA",
+    symbol: "xna",
+    decimalPlaces: 100000000,
+    messagePrefix: "Neurai Signed Message:\n",
+    confirmations: 6,
+    website: "https://neurai.org/",
+    projectUrl: "https://github.com/NeuraiProject",
+    id: "1EB2ACBA-E8E0-4970-BB20-37DA4B70F6A6",
+    network: "testnet",
+    hashGenesisBlock: "0000006af8b8297448605b0283473ec712f9768f81cc7eae6269b875dee3b0cf",
+    port: 19100,
+    portRpc: 19101,
+    protocol: {
+      magic: 1313166674
+    },
+    seedsDns: [
+      "testnet1.neuracrypt.org",
+      "testnet2.neuracrypt.org",
+      "testnet3.neuracrypt.org"
+    ],
+    versions: {
+      bip32: {
+        private: 70615956,
+        public: 70617039
+      },
+      bip44: 1,
+      private: 239,
+      public: 127,
+      scripthash: 196
+    }
+  }
+};
+
+const chains = {
+  "xna-legacy": xnaLegacy
+};
+
+module.exports = {
+  xnaLegacy,
+  chains
+};

package/coins/xna-pq.js

@@ -0,0 +1,39 @@
+/**
+ * Neurai (XNA) PostQuantum chain configuration data
+ * ML-DSA-44 addresses using Bech32m encoding with witness version 1
+ */
+
+const xnaPQ = {
+  mainnet: {
+    hrp: "nq",
+    witnessVersion: 1,
+    purpose: 100,
+    coinType: 1900,
+    changeIndex: 0,
+    bip32: {
+      private: 76066276,
+      public: 76067358
+    }
+  },
+  testnet: {
+    hrp: "tnq",
+    witnessVersion: 1,
+    purpose: 100,
+    coinType: 1900,
+    changeIndex: 1,
+    bip32: {
+      private: 70615956,
+      public: 70617039
+    }
+  }
+};
+
+const pqChains = {
+  "xna-pq": xnaPQ.mainnet,
+  "xna-pq-test": xnaPQ.testnet
+};
+
+module.exports = {
+  xnaPQ,
+  pqChains
+};

package/coins/xna.js

@@ -0,0 +1,82 @@
+/**
+ * Neurai (XNA) chain configuration data
+ * This replaces the dependency on @hyperbitjs/chains with only the data needed for Neurai
+ */
+
+const xna = {
+  mainnet: {
+    name: "Neurai",
+    unit: "XNA",
+    symbol: "xna",
+    decimalPlaces: 100000000,
+    messagePrefix: "Neurai Signed Message:\n",
+    confirmations: 6,
+    website: "https://neurai.org/",
+    projectUrl: "https://github.com/NeuraiProject",
+    id: "94C49B3B-2C88-4408-B566-3D277C596778",
+    network: "mainnet",
+    hashGenesisBlock: "00000044d33c0c0ba019be5c0249730424a69cb4c222153322f68c6104484806",
+    port: 19000,
+    portRpc: 19001,
+    protocol: {
+      magic: 1381320014
+    },
+    seedsDns: [
+      "seed1.neurai.org",
+      "seed2.neurai.org",
+      "neurai-ipv4.neuraiexplorer.com"
+    ],
+    versions: {
+      bip32: {
+        private: 76066276,
+        public: 76067358
+      },
+      bip44: 1900,
+      private: 128,
+      public: 53,
+      scripthash: 117
+    }
+  },
+  testnet: {
+    name: "Neurai",
+    unit: "XNA",
+    symbol: "xna",
+    decimalPlaces: 100000000,
+    messagePrefix: "Neurai Signed Message:\n",
+    confirmations: 6,
+    website: "https://neurai.org/",
+    projectUrl: "https://github.com/NeuraiProject",
+    id: "1EB2ACBA-E8E0-4970-BB20-37DA4B70F6A6",
+    network: "testnet",
+    hashGenesisBlock: "0000006af8b8297448605b0283473ec712f9768f81cc7eae6269b875dee3b0cf",
+    port: 19100,
+    portRpc: 19101,
+    protocol: {
+      magic: 1313166674
+    },
+    seedsDns: [
+      "testnet1.neuracrypt.org",
+      "testnet2.neuracrypt.org",
+      "testnet3.neuracrypt.org"
+    ],
+    versions: {
+      bip32: {
+        private: 70615956,
+        public: 70617039
+      },
+      bip44: 1,
+      private: 239,
+      public: 127,
+      scripthash: 196
+    }
+  }
+};
+
+const chains = {
+  xna
+};
+
+module.exports = {
+  xna,
+  chains
+};