@xyo-network/quant-wallet 6.0.3

package/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

package/README.md

@@ -0,0 +1,26 @@
+# @xyo-network/quant-wallet
+
+Quantum-resistant HD Wallet that implements `WalletInstance` using **ML-DSA-65** (FIPS 204) signing and **BIP-85** entropy derivation.
+
+A classical BIP-32/BIP-39 spine (via `ethers.HDNodeWallet`) walks the hierarchy; at every node, BIP-85 derives a deterministic 32-byte seed (`HMAC-SHA512("bip-entropy-from-k", node.privateKey)[0..32]`) that becomes the input to `MlDsa.keygen(seed)`. The result is a deterministic, hierarchical post-quantum identity reproducible from a single BIP-39 mnemonic.
+
+Addresses are prefixed with `qr1_` so the BoundWitness validator dispatches to the ML-DSA verifier registered by `@xyo-network/quant-account`.
+
+## Usage
+
+```ts
+import { QuantHDWallet } from '@xyo-network/quant-wallet'
+
+const wallet = await QuantHDWallet.fromPhrase('abandon abandon ... abandon abandon about')
+console.log(wallet.address)        // 'qr1_<40 hex chars>'
+console.log(wallet.algorithm)      // 'ml-dsa-65'
+
+const child = await wallet.derivePath("m/44'/60'/0'/0/0")
+const [signature] = await child.sign(hashBytes)
+```
+
+## Notes
+
+- `derivePath` accepts either a classical BIP-32 path (entropy comes from the implicit BIP-85 leaf tail) or an explicit BIP-85 path beginning with `m/83696968'/`.
+- `neuter()` is not supported — ML-DSA-65 has no standardized public-key-only HD derivation.
+- `signJwt` is not implemented — no IANA JOSE `alg` for ML-DSA-65 is finalized yet.

package/dist/browser/QuantHDWallet.d.ts

@@ -0,0 +1,46 @@
+import type { Address, Hash, Hex } from '@xylabs/sdk-js';
+import type { AccountAlgorithm, AccountConfig, AccountInstance, SignJwtOptions, SignJwtResult } from '@xyo-network/account-model';
+import type { WalletInstance } from '@xyo-network/wallet-model';
+import { HDNodeWallet, Mnemonic } from 'ethers';
+export declare class QuantHDWallet implements WalletInstance {
+    private static _protectedConstructorKey;
+    private static _walletAddressMap;
+    readonly algorithm: AccountAlgorithm;
+    protected readonly _account: AccountInstance;
+    protected readonly _master: HDNodeWallet | undefined;
+    protected readonly _seed: Uint8Array;
+    protected readonly node: HDNodeWallet;
+    protected constructor(key: unknown, node: HDNodeWallet, master: HDNodeWallet | undefined, seed: Uint8Array, account: AccountInstance);
+    get address(): Address;
+    get addressBytes(): ArrayBufferLike;
+    get chainCode(): string;
+    get depth(): number;
+    get extendedKey(): string;
+    get fingerprint(): string;
+    get index(): number;
+    get mnemonic(): Mnemonic | null;
+    get parentFingerprint(): string;
+    get path(): string | null;
+    get previousHash(): Hash | undefined;
+    set previousHash(_value: Hash | undefined);
+    get previousHashBytes(): ArrayBufferLike | undefined;
+    set previousHashBytes(_value: ArrayBufferLike | undefined);
+    get privateKey(): Hex;
+    get publicKey(): Hex;
+    static create(opts?: AccountConfig): Promise<WalletInstance>;
+    static fromExtendedKey(key: string): Promise<WalletInstance>;
+    static fromMnemonic(mnemonic: Mnemonic, path?: string): Promise<WalletInstance>;
+    static fromPhrase(phrase: string, path?: string): Promise<WalletInstance>;
+    static fromPrivateKey(_key: ArrayBufferLike | bigint | string): Promise<AccountInstance>;
+    static fromSeed(seed: string | ArrayBufferLike): Promise<WalletInstance>;
+    static generateMnemonic(wordlist?: string[], strength?: number): string;
+    static random(): Promise<WalletInstance>;
+    protected static createFromNode(node: HDNodeWallet, master?: HDNodeWallet, previousHash?: string): Promise<WalletInstance>;
+    derivePath(path: string): Promise<WalletInstance>;
+    neuter: () => WalletInstance;
+    sign(hash: ArrayBufferLike, previousHash?: ArrayBufferLike): Promise<[ArrayBufferLike, Hash?]>;
+    signJwt(options: SignJwtOptions): Promise<SignJwtResult>;
+    verify(msg: ArrayBufferLike, signature: ArrayBufferLike): Promise<boolean>;
+    verifyUniqueWallet(): WalletInstance;
+}
+//# sourceMappingURL=QuantHDWallet.d.ts.map

