quantum-coin-js-sdk 1.0.30 → 1.0.32

package/index.d.ts

@@ -664,6 +664,15 @@ export class AccountTransactionCompact {
  * @return {array|number|null} Returns an array of seed words (32 or 36 words). Returns -1000 if not initialized, null on failure.
  */
 export function newWalletSeed(keyType: number | null): any[] | number | null;
+/**
+ * The openWalletFromSeed function creates a wallet from a raw seed byte array.
+ * Determines the key scheme from the array length: 96 bytes (hybrideds), 72 bytes (hybrid5), or 64 bytes (hybrid).
+ *
+ * @function openWalletFromSeed
+ * @param {Array<number>|Uint8Array} seedArray - The raw seed bytes. Length 96, 72, or 64 depending on scheme.
+ * @return {Wallet|number} Returns a Wallet object. Returns -1000 if not initialized, null if the operation failed.
+ */
+export function openWalletFromSeed(seedArray: Array<number> | Uint8Array): Wallet | number;
 /**
  * The openWalletFromSeedWords function creates a wallet from a seed word list. The seed word list is available for wallets created from Desktop/Web/Mobile wallets.
  * Supports 48 words (hybrideds), 36 words (hybrid5), or 32 words (hybrid) per seed length.

package/index.js

@@ -1044,26 +1044,22 @@ function newWalletSeed(keyType) {
 }
 
 /**
- * The openWalletFromSeedWords function creates a wallet from a seed word list. The seed word list is available for wallets created from Desktop/Web/Mobile wallets.
- * Supports 48 words (hybrideds), 36 words (hybrid5), or 32 words (hybrid) per seed length.
+ * The openWalletFromSeed function creates a wallet from a raw seed byte array.
+ * Determines the key scheme from the array length: 96 bytes (hybrideds), 72 bytes (hybrid5), or 64 bytes (hybrid).
  *
- * @function openWalletFromSeedWords
- * @param {array} seedWordList - An array of seed words. Length 48, 36, or 32 depending on scheme.
+ * @function openWalletFromSeed
+ * @param {Array<number>|Uint8Array} seedArray - The raw seed bytes. Length 96, 72, or 64 depending on scheme.
  * @return {Wallet|number} Returns a Wallet object. Returns -1000 if not initialized, null if the operation failed.
  */
-function openWalletFromSeedWords(seedWordList) {
+function openWalletFromSeed(seedArray) {
     if (isInitialized === false) {
         return -1000;
     }
-    if (seedWordList == null || typeof seedWordList.length !== 'number') {
+    if (seedArray == null || typeof seedArray.length !== 'number') {
         return null;
     }
-    const len = seedWordList.length;
-    if (len !== SEED_WORD_LIST_LENGTH_HYBRIDEDS && len !== SEED_WORD_LIST_LENGTH_HYBRIDEDMLDSASLHDSA5 && len !== SEED_WORD_LIST_LENGTH_HYBRIDEDMLDSASLHDSA) {
-        return null;
-    }
-    const seedArray = seedwords.getSeedArrayFromWordList(seedWordList);
-    if (seedArray == null || seedArray.length == null) {
+    const len = seedArray.length;
+    if (len !== BASE_SEED_BYTES_HYBRIDEDS && len !== BASE_SEED_BYTES_HYBRIDEDMLDSASLHDSA5 && len !== BASE_SEED_BYTES_HYBRIDEDMLDSASLHDSA) {
         return null;
     }
     if (circl == null) {
@@ -1072,16 +1068,14 @@ function openWalletFromSeedWords(seedWordList) {
     let expandedRes;
     let keyPairRes;
     const seedU8 = seedArray instanceof Uint8Array ? seedArray : new Uint8Array(seedArray);
-    if (len === SEED_WORD_LIST_LENGTH_HYBRIDEDS) {
-        if (seedArray.length !== BASE_SEED_BYTES_HYBRIDEDS) return null;
+    if (len === BASE_SEED_BYTES_HYBRIDEDS) {
         const ns = circl.hybrideds;
         if (!ns) return null;
         expandedRes = ns.expandSeed(seedU8);
         if (expandedRes && expandedRes.error) return null;
         if (!expandedRes || !expandedRes.result) return null;
         keyPairRes = ns.newKeyFromSeed(expandedRes.result);
-    } else if (len === SEED_WORD_LIST_LENGTH_HYBRIDEDMLDSASLHDSA5) {
-        if (seedArray.length !== BASE_SEED_BYTES_HYBRIDEDMLDSASLHDSA5) return null;
+    } else if (len === BASE_SEED_BYTES_HYBRIDEDMLDSASLHDSA5) {
         const ns = circl.hybridedmldsaslhdsa5 || circl.hybridedmldsaslhds5;
         if (!ns) return null;
         expandedRes = ns.expandSeed(seedU8);
@@ -1089,7 +1083,6 @@ function openWalletFromSeedWords(seedWordList) {
         if (!expandedRes || !expandedRes.result) return null;
         keyPairRes = ns.newKeyFromSeed(expandedRes.result);
     } else {
-        if (seedArray.length !== BASE_SEED_BYTES_HYBRIDEDMLDSASLHDSA) return null;
         const ns = circl.hybridedmldsaslhdsa;
         if (!ns) return null;
         expandedRes = ns.expandSeed(seedU8);
@@ -1105,6 +1098,32 @@ function openWalletFromSeedWords(seedWordList) {
     return new Wallet(address, privateKey, publicKey);
 }
 
+/**
+ * The openWalletFromSeedWords function creates a wallet from a seed word list. The seed word list is available for wallets created from Desktop/Web/Mobile wallets.
+ * Supports 48 words (hybrideds), 36 words (hybrid5), or 32 words (hybrid) per seed length.
+ *
+ * @function openWalletFromSeedWords
+ * @param {array} seedWordList - An array of seed words. Length 48, 36, or 32 depending on scheme.
+ * @return {Wallet|number} Returns a Wallet object. Returns -1000 if not initialized, null if the operation failed.
+ */
+function openWalletFromSeedWords(seedWordList) {
+    if (isInitialized === false) {
+        return -1000;
+    }
+    if (seedWordList == null || typeof seedWordList.length !== 'number') {
+        return null;
+    }
+    const len = seedWordList.length;
+    if (len !== SEED_WORD_LIST_LENGTH_HYBRIDEDS && len !== SEED_WORD_LIST_LENGTH_HYBRIDEDMLDSASLHDSA5 && len !== SEED_WORD_LIST_LENGTH_HYBRIDEDMLDSASLHDSA) {
+        return null;
+    }
+    const seedArray = seedwords.getSeedArrayFromWordList(seedWordList);
+    if (seedArray == null || seedArray.length == null) {
+        return null;
+    }
+    return openWalletFromSeed(seedArray);
+}
+
 /**
  * The deserializeEncryptedWallet function opens a wallet backed-up using an application such as the Desktop/Mobile/CLI/Web wallet. This function can take upto a minute or so to execute. You should open wallets only from trusted sources.
  *
@@ -2982,6 +3001,7 @@ module.exports = {
     ListAccountTransactionsResponse, 
     AccountTransactionCompact,
     newWalletSeed,
+    openWalletFromSeed,
     openWalletFromSeedWords,
     publicKeyFromSignature,
     publicKeyFromPrivateKey,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quantum-coin-js-sdk",
-  "version": "1.0.30",
+  "version": "1.0.32",
   "description": "Quantum Coin - Q SDK in JavaScript",
   "main": "index.js",
   "scripts": {

package/tests/non-transactional.test.js

@@ -237,6 +237,90 @@ describe('non-transactional', () => {
     assert.equal(wallet.address.toLowerCase(), TEST_SEED_ADDRESS_36);
   });
 
+  // --- openWalletFromSeed tests (raw seed byte arrays) ---
+
+  // Hardcoded seed byte arrays derived from TEST_SEED_WORDS via seed-words.getSeedArrayFromWordList
+  const TEST_SEED_ARRAY_48 = [49,159,218,142,198,66,182,182,73,216,5,119,6,71,216,42,164,55,124,237,92,81,228,227,156,0,38,189,152,58,215,177,80,252,71,86,51,210,70,33,106,200,184,26,246,139,249,41,191,104,163,253,21,26,43,108,146,94,243,204,112,236,219,139,218,249,224,255,76,150,203,7,108,119,101,70,217,112,225,190,112,169,98,168,104,223,14,235,161,192,118,167,128,203,76,59];
+  const TEST_SEED_ARRAY_32 = [49,159,218,142,198,66,182,182,73,216,5,119,6,71,216,42,164,55,124,237,92,81,228,227,156,0,38,189,152,58,215,177,80,252,71,86,51,210,70,33,106,200,184,26,246,139,249,41,191,104,163,253,21,26,43,108,146,94,243,204,112,236,219,139];
+  const TEST_SEED_ARRAY_36 = [49,159,218,142,198,66,182,182,73,216,5,119,6,71,216,42,164,55,124,237,92,81,228,227,156,0,38,189,152,58,215,177,80,252,71,86,51,210,70,33,106,200,184,26,246,139,249,41,191,104,163,253,21,26,43,108,146,94,243,204,112,236,219,139,218,249,224,255,76,150,203,7];
+
+  test('openWalletFromSeed: 96-byte seed produces expected address (hybrideds)', () => {
+    assert.ok(isCirclAvailable(), 'CIRCL WASM must be loaded');
+    const wallet = qcsdk.openWalletFromSeed(TEST_SEED_ARRAY_48);
+    assert.ok(wallet, 'openWalletFromSeed should return a wallet for 96-byte seed');
+    assert.equal(wallet.address.toLowerCase(), TEST_SEED_ADDRESS);
+    assert.equal(qcsdk.verifyWallet(wallet), true);
+    assert.equal(qcsdk.isAddressValid(wallet.address), true);
+  });
+
+  test('openWalletFromSeed: 64-byte seed produces expected address (hybrid)', () => {
+    assert.ok(isCirclAvailable(), 'CIRCL WASM must be loaded');
+    const wallet = qcsdk.openWalletFromSeed(TEST_SEED_ARRAY_32);
+    assert.ok(wallet, 'openWalletFromSeed should return a wallet for 64-byte seed');
+    assert.equal(wallet.address.toLowerCase(), TEST_SEED_ADDRESS_32);
+    assert.equal(qcsdk.verifyWallet(wallet), true);
+    assert.equal(qcsdk.isAddressValid(wallet.address), true);
+  });
+
+  test('openWalletFromSeed: 72-byte seed produces expected address (hybrid5)', () => {
+    assert.ok(isCirclAvailable(), 'CIRCL WASM must be loaded');
+    const wallet = qcsdk.openWalletFromSeed(TEST_SEED_ARRAY_36);
+    assert.ok(wallet, 'openWalletFromSeed should return a wallet for 72-byte seed');
+    assert.equal(wallet.address.toLowerCase(), TEST_SEED_ADDRESS_36);
+    assert.equal(qcsdk.verifyWallet(wallet), true);
+    assert.equal(qcsdk.isAddressValid(wallet.address), true);
+  });
+
+  test('openWalletFromSeed: matches openWalletFromSeedWords for all three schemes', () => {
+    assert.ok(isCirclAvailable(), 'CIRCL WASM must be loaded');
+    for (const [seedArray, seedWords] of [
+      [TEST_SEED_ARRAY_48, TEST_SEED_WORDS],
+      [TEST_SEED_ARRAY_32, TEST_SEED_WORDS_32],
+      [TEST_SEED_ARRAY_36, TEST_SEED_WORDS_36],
+    ]) {
+      const fromSeed = qcsdk.openWalletFromSeed(seedArray);
+      const fromWords = qcsdk.openWalletFromSeedWords(seedWords);
+      assert.ok(fromSeed, 'openWalletFromSeed should return a wallet');
+      assert.ok(fromWords, 'openWalletFromSeedWords should return a wallet');
+      assert.equal(fromSeed.address.toLowerCase(), fromWords.address.toLowerCase());
+    }
+  });
+
+  test('openWalletFromSeed: accepts Uint8Array input', () => {
+    assert.ok(isCirclAvailable(), 'CIRCL WASM must be loaded');
+    const wallet = qcsdk.openWalletFromSeed(new Uint8Array(TEST_SEED_ARRAY_48));
+    assert.ok(wallet, 'openWalletFromSeed should accept Uint8Array');
+    assert.equal(wallet.address.toLowerCase(), TEST_SEED_ADDRESS);
+  });
+
+  test('openWalletFromSeed: null input returns null', () => {
+    assert.equal(qcsdk.openWalletFromSeed(null), null);
+  });
+
+  test('openWalletFromSeed: undefined input returns null', () => {
+    assert.equal(qcsdk.openWalletFromSeed(undefined), null);
+  });
+
+  test('openWalletFromSeed: empty array returns null', () => {
+    assert.equal(qcsdk.openWalletFromSeed([]), null);
+  });
+
+  test('openWalletFromSeed: wrong length array returns null', () => {
+    assert.equal(qcsdk.openWalletFromSeed([1, 2, 3, 4, 5]), null);
+    assert.equal(qcsdk.openWalletFromSeed(new Array(63).fill(0)), null);
+    assert.equal(qcsdk.openWalletFromSeed(new Array(65).fill(0)), null);
+    assert.equal(qcsdk.openWalletFromSeed(new Array(71).fill(0)), null);
+    assert.equal(qcsdk.openWalletFromSeed(new Array(73).fill(0)), null);
+    assert.equal(qcsdk.openWalletFromSeed(new Array(95).fill(0)), null);
+    assert.equal(qcsdk.openWalletFromSeed(new Array(97).fill(0)), null);
+  });
+
+  test('openWalletFromSeed: non-array input returns null', () => {
+    assert.equal(qcsdk.openWalletFromSeed('not an array'), null);
+    assert.equal(qcsdk.openWalletFromSeed(12345), null);
+    assert.equal(qcsdk.openWalletFromSeed({}), null);
+  });
+
   // Hardcoded encrypted wallet JSON (from openWalletFromSeedWords + serializeEncryptedWallet with SEED_WALLET_TEST_PASSPHRASE).
   // Deserialize and verify addresses match. Uses fixtures in tests/ (encrypted-48.json, encrypted-32.json, encrypted-36.json).
   test('seed words: deserializeEncryptedWallet from serialized 48/32/36 seed wallets — addresses match', () => {