@theqrl/wallet.js 0.2.2 → 1.0.1

package/dist/cjs/wallet.js

@@ -305,15 +305,17 @@ class ExtendedSeed {
   /**
    * Layout: [3 bytes descriptor] || [48 bytes seed].
    * @param {Uint8Array} bytes Exactly 51 bytes.
+   * @param {{ skipValidation?: boolean }} [options]
    * @throws {Error} If size mismatch.
    */
-  constructor(bytes) {
+  constructor(bytes, options = {}) {
     if (!bytes || bytes.length !== EXTENDED_SEED_SIZE) {
       throw new Error(`ExtendedSeed must be ${EXTENDED_SEED_SIZE} bytes`);
     }
+    const { skipValidation = false } = options;
     /** @private @type {Uint8Array} */
     this.bytes = Uint8Array.from(bytes);
-    if (!isValidWalletType(this.bytes[0])) {
+    if (!skipValidation && !isValidWalletType(this.bytes[0])) {
       throw new Error('Invalid wallet type in descriptor');
     }
   }
@@ -375,6 +377,17 @@ class ExtendedSeed {
   static from(input) {
     return new ExtendedSeed(toFixedU8(input, EXTENDED_SEED_SIZE, 'ExtendedSeed'));
   }
+
+  /**
+   * Internal helper: construct without wallet type validation.
+   * @param {string|Uint8Array|Buffer|number[]} input
+   * @returns {ExtendedSeed}
+   */
+  static fromUnchecked(input) {
+    return new ExtendedSeed(toFixedU8(input, EXTENDED_SEED_SIZE, 'ExtendedSeed'), {
+      skipValidation: true,
+    });
+  }
 }
 
 /**
@@ -4526,12 +4539,10 @@ function binToMnemonic(input) {
   for (let nibble = 0; nibble < input.length * 2; nibble += 3) {
     const p = nibble >> 1;
     const b1 = input[p];
+    /* c8 ignore next -- fallback unreachable for valid (multiple of 3) input */
     const b2 = p + 1 < input.length ? input[p + 1] : 0;
     const idx = nibble % 2 === 0 ? (b1 << 4) + (b2 >> 4) : ((b1 & 0x0f) << 8) + b2;
 
-    if (idx >= WordList.length) {
-      throw new Error('mnemonic index out of range');
-    }
     words.push(WordList[idx]);
   }
 
@@ -4732,17 +4743,22 @@ class Wallet {
 
   /** @returns {Descriptor} */
   getDescriptor() {
-    return this.descriptor;
+    return new Descriptor(this.descriptor.toBytes());
   }
 
   /** @returns {ExtendedSeed} */
   getExtendedSeed() {
-    return this.extendedSeed;
+    const bytes = this.extendedSeed.toBytes();
+    try {
+      return ExtendedSeed.from(bytes);
+    } catch {
+      return ExtendedSeed.fromUnchecked(bytes);
+    }
   }
 
   /** @returns {Seed} */
   getSeed() {
-    return this.seed;
+    return new Seed(this.seed.toBytes());
   }
 
   /** @returns {string} hex(ExtendedSeed) */
@@ -4835,6 +4851,7 @@ function newWalletFromExtendedSeed(extendedSeed) {
       return Wallet.newWalletFromExtendedSeed(ext);
     // case WalletType.SPHINCSPLUS_256S:
     //   Not yet implemented - reserved for future use
+    /* c8 ignore next 2 */
     default:
       throw new Error(`Unsupported wallet type: ${desc.type()}`);
   }

package/dist/mjs/wallet.js

@@ -303,15 +303,17 @@ class ExtendedSeed {
   /**
    * Layout: [3 bytes descriptor] || [48 bytes seed].
    * @param {Uint8Array} bytes Exactly 51 bytes.
+   * @param {{ skipValidation?: boolean }} [options]
    * @throws {Error} If size mismatch.
    */
-  constructor(bytes) {
+  constructor(bytes, options = {}) {
     if (!bytes || bytes.length !== EXTENDED_SEED_SIZE) {
       throw new Error(`ExtendedSeed must be ${EXTENDED_SEED_SIZE} bytes`);
     }
+    const { skipValidation = false } = options;
     /** @private @type {Uint8Array} */
     this.bytes = Uint8Array.from(bytes);
-    if (!isValidWalletType(this.bytes[0])) {
+    if (!skipValidation && !isValidWalletType(this.bytes[0])) {
       throw new Error('Invalid wallet type in descriptor');
     }
   }
@@ -373,6 +375,17 @@ class ExtendedSeed {
   static from(input) {
     return new ExtendedSeed(toFixedU8(input, EXTENDED_SEED_SIZE, 'ExtendedSeed'));
   }
+
+  /**
+   * Internal helper: construct without wallet type validation.
+   * @param {string|Uint8Array|Buffer|number[]} input
+   * @returns {ExtendedSeed}
+   */
+  static fromUnchecked(input) {
+    return new ExtendedSeed(toFixedU8(input, EXTENDED_SEED_SIZE, 'ExtendedSeed'), {
+      skipValidation: true,
+    });
+  }
 }
 
 /**
@@ -4524,12 +4537,10 @@ function binToMnemonic(input) {
   for (let nibble = 0; nibble < input.length * 2; nibble += 3) {
     const p = nibble >> 1;
     const b1 = input[p];
+    /* c8 ignore next -- fallback unreachable for valid (multiple of 3) input */
     const b2 = p + 1 < input.length ? input[p + 1] : 0;
     const idx = nibble % 2 === 0 ? (b1 << 4) + (b2 >> 4) : ((b1 & 0x0f) << 8) + b2;
 
-    if (idx >= WordList.length) {
-      throw new Error('mnemonic index out of range');
-    }
     words.push(WordList[idx]);
   }
 
@@ -4730,17 +4741,22 @@ class Wallet {
 
   /** @returns {Descriptor} */
   getDescriptor() {
-    return this.descriptor;
+    return new Descriptor(this.descriptor.toBytes());
   }
 
   /** @returns {ExtendedSeed} */
   getExtendedSeed() {
-    return this.extendedSeed;
+    const bytes = this.extendedSeed.toBytes();
+    try {
+      return ExtendedSeed.from(bytes);
+    } catch {
+      return ExtendedSeed.fromUnchecked(bytes);
+    }
   }
 
   /** @returns {Seed} */
   getSeed() {
-    return this.seed;
+    return new Seed(this.seed.toBytes());
   }
 
   /** @returns {string} hex(ExtendedSeed) */
@@ -4833,6 +4849,7 @@ function newWalletFromExtendedSeed(extendedSeed) {
       return Wallet.newWalletFromExtendedSeed(ext);
     // case WalletType.SPHINCSPLUS_256S:
     //   Not yet implemented - reserved for future use
+    /* c8 ignore next 2 */
     default:
       throw new Error(`Unsupported wallet type: ${desc.type()}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theqrl/wallet.js",
-  "version": "0.2.2",
+  "version": "1.0.1",
   "description": "Quantum-resistant wallet library for The QRL using ML-DSA-87 (FIPS 204)",
   "type": "module",
   "main": "dist/cjs/wallet.js",
@@ -49,6 +49,7 @@
     "@types/node": "^20.14.12",
     "c8": "^7.13.0",
     "chai": "^4.3.7",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
     "eslint": "^8.37.0",
     "eslint-config-airbnb": "^19.0.4",
     "eslint-config-prettier": "^8.8.0",

package/src/wallet/common/seed.js

@@ -48,15 +48,17 @@ class ExtendedSeed {
   /**
    * Layout: [3 bytes descriptor] || [48 bytes seed].
    * @param {Uint8Array} bytes Exactly 51 bytes.
+   * @param {{ skipValidation?: boolean }} [options]
    * @throws {Error} If size mismatch.
    */
-  constructor(bytes) {
+  constructor(bytes, options = {}) {
     if (!bytes || bytes.length !== EXTENDED_SEED_SIZE) {
       throw new Error(`ExtendedSeed must be ${EXTENDED_SEED_SIZE} bytes`);
     }
+    const { skipValidation = false } = options;
     /** @private @type {Uint8Array} */
     this.bytes = Uint8Array.from(bytes);
-    if (!isValidWalletType(this.bytes[0])) {
+    if (!skipValidation && !isValidWalletType(this.bytes[0])) {
       throw new Error('Invalid wallet type in descriptor');
     }
   }
@@ -118,6 +120,17 @@ class ExtendedSeed {
   static from(input) {
     return new ExtendedSeed(toFixedU8(input, EXTENDED_SEED_SIZE, 'ExtendedSeed'));
   }
+
+  /**
+   * Internal helper: construct without wallet type validation.
+   * @param {string|Uint8Array|Buffer|number[]} input
+   * @returns {ExtendedSeed}
+   */
+  static fromUnchecked(input) {
+    return new ExtendedSeed(toFixedU8(input, EXTENDED_SEED_SIZE, 'ExtendedSeed'), {
+      skipValidation: true,
+    });
+  }
 }
 
 export { Seed, ExtendedSeed };

package/src/wallet/factory.js

@@ -31,6 +31,7 @@ function newWalletFromExtendedSeed(extendedSeed) {
       return MLDSA87.newWalletFromExtendedSeed(ext);
     // case WalletType.SPHINCSPLUS_256S:
     //   Not yet implemented - reserved for future use
+    /* c8 ignore next 2 */
     default:
       throw new Error(`Unsupported wallet type: ${desc.type()}`);
   }

package/src/wallet/misc/mnemonic.js

@@ -24,12 +24,10 @@ function binToMnemonic(input) {
   for (let nibble = 0; nibble < input.length * 2; nibble += 3) {
     const p = nibble >> 1;
     const b1 = input[p];
+    /* c8 ignore next -- fallback unreachable for valid (multiple of 3) input */
     const b2 = p + 1 < input.length ? input[p + 1] : 0;
     const idx = nibble % 2 === 0 ? (b1 << 4) + (b2 >> 4) : ((b1 & 0x0f) << 8) + b2;
 
-    if (idx >= WordList.length) {
-      throw new Error('mnemonic index out of range');
-    }
     words.push(WordList[idx]);
   }
 

package/src/wallet/ml_dsa_87/wallet.js

@@ -8,6 +8,7 @@ import randomBytes from 'randombytes';
 import { bytesToHex } from '@noble/hashes/utils.js';
 import { mnemonicToBin, binToMnemonic } from '../misc/mnemonic.js';
 import { getAddressFromPKAndDescriptor, addressToString } from '../common/address.js';
+import { Descriptor } from '../common/descriptor.js';
 import { Seed, ExtendedSeed } from '../common/seed.js';
 import { newMLDSA87Descriptor } from './descriptor.js';
 import { keygen, sign, verify } from './crypto.js';
@@ -81,17 +82,22 @@ class Wallet {
 
   /** @returns {Descriptor} */
   getDescriptor() {
-    return this.descriptor;
+    return new Descriptor(this.descriptor.toBytes());
   }
 
   /** @returns {ExtendedSeed} */
   getExtendedSeed() {
-    return this.extendedSeed;
+    const bytes = this.extendedSeed.toBytes();
+    try {
+      return ExtendedSeed.from(bytes);
+    } catch {
+      return ExtendedSeed.fromUnchecked(bytes);
+    }
   }
 
   /** @returns {Seed} */
   getSeed() {
-    return this.seed;
+    return new Seed(this.seed.toBytes());
   }
 
   /** @returns {string} hex(ExtendedSeed) */