package/dist/browser/QuantHDWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuantHDWallet.d.ts","sourceRoot":"","sources":["../../src/QuantHDWallet.ts"],"names":[],"mappings":"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"}

package/dist/browser/bip85.d.ts

@@ -0,0 +1,10 @@
+import type { HDNodeWallet } from 'ethers';
+export declare const BIP85_PURPOSE = "83696968'";
+export declare const BIP85_HEX_APP = "128169'";
+export declare const BIP85_HMAC_KEY = "bip-entropy-from-k";
+export declare const BIP85_SEED_LENGTH = 32;
+export declare function bip85DefaultLeafTail(index?: number): string;
+export declare function isBip85AbsolutePath(path: string): boolean;
+export declare function isUnderBip85Purpose(node: HDNodeWallet): boolean;
+export declare function bip85EntropyFromNode(node: HDNodeWallet): Uint8Array;
+//# sourceMappingURL=bip85.d.ts.map

package/dist/browser/bip85.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bip85.d.ts","sourceRoot":"","sources":["../../src/bip85.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAK1C,eAAO,MAAM,aAAa,cAAc,CAAA;AACxC,eAAO,MAAM,aAAa,YAAY,CAAA;AACtC,eAAO,MAAM,cAAc,uBAAuB,CAAA;AAClD,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC,wBAAgB,oBAAoB,CAAC,KAAK,SAAI,GAAG,MAAM,CAEtD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAI/D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CAKnE"}

package/dist/browser/index.d.ts

@@ -0,0 +1,3 @@
+export * from './bip85.ts';
+export * from './QuantHDWallet.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA"}

package/dist/browser/index.mjs

@@ -0,0 +1,230 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/bip85.ts
+import {
+  computeHmac,
+  getBytes,
+  toUtf8Bytes
+} from "ethers";
+var BIP85_PURPOSE = "83696968'";
+var BIP85_HEX_APP = "128169'";
+var BIP85_HMAC_KEY = "bip-entropy-from-k";
+var BIP85_SEED_LENGTH = 32;
+function bip85DefaultLeafTail(index = 0) {
+  return `${BIP85_PURPOSE}/${BIP85_HEX_APP}/32'/${index}'`;
+}
+function isBip85AbsolutePath(path) {
+  return path.startsWith(`m/${BIP85_PURPOSE}/`);
+}
+function isUnderBip85Purpose(node) {
+  const p = node.path;
+  if (p === null) return false;
+  return p === `m/${BIP85_PURPOSE}` || p.startsWith(`m/${BIP85_PURPOSE}/`);
+}
+function bip85EntropyFromNode(node) {
+  const key = toUtf8Bytes(BIP85_HMAC_KEY);
+  const msg = getBytes(node.privateKey);
+  const hmac = computeHmac("sha512", key, msg);
+  return getBytes(hmac).slice(0, BIP85_SEED_LENGTH);
+}
+
+// src/QuantHDWallet.ts
+import { generateMnemonic } from "@scure/bip39";
+import { wordlist as englishWordlist } from "@scure/bip39/wordlists/english.js";
+import {
+  hexFromArrayBuffer,
+  staticImplements,
+  toUint8Array
+} from "@xylabs/sdk-js";
+import {
+  isMnemonicInitializationConfig,
+  isPhraseInitializationConfig,
+  isPrivateKeyInitializationConfig
+} from "@xyo-network/account-model";
+import { QuantAccount } from "@xyo-network/quant-account";
+import {
+  defaultPath,
+  HDNodeWallet,
+  Mnemonic
+} from "ethers";
+var QuantHDWallet = class {
+  algorithm = "ml-dsa-65";
+  _account;
+  _master;
+  _seed;
+  node;
+  constructor(key, node, master, seed, account) {
+    if (key !== QuantHDWallet._protectedConstructorKey) {
+      throw new Error("Do not call this protected constructor");
+    }
+    this.node = node;
+    this._master = master;
+    this._seed = seed;
+    this._account = account;
+  }
+  get address() {
+    return this._account.address;
+  }
+  get addressBytes() {
+    return this._account.addressBytes;
+  }
+  get chainCode() {
+    return this.node.chainCode;
+  }
+  get depth() {
+    return this.node.depth;
+  }
+  get extendedKey() {
+    return this.node.extendedKey;
+  }
+  get fingerprint() {
+    return this.node.fingerprint;
+  }
+  get index() {
+    return this.node.index;
+  }
+  get mnemonic() {
+    return this.node.mnemonic;
+  }
+  get parentFingerprint() {
+    return this.node.parentFingerprint;
+  }
+  get path() {
+    return this.node.path;
+  }
+  get previousHash() {
+    return this._account.previousHash;
+  }
+  set previousHash(_value) {
+  }
+  get previousHashBytes() {
+    return this._account.previousHashBytes;
+  }
+  set previousHashBytes(_value) {
+  }
+  get privateKey() {
+    return hexFromArrayBuffer(this._seed.buffer, { prefix: false }).toLowerCase();
+  }
+  get publicKey() {
+    const bytes = this._account.publicKey;
+    return hexFromArrayBuffer(bytes, { prefix: false }).toLowerCase();
+  }
+  static async create(opts) {
+    if (isPhraseInitializationConfig(opts)) {
+      return await this.fromPhrase(opts.phrase);
+    }
+    if (isMnemonicInitializationConfig(opts)) {
+      return await this.fromPhrase(opts.mnemonic, opts.path);
+    }
+    if (isPrivateKeyInitializationConfig(opts)) {
+      throw new Error("Invalid initialization config. from privateKey not supported. Use QuantAccount.fromPrivateKey instead.");
+    }
+    throw new Error("Invalid initialization config");
+  }
+  static async fromExtendedKey(key) {
+    const node = HDNodeWallet.fromExtendedKey(key);
+    const master = node.depth === 0 ? node : void 0;
+    return await this.createFromNode(node, master);
+  }
+  static async fromMnemonic(mnemonic, path = defaultPath) {
+    const master = HDNodeWallet.fromMnemonic(mnemonic, "m");
+    const node = path === "m" || path === "m/" ? master : master.derivePath(path.startsWith("m/") ? path.slice(2) : path);
+    return await this.createFromNode(node, master);
+  }
+  static async fromPhrase(phrase, path = defaultPath) {
+    return await this.fromMnemonic(Mnemonic.fromPhrase(phrase), path);
+  }
+  static async fromPrivateKey(_key) {
+    return await Promise.reject(new Error("fromPrivateKey is not supported on QuantHDWallet \u2014 use fromSeed, fromPhrase, fromMnemonic, or fromExtendedKey"));
+  }
+  static async fromSeed(seed) {
+    const master = HDNodeWallet.fromSeed(toUint8Array(seed));
+    return await this.createFromNode(master, master);
+  }
+  static generateMnemonic(wordlist = englishWordlist, strength = 256) {
+    return generateMnemonic(wordlist, strength);
+  }
+  static async random() {
+    return await this.fromPhrase(QuantHDWallet.generateMnemonic());
+  }
+  static async createFromNode(node, master, previousHash) {
+    const leafNode = isUnderBip85Purpose(node) ? node : node.derivePath(bip85DefaultLeafTail(0));
+    const seed = bip85EntropyFromNode(leafNode);
+    const account = await QuantAccount.create({
+      privateKey: seed.buffer,
+      previousHash: previousHash === void 0 ? void 0 : toUint8Array(previousHash, 32).buffer
+    });
+    const wallet = new QuantHDWallet(QuantHDWallet._protectedConstructorKey, node, master, seed, account);
+    return wallet.verifyUniqueWallet();
+  }
+  async derivePath(path) {
+    if (path.startsWith("m/")) {
+      if (isBip85AbsolutePath(path)) {
+        if (this._master === void 0) {
+          throw new Error("Cannot derive BIP-85 absolute path: wallet has no master node (built from extended key)");
+        }
+        const childNode = this._master.derivePath(path.slice(2));
+        return await QuantHDWallet.createFromNode(childNode, this._master);
+      }
+      const parentPath = this.path;
+      if (parentPath !== null && path.startsWith(parentPath)) {
+        const childPath = path.slice(parentPath.length + 1);
+        return await QuantHDWallet.createFromNode(this.node.derivePath(childPath), this._master);
+      }
+      if (this._master !== void 0) {
+        return await QuantHDWallet.createFromNode(this._master.derivePath(path.slice(2)), this._master);
+      }
+      throw new Error(`Invalid absolute path ${path} for wallet with path ${parentPath}`);
+    }
+    return await QuantHDWallet.createFromNode(this.node.derivePath(path), this._master);
+  }
+  neuter = () => {
+    throw new Error("neuter() is not implemented for ml-dsa-65 HD wallets");
+  };
+  async sign(hash, previousHash) {
+    return await this._account.sign(hash, previousHash);
+  }
+  async signJwt(options) {
+    return await this._account.signJwt(options);
+  }
+  async verify(msg, signature) {
+    return await this._account.verify(msg, signature);
+  }
+  verifyUniqueWallet() {
+    const address = this.address;
+    const existing = QuantHDWallet._walletAddressMap[address]?.deref();
+    if (existing === void 0) {
+      QuantHDWallet._walletAddressMap[address] = new WeakRef(this);
+      return this;
+    }
+    return existing;
+  }
+};
+__publicField(QuantHDWallet, "_protectedConstructorKey", /* @__PURE__ */ Symbol());
+__publicField(QuantHDWallet, "_walletAddressMap", {});
+QuantHDWallet = __decorateClass([
+  staticImplements()
+], QuantHDWallet);
+export {
+  BIP85_HEX_APP,
+  BIP85_HMAC_KEY,
+  BIP85_PURPOSE,
+  BIP85_SEED_LENGTH,
+  QuantHDWallet,
+  bip85DefaultLeafTail,
+  bip85EntropyFromNode,
+  isBip85AbsolutePath,
+  isUnderBip85Purpose
+};
+//# sourceMappingURL=index.mjs.map

package/dist/browser/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/bip85.ts", "../../src/QuantHDWallet.ts"],
+  "sourcesContent": ["import type { HDNodeWallet } from 'ethers'\nimport {\n  computeHmac, getBytes, toUtf8Bytes,\n} from 'ethers'\n\nexport const BIP85_PURPOSE = \"83696968'\"\nexport const BIP85_HEX_APP = \"128169'\"\nexport const BIP85_HMAC_KEY = 'bip-entropy-from-k'\nexport const BIP85_SEED_LENGTH = 32\n\nexport function bip85DefaultLeafTail(index = 0): string {\n  return `${BIP85_PURPOSE}/${BIP85_HEX_APP}/32'/${index}'`\n}\n\nexport function isBip85AbsolutePath(path: string): boolean {\n  return path.startsWith(`m/${BIP85_PURPOSE}/`)\n}\n\nexport function isUnderBip85Purpose(node: HDNodeWallet): boolean {\n  const p = node.path\n  if (p === null) return false\n  return p === `m/${BIP85_PURPOSE}` || p.startsWith(`m/${BIP85_PURPOSE}/`)\n}\n\nexport function bip85EntropyFromNode(node: HDNodeWallet): Uint8Array {\n  const key = toUtf8Bytes(BIP85_HMAC_KEY)\n  const msg = getBytes(node.privateKey)\n  const hmac = computeHmac('sha512', key, msg)\n  return getBytes(hmac).slice(0, BIP85_SEED_LENGTH)\n}\n", "import { generateMnemonic } from '@scure/bip39'\nimport { wordlist as englishWordlist } from '@scure/bip39/wordlists/english.js'\nimport type {\n  Address, Hash, Hex,\n} from '@xylabs/sdk-js'\nimport {\n  hexFromArrayBuffer, staticImplements, toUint8Array,\n} from '@xylabs/sdk-js'\nimport type {\n  AccountAlgorithm,\n  AccountConfig, AccountInstance, SignJwtOptions, SignJwtResult,\n} from '@xyo-network/account-model'\nimport {\n  isMnemonicInitializationConfig,\n  isPhraseInitializationConfig,\n  isPrivateKeyInitializationConfig,\n} from '@xyo-network/account-model'\nimport { QuantAccount } from '@xyo-network/quant-account'\nimport type { WalletInstance, WalletStatic } from '@xyo-network/wallet-model'\nimport {\n  defaultPath, HDNodeWallet, Mnemonic,\n} from 'ethers'\n\nimport {\n  bip85DefaultLeafTail,\n  bip85EntropyFromNode,\n  isBip85AbsolutePath,\n  isUnderBip85Purpose,\n} from './bip85.ts'\n\n@staticImplements<WalletStatic<WalletInstance>>()\nexport class QuantHDWallet implements WalletInstance {\n  private static _protectedConstructorKey = Symbol()\n  private static _walletAddressMap: Record<string, WeakRef<WalletInstance>> = {}\n\n  readonly algorithm: AccountAlgorithm = 'ml-dsa-65'\n\n  protected readonly _account: AccountInstance\n  protected readonly _master: HDNodeWallet | undefined\n  protected readonly _seed: Uint8Array\n  protected readonly node: HDNodeWallet\n\n  protected constructor(\n    key: unknown,\n    node: HDNodeWallet,\n    master: HDNodeWallet | undefined,\n    seed: Uint8Array,\n    account: AccountInstance,\n  ) {\n    if (key !== QuantHDWallet._protectedConstructorKey) {\n      throw new Error('Do not call this protected constructor')\n    }\n    this.node = node\n    this._master = master\n    this._seed = seed\n    this._account = account\n  }\n\n  get address(): Address {\n    return this._account.address\n  }\n\n  get addressBytes(): ArrayBufferLike {\n    return this._account.addressBytes\n  }\n\n  get chainCode(): string {\n    return this.node.chainCode\n  }\n\n  get depth(): number {\n    return this.node.depth\n  }\n\n  get extendedKey(): string {\n    return this.node.extendedKey\n  }\n\n  get fingerprint(): string {\n    return this.node.fingerprint\n  }\n\n  get index(): number {\n    return this.node.index\n  }\n\n  get mnemonic(): Mnemonic | null {\n    return this.node.mnemonic\n  }\n\n  get parentFingerprint(): string {\n    return this.node.parentFingerprint\n  }\n\n  get path(): string | null {\n    return this.node.path\n  }\n\n  get previousHash(): Hash | undefined {\n    return this._account.previousHash\n  }\n\n  set previousHash(_value: Hash | undefined) {\n    // intentionally not supported \u2014 use sign() chaining\n  }\n\n  get previousHashBytes(): ArrayBufferLike | undefined {\n    return this._account.previousHashBytes\n  }\n\n  set previousHashBytes(_value: ArrayBufferLike | undefined) {\n    // intentionally not supported \u2014 use sign() chaining\n  }\n\n  get privateKey(): Hex {\n    return hexFromArrayBuffer(this._seed.buffer, { prefix: false }).toLowerCase() as Hex\n  }\n\n  get publicKey(): Hex {\n    const bytes = (this._account as unknown as { publicKey: ArrayBufferLike }).publicKey\n    return hexFromArrayBuffer(bytes, { prefix: false }).toLowerCase() as Hex\n  }\n\n  static async create(opts?: AccountConfig): Promise<WalletInstance> {\n    if (isPhraseInitializationConfig(opts)) {\n      return await this.fromPhrase(opts.phrase)\n    }\n    if (isMnemonicInitializationConfig(opts)) {\n      return await this.fromPhrase(opts.mnemonic, opts.path)\n    }\n    if (isPrivateKeyInitializationConfig(opts)) {\n      throw new Error('Invalid initialization config. from privateKey not supported. Use QuantAccount.fromPrivateKey instead.')\n    }\n    throw new Error('Invalid initialization config')\n  }\n\n  static async fromExtendedKey(key: string): Promise<WalletInstance> {\n    const node = HDNodeWallet.fromExtendedKey(key) as HDNodeWallet\n    // If the xkey is the root (depth 0), it is its own master and absolute BIP-85 paths can be resolved\n    const master = node.depth === 0 ? node : undefined\n    return await this.createFromNode(node, master)\n  }\n\n  static async fromMnemonic(mnemonic: Mnemonic, path: string = defaultPath): Promise<WalletInstance> {\n    // Pass 'm' explicitly: without it, ethers returns the node at defaultPath rather than the BIP-32 root.\n    const master = HDNodeWallet.fromMnemonic(mnemonic, 'm')\n    const node = path === 'm' || path === 'm/' ? master : master.derivePath(path.startsWith('m/') ? path.slice(2) : path)\n    return await this.createFromNode(node, master)\n  }\n\n  static async fromPhrase(phrase: string, path: string = defaultPath): Promise<WalletInstance> {\n    return await this.fromMnemonic(Mnemonic.fromPhrase(phrase), path)\n  }\n\n  static async fromPrivateKey(_key: ArrayBufferLike | bigint | string): Promise<AccountInstance> {\n    return await Promise.reject(new Error('fromPrivateKey is not supported on QuantHDWallet \u2014 use fromSeed, fromPhrase, fromMnemonic, or fromExtendedKey'))\n  }\n\n  static async fromSeed(seed: string | ArrayBufferLike): Promise<WalletInstance> {\n    const master = HDNodeWallet.fromSeed(toUint8Array(seed))\n    return await this.createFromNode(master, master)\n  }\n\n  static generateMnemonic(wordlist: string[] = englishWordlist, strength = 256): string {\n    return generateMnemonic(wordlist, strength)\n  }\n\n  static async random(): Promise<WalletInstance> {\n    return await this.fromPhrase(QuantHDWallet.generateMnemonic())\n  }\n\n  protected static async createFromNode(\n    node: HDNodeWallet,\n    master?: HDNodeWallet,\n    previousHash?: string,\n  ): Promise<WalletInstance> {\n    // If the node is already under the BIP-85 purpose subtree, take entropy right there.\n    // Otherwise auto-descend to the default HEX-entropy leaf (num_bytes=32, index=0).\n    const leafNode = isUnderBip85Purpose(node) ? node : node.derivePath(bip85DefaultLeafTail(0))\n    const seed = bip85EntropyFromNode(leafNode)\n    const account = await QuantAccount.create({\n      privateKey: seed.buffer,\n      previousHash: previousHash === undefined ? undefined : toUint8Array(previousHash, 32).buffer,\n    })\n    const wallet = new QuantHDWallet(QuantHDWallet._protectedConstructorKey, node, master, seed, account)\n    return wallet.verifyUniqueWallet()\n  }\n\n  async derivePath(path: string): Promise<WalletInstance> {\n    if (path.startsWith('m/')) {\n      if (isBip85AbsolutePath(path)) {\n        if (this._master === undefined) {\n          throw new Error('Cannot derive BIP-85 absolute path: wallet has no master node (built from extended key)')\n        }\n        const childNode = this._master.derivePath(path.slice(2))\n        return await QuantHDWallet.createFromNode(childNode, this._master)\n      }\n      const parentPath = this.path\n      if (parentPath !== null && path.startsWith(parentPath)) {\n        const childPath = path.slice(parentPath.length + 1)\n        return await QuantHDWallet.createFromNode(this.node.derivePath(childPath), this._master)\n      }\n      if (this._master !== undefined) {\n        return await QuantHDWallet.createFromNode(this._master.derivePath(path.slice(2)), this._master)\n      }\n      throw new Error(`Invalid absolute path ${path} for wallet with path ${parentPath}`)\n    }\n    return await QuantHDWallet.createFromNode(this.node.derivePath(path), this._master)\n  }\n\n  neuter: () => WalletInstance = () => {\n    throw new Error('neuter() is not implemented for ml-dsa-65 HD wallets')\n  }\n\n  async sign(hash: ArrayBufferLike, previousHash?: ArrayBufferLike): Promise<[ArrayBufferLike, Hash?]> {\n    return await this._account.sign(hash, previousHash)\n  }\n\n  async signJwt(options: SignJwtOptions): Promise<SignJwtResult> {\n    return await this._account.signJwt(options)\n  }\n\n  async verify(msg: ArrayBufferLike, signature: ArrayBufferLike): Promise<boolean> {\n    return await this._account.verify(msg, signature)\n  }\n\n  verifyUniqueWallet(): WalletInstance {\n    const address = this.address\n    const existing = QuantHDWallet._walletAddressMap[address]?.deref()\n    if (existing === undefined) {\n      QuantHDWallet._walletAddressMap[address] = new WeakRef<WalletInstance>(this)\n      return this\n    }\n    return existing\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/neutral/QuantHDWallet.d.ts

@@ -0,0 +1,46 @@
+import type { Address, Hash, Hex } from '@xylabs/sdk-js';
+import type { AccountAlgorithm, AccountConfig, AccountInstance, SignJwtOptions, SignJwtResult } from '@xyo-network/account-model';
+import type { WalletInstance } from '@xyo-network/wallet-model';
+import { HDNodeWallet, Mnemonic } from 'ethers';
+export declare class QuantHDWallet implements WalletInstance {
+    private static _protectedConstructorKey;
+    private static _walletAddressMap;
+    readonly algorithm: AccountAlgorithm;
+    protected readonly _account: AccountInstance;
+    protected readonly _master: HDNodeWallet | undefined;
+    protected readonly _seed: Uint8Array;
+    protected readonly node: HDNodeWallet;
+    protected constructor(key: unknown, node: HDNodeWallet, master: HDNodeWallet | undefined, seed: Uint8Array, account: AccountInstance);
+    get address(): Address;
+    get addressBytes(): ArrayBufferLike;
+    get chainCode(): string;
+    get depth(): number;
+    get extendedKey(): string;
+    get fingerprint(): string;
+    get index(): number;
+    get mnemonic(): Mnemonic | null;
+    get parentFingerprint(): string;
+    get path(): string | null;
+    get previousHash(): Hash | undefined;
+    set previousHash(_value: Hash | undefined);
+    get previousHashBytes(): ArrayBufferLike | undefined;
+    set previousHashBytes(_value: ArrayBufferLike | undefined);
+    get privateKey(): Hex;
+    get publicKey(): Hex;
+    static create(opts?: AccountConfig): Promise<WalletInstance>;
+    static fromExtendedKey(key: string): Promise<WalletInstance>;
+    static fromMnemonic(mnemonic: Mnemonic, path?: string): Promise<WalletInstance>;
+    static fromPhrase(phrase: string, path?: string): Promise<WalletInstance>;
+    static fromPrivateKey(_key: ArrayBufferLike | bigint | string): Promise<AccountInstance>;
+    static fromSeed(seed: string | ArrayBufferLike): Promise<WalletInstance>;
+    static generateMnemonic(wordlist?: string[], strength?: number): string;
+    static random(): Promise<WalletInstance>;
+    protected static createFromNode(node: HDNodeWallet, master?: HDNodeWallet, previousHash?: string): Promise<WalletInstance>;
+    derivePath(path: string): Promise<WalletInstance>;
+    neuter: () => WalletInstance;
+    sign(hash: ArrayBufferLike, previousHash?: ArrayBufferLike): Promise<[ArrayBufferLike, Hash?]>;
+    signJwt(options: SignJwtOptions): Promise<SignJwtResult>;
+    verify(msg: ArrayBufferLike, signature: ArrayBufferLike): Promise<boolean>;
+    verifyUniqueWallet(): WalletInstance;
+}
+//# sourceMappingURL=QuantHDWallet.d.ts.map

package/dist/neutral/QuantHDWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuantHDWallet.d.ts","sourceRoot":"","sources":["../../src/QuantHDWallet.ts"],"names":[],"mappings":"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"}

package/dist/neutral/bip85.d.ts

@@ -0,0 +1,10 @@
+import type { HDNodeWallet } from 'ethers';
+export declare const BIP85_PURPOSE = "83696968'";
+export declare const BIP85_HEX_APP = "128169'";
+export declare const BIP85_HMAC_KEY = "bip-entropy-from-k";
+export declare const BIP85_SEED_LENGTH = 32;
+export declare function bip85DefaultLeafTail(index?: number): string;
+export declare function isBip85AbsolutePath(path: string): boolean;
+export declare function isUnderBip85Purpose(node: HDNodeWallet): boolean;
+export declare function bip85EntropyFromNode(node: HDNodeWallet): Uint8Array;
+//# sourceMappingURL=bip85.d.ts.map

package/dist/neutral/bip85.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bip85.d.ts","sourceRoot":"","sources":["../../src/bip85.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAK1C,eAAO,MAAM,aAAa,cAAc,CAAA;AACxC,eAAO,MAAM,aAAa,YAAY,CAAA;AACtC,eAAO,MAAM,cAAc,uBAAuB,CAAA;AAClD,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC,wBAAgB,oBAAoB,CAAC,KAAK,SAAI,GAAG,MAAM,CAEtD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAI/D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CAKnE"}

package/dist/neutral/index.d.ts

@@ -0,0 +1,3 @@
+export * from './bip85.ts';
+export * from './QuantHDWallet.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA"}