@neuraiproject/neurai-key 2.8.3 → 2.8.5

package/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "liveServer.settings.port": 5501
+}

package/README.md

@@ -3,7 +3,15 @@
 Generate Neurai addresses from a mnemonic phrase following the standards BIP32, BIP39, BIP44.
 
 That is, use your 12 words to get addresses for Neurai mainnet and testnet.
-The library also support Evrmorecoin EVR, both mainnet and testnet.
+
+## Features
+
+- ✅ Generate HD wallets from mnemonic phrases (BIP39)
+- ✅ Derive addresses using BIP32/BIP44 standards
+- ✅ Support for passphrase (25th word) for additional security
+- ✅ Multi-language mnemonic support (English, Spanish, French, Italian, etc.)
+- ✅ Mainnet and Testnet support for Neurai (XNA)
+- ✅ Convert raw public keys into Neurai mainnet or testnet addresses
 
 
 ## Example get external and internal (change) addresses by path
@@ -19,7 +27,7 @@ import NeuraiKey from "@neuraiproject/neurai-key";
 
 const mnemonic = NeuraiKey.generateMnemonic();
 const ACCOUNT = 0; //default is zero
-const POSITION = 0; //the first address for this wallet
+const POSITION = 1; //the second address for this wallet
 const network = "xna"; //or xna-test for testnet
 const addressPair = NeuraiKey.getAddressPair(
   network,
@@ -36,24 +44,65 @@ console.log(addressPair);
 Outputs
 
 ```
-Mnemonic wrong breeze brick wrestle exotic erode news clown copy install marble promote
+Mnemonic result pact model attract result puzzle final boss private educate luggage era
 {
   internal: {
-    address: 'RC7Vn28tGaNrJtBm8MX5RCeCvzMpqZ1MgG',
-    path: "m/44'/175'/0'/1/0",
-    privateKey: 'a2c71a4284ed6792debd68d830a10515051fd166ce00535bf9fd19573ed5413b',
-    WIF: 'L2g8U3ZNBLBQcy5f6C67h2eosps3MGkNmeNnk6Y8fZiMdSB9TuCJ'
+    address: 'NQM5zP6jkwDgCZ2UQiUicW4e3YcWc4NY4S',
+    path: "m/44'/0'/0'/1/1",
+    publicKey: '02fe9a4190973398c54cdea353cb5b18aba4f272324ac3f15f4f204ef0884538e7',
+    privateKey: '8ce41bc45958cf3f4124bcd40b940752fbaf9be58ed8dec2dd7551388523f0a9',
+    WIF: 'L1was5cU14EbQDfz4BpiWhNAWZdmc4o1VSzv5w5GgKzSJwHpnGzP'
   },
   external: {
-    address: 'RE8YxTSYYcftnbX56rnAEwaiddqaqt8UgX',
-    path: "m/44'/175'/0'/0/0",
-    privateKey: 'b998a218e6bfde7162460893f79afc14b82b14e368507f5a85de28848ea96439',
-    WIF: 'L3SV871B2mpUPTvj4U38UEp3Ah3wCVukF7tG2btHgjkiUSXRftSw'
+    address: 'NLdcSXGQvCVf2RTKhx7GZom34f1JADhBTp',
+    path: "m/44'/0'/0'/0/1",
+    publicKey: '024108b96e53795cc28fb8b64532e61f17aa3c149e06815958361c5dddba1e7ec0',
+    privateKey: '08ae5a08aa6a464619c177a551488c868010b4d2b2249892712be9a4990f9fc3',
+    WIF: 'KwWavecys1Qskgzwsyv6CNeTospWkvMeLzx3dLqeV4xAJEMXF8Qq'
   },
-  position: 0
+  position: 1
 }
 ```
 
+## Example with Passphrase (BIP39 25th word)
+
+For enhanced security, you can use an optional passphrase (also known as the "25th word"). 
+This creates a completely different set of addresses from the same mnemonic.
+
+**Important**: If you lose your passphrase, you cannot recover your wallet even with the mnemonic!
+
+```javascript
+import NeuraiKey from "@neuraiproject/neurai-key";
+
+const mnemonic = "result pact model attract result puzzle final boss private educate luggage era";
+const passphrase = "my secret passphrase"; // Optional but highly secure
+const network = "xna";
+const ACCOUNT = 0;
+const POSITION = 0;
+
+// Generate address with passphrase
+const addressPair = NeuraiKey.getAddressPair(
+  network,
+  mnemonic,
+  ACCOUNT,
+  POSITION,
+  passphrase  // 5th parameter (optional)
+);
+
+console.log(addressPair.external.address);
+// This will generate a DIFFERENT address than without the passphrase
+
+// Without passphrase (or empty string)
+const addressPairNoPass = NeuraiKey.getAddressPair(network, mnemonic, ACCOUNT, POSITION);
+console.log(addressPairNoPass.external.address);
+// This generates the standard address
+```
+
+**Use cases for passphrase:**
+- Extra layer of security beyond the mnemonic
+- Create multiple wallets from a single mnemonic
+- Plausible deniability (different passphrases = different wallets)
+
 ## Example get the first public address for a wallet by BIP44 path
 
 Note this is the fastest way to generate/derive addresses since we can re-use the hdKey object.
@@ -65,10 +114,13 @@ import NeuraiKey from "@neuraiproject/neurai-key";
 
 //use NeuraiKey.generateMnemonic() to generate mnemonic codes
 const mnemonic =
-  "Mnemonic erosion total live dial hamster helmet top response cash obey anger balcony";
-const path = "m/44'/175'/0'/0/0";
+  "result pact model attract result puzzle final boss private educate luggage era";
+const path = "m/44'/175'/0'/0/1";
 const network = "xna"; //or xna-test for testnet
-const hdKey = NeuraiKey.getHDKey("xna", mnemonic);
+
+// Optional: add passphrase as third parameter
+const passphrase = ""; // empty string or omit for no passphrase
+const hdKey = NeuraiKey.getHDKey(network, mnemonic, passphrase);
 
 const address = NeuraiKey.getAddressByPath(network, hdKey, path);
 
@@ -80,13 +132,37 @@ Outputs
 
 ```
 {
-  address: 'RWj697pj6PijkEcJLW3BLPG4GKre3BtgRP',
-  path: "m/44'/175'/0'/0/0",
-  privateKey: 'a5592434532a09a73350906f7846d272135a56b5a34d900659b31d2bb1aa6dfe',
-  WIF: 'L2m8GmGYVAkvUEtLdhbFidQW2Zn3fULpE7sbWgmXChygNEBPd1PK'
+  address: 'NLdcSXGQvCVf2RTKhx7GZom34f1JADhBTp',
+  path: "m/44'/0'/0'/0/1",
+  publicKey: '024108b96e53795cc28fb8b64532e61f17aa3c149e06815958361c5dddba1e7ec0',
+  privateKey: '08ae5a08aa6a464619c177a551488c868010b4d2b2249892712be9a4990f9fc3',
+  WIF: 'KwWavecys1Qskgzwsyv6CNeTospWkvMeLzx3dLqeV4xAJEMXF8Qq'
 }
 ```
 
+## Convert a public key into a Neurai address
+
+Every derived address now exposes the compressed public key so you can verify or reconstruct the address later. If you only have the raw public key (33-byte compressed or 65-byte uncompressed) you can convert it back into a Neurai address on either network:
+
+```javascript
+import NeuraiKey from "@neuraiproject/neurai-key";
+
+const mnemonic = "result pact model attract result puzzle final boss private educate luggage era";
+const pair = NeuraiKey.getAddressPair("xna", mnemonic, 0, 1);
+
+// `publicKey` is a hex string, but Buffers are also accepted
+const reconstructed = NeuraiKey.publicKeyToAddress("xna", pair.external.publicKey);
+
+console.log(reconstructed); // NLdcSXGQvCVf2RTKhx7GZom34f1JADhBTp
+
+// Works the same way for testnet
+const testPair = NeuraiKey.getAddressPair("xna-test", mnemonic, 0, 1);
+const testAddress = NeuraiKey.publicKeyToAddress("xna-test", testPair.external.publicKey);
+console.log(testAddress); // tPXGaMRNwZuV1UKSrD9gABPscrJWUmedQ9
+```
+
+`publicKeyToAddress` throws if the key length is not 33 or 65 bytes so invalid inputs are surfaced immediately.
+
 ## How to import into your project
 
 ### ES6 module
@@ -157,9 +233,9 @@ Source: https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki
 
 `m / purpose' / coin_type' / account' / change / address_index`
 
-So in the case of Neurai the path m/44'/175'/0'/0/0 says "give me the first address"
+So in the case of Neurai the path m/44'/0'/0'/0/1 says "give me the second address"
 
-The first part m/44'/175' says that the purpose is to use BIP44 with Neurai (175). Consider that static code.
+The first part m/44'/0' says that the purpose is to use BIP44 with Neurai (coin_type 0). Consider that static code.
 
 Accounts is deprecated and should be 0