@theqrl/wallet.js 1.0.0 → 1.0.2

package/README.md

@@ -1,5 +1,6 @@
 # wallet.js
 
+[![npm version](https://img.shields.io/npm/v/@theqrl/wallet.js.svg)](https://www.npmjs.com/package/@theqrl/wallet.js)
 ![test](https://github.com/theQRL/wallet.js/actions/workflows/test.yml/badge.svg)
 [![codecov](https://codecov.io/gh/theQRL/wallet.js/branch/main/graph/badge.svg?token=HHVBFBVGFR)](https://codecov.io/gh/theQRL/wallet.js)
 
@@ -196,5 +197,5 @@ This library currently supports **ML-DSA-87** (FIPS 204), the NIST standardized
 - `randombytes` - Secure random generation
 
 ## License
-
+[MIT](LICENSE)
 MIT

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,
+    });
+  }
 }
 
 /**
@@ -4730,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) */

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,
+    });
+  }
 }
 
 /**
@@ -4728,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) */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theqrl/wallet.js",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Quantum-resistant wallet library for The QRL using ML-DSA-87 (FIPS 204)",
   "type": "module",
   "main": "dist/cjs/wallet.js",
@@ -30,7 +30,7 @@
   },
   "dependencies": {
     "@noble/hashes": "^1.8.0",
-    "@theqrl/mldsa87": "^1.0.3",
+    "@theqrl/mldsa87": "^1.0.5",
     "randombytes": "^2.1.0"
   },
   "directories": {

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/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) */