@xyo-network/wallet 2.62.2 → 3.14.8

package/README.md

@@ -1,6 +1,6 @@
 [![logo][]](https://xyo.network)
 
-Part of [sdk-xyo-clint-js](https://www.npmjs.com/package/@xyo-network/sdk-xyo-client-js)
+Part of [sdk-xyo-client-js](https://www.npmjs.com/package/@xyo-network/sdk-xyo-client-js)
 
 ## License
 

package/dist/browser/index.mjs

@@ -0,0 +1,153 @@
+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/HDWallet.ts
+import { generateMnemonic } from "@scure/bip39";
+import { wordlist as englishWordlist } from "@scure/bip39/wordlists/english";
+import { toUint8Array } from "@xylabs/arraybuffer";
+import { assertEx } from "@xylabs/assert";
+import { globallyUnique } from "@xylabs/base";
+import {
+  hexFromHexString
+} from "@xylabs/hex";
+import { staticImplements } from "@xylabs/static-implements";
+import { Account, PrivateKey } from "@xyo-network/account";
+import {
+  isMnemonicInitializationConfig,
+  isPhraseInitializationConfig,
+  isPrivateKeyInitializationConfig
+} from "@xyo-network/account-model";
+import {
+  defaultPath,
+  HDNodeWallet,
+  Mnemonic
+} from "ethers";
+var HDWallet = class extends Account {
+  constructor(key, node, privateKey) {
+    super(Account._protectedConstructorKey, privateKey);
+    this.node = node;
+  }
+  get address() {
+    return hexFromHexString(this.node.address, { prefix: false });
+  }
+  get addressBytes() {
+    return toUint8Array(this.address, void 0, 16).buffer;
+  }
+  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 privateKey() {
+    return this.node.privateKey.toLowerCase();
+  }
+  get publicKey() {
+    return this.node.publicKey.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 Account.fromPrivateKey instead.");
+    }
+    throw new Error("Invalid initialization config");
+  }
+  static async createFromNode(node, previousHash) {
+    return await this.createFromNodeInternal(node, previousHash);
+  }
+  static async fromExtendedKey(key) {
+    const node = HDNodeWallet.fromExtendedKey(key);
+    return await HDWallet.createFromNode(node);
+  }
+  static async fromMnemonic(mnemonic, path = defaultPath) {
+    const node = HDNodeWallet.fromMnemonic(mnemonic, path);
+    const createdWallet = await this.createFromNodeInternal(node);
+    return this.getCachedWalletOrCacheNewWallet(createdWallet);
+  }
+  static async fromPhrase(phrase, path = defaultPath) {
+    return await this.fromMnemonic(Mnemonic.fromPhrase(phrase), path);
+  }
+  static async fromSeed(seed) {
+    const node = HDNodeWallet.fromSeed(toUint8Array(seed));
+    const createdWallet = await this.createFromNodeInternal(node);
+    return this.getCachedWalletOrCacheNewWallet(createdWallet);
+  }
+  static generateMnemonic(wordlist = englishWordlist, strength = 256) {
+    return generateMnemonic(wordlist, strength);
+  }
+  static async random() {
+    return await this.fromMnemonic(Mnemonic.fromPhrase(HDWallet.generateMnemonic()));
+  }
+  static async createFromNodeInternal(node, previousHash) {
+    const privateKey = toUint8Array(node.privateKey.replace("0x", ""));
+    assertEx(!privateKey || privateKey?.length === 32, () => `Private key must be 32 bytes [${privateKey?.length}]`);
+    const newWallet = await new HDWallet(Account._protectedConstructorKey, node, await PrivateKey.create(privateKey.buffer)).loadPreviousHash(previousHash);
+    return HDWallet._addressMap[newWallet.address]?.deref() ?? newWallet;
+  }
+  static getCachedWalletOrCacheNewWallet(createdWallet) {
+    const existingWallet = this._addressMap[createdWallet.address]?.deref();
+    if (existingWallet) {
+      return existingWallet;
+    }
+    const ref = new WeakRef(createdWallet);
+    this._addressMap[createdWallet.address] = ref;
+    return createdWallet;
+  }
+  async derivePath(path) {
+    if (path.startsWith("m/")) {
+      const parentPath = this.path;
+      if (parentPath !== null && path.startsWith(parentPath)) {
+        const childPath = path.slice(parentPath.length + 1);
+        return await HDWallet.createFromNode(this.node.derivePath(childPath));
+      }
+      throw new Error(`Invalid absolute path ${path} for wallet with path ${parentPath}`);
+    }
+    return await HDWallet.createFromNode(this.node.derivePath(path));
+  }
+  neuter = () => {
+    this.node.neuter();
+    return this;
+  };
+};
+__publicField(HDWallet, "uniqueName", globallyUnique("HDWallet", HDWallet, "xyo"));
+__publicField(HDWallet, "_addressMap", {});
+HDWallet = __decorateClass([
+  staticImplements()
+], HDWallet);
+export {
+  HDWallet
+};
+//# sourceMappingURL=index.mjs.map

package/dist/browser/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/HDWallet.ts"],"sourcesContent":["import { generateMnemonic } from '@scure/bip39'\nimport { wordlist as englishWordlist } from '@scure/bip39/wordlists/english'\nimport { toUint8Array } from '@xylabs/arraybuffer'\nimport { assertEx } from '@xylabs/assert'\nimport { globallyUnique } from '@xylabs/base'\nimport {\n  Address, Hex, hexFromHexString,\n} from '@xylabs/hex'\nimport { staticImplements } from '@xylabs/static-implements'\nimport { Account, PrivateKey } from '@xyo-network/account'\nimport {\n  AccountConfig,\n  isMnemonicInitializationConfig,\n  isPhraseInitializationConfig,\n  isPrivateKeyInitializationConfig,\n} from '@xyo-network/account-model'\nimport type { PrivateKeyInstance } from '@xyo-network/key-model'\nimport { WalletInstance, WalletStatic } from '@xyo-network/wallet-model'\nimport {\n  defaultPath, HDNodeWallet, Mnemonic,\n} from 'ethers'\n\n@staticImplements<WalletStatic>()\nexport class HDWallet extends Account implements WalletInstance {\n  static override readonly uniqueName = globallyUnique('HDWallet', HDWallet, 'xyo')\n  protected static override _addressMap: Record<Address, WeakRef<WalletInstance>> = {}\n\n  constructor(\n    key: unknown,\n    protected readonly node: HDNodeWallet,\n    privateKey: PrivateKeyInstance,\n  ) {\n    super(Account._protectedConstructorKey, privateKey)\n  }\n\n  override get address(): Address {\n    return hexFromHexString(this.node.address, { prefix: false })\n  }\n\n  override get addressBytes(): ArrayBufferLike {\n    return toUint8Array(this.address, undefined, 16).buffer\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 privateKey(): Hex {\n    return this.node.privateKey.toLowerCase() as Hex\n  }\n\n  get publicKey(): Hex {\n    return this.node.publicKey.toLowerCase() as Hex\n  }\n\n  static override 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 Account.fromPrivateKey instead.')\n    }\n    throw new Error('Invalid initialization config')\n  }\n\n  static async createFromNode(node: HDNodeWallet, previousHash?: string): Promise<WalletInstance> {\n    return await this.createFromNodeInternal(node, previousHash)\n  }\n\n  static async fromExtendedKey(key: string): Promise<WalletInstance> {\n    const node = HDNodeWallet.fromExtendedKey(key)\n    /* TODO: Handle HDNodeVoidWallet */\n    return await HDWallet.createFromNode(node as HDNodeWallet)\n  }\n\n  static async fromMnemonic(mnemonic: Mnemonic, path: string = defaultPath): Promise<WalletInstance> {\n    const node = HDNodeWallet.fromMnemonic(mnemonic, path)\n    const createdWallet = await this.createFromNodeInternal(node)\n    return this.getCachedWalletOrCacheNewWallet(createdWallet)\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 fromSeed(seed: string | ArrayBufferLike): Promise<WalletInstance> {\n    const node = HDNodeWallet.fromSeed(toUint8Array(seed))\n    const createdWallet = await this.createFromNodeInternal(node)\n    return this.getCachedWalletOrCacheNewWallet(createdWallet)\n  }\n\n  static generateMnemonic(wordlist: string[] = englishWordlist, strength: number = 256): string {\n    return generateMnemonic(wordlist, strength)\n  }\n\n  static override async random(): Promise<WalletInstance> {\n    return await this.fromMnemonic(Mnemonic.fromPhrase(HDWallet.generateMnemonic()))\n  }\n\n  protected static async createFromNodeInternal(node: HDNodeWallet, previousHash?: string): Promise<WalletInstance> {\n    const privateKey = toUint8Array(node.privateKey.replace('0x', ''))\n    assertEx(!privateKey || privateKey?.length === 32, () => `Private key must be 32 bytes [${privateKey?.length}]`)\n    const newWallet = await new HDWallet(Account._protectedConstructorKey, node, await PrivateKey.create(privateKey.buffer)).loadPreviousHash(previousHash)\n    return HDWallet._addressMap[newWallet.address]?.deref() ?? newWallet\n  }\n\n  protected static getCachedWalletOrCacheNewWallet(createdWallet: WalletInstance): WalletInstance {\n    const existingWallet = this._addressMap[createdWallet.address]?.deref()\n    if (existingWallet) {\n      return existingWallet\n    }\n    const ref = new WeakRef(createdWallet)\n    this._addressMap[createdWallet.address] = ref\n    return createdWallet\n  }\n\n  async derivePath(path: string): Promise<WalletInstance> {\n    // if an absolute path, check if it matches the parent root and work with it\n    if (path.startsWith('m/')) {\n      const parentPath = this.path\n      if (parentPath !== null && path.startsWith(parentPath)) {\n        const childPath = path.slice(parentPath.length + 1)\n        return await HDWallet.createFromNode(this.node.derivePath(childPath))\n      }\n      throw new Error(`Invalid absolute path ${path} for wallet with path ${parentPath}`)\n    }\n    return await HDWallet.createFromNode(this.node.derivePath(path))\n  }\n\n  neuter: () => HDWallet = () => {\n    this.node.neuter()\n    return this\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/neutral/index.mjs

@@ -0,0 +1,153 @@
+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/HDWallet.ts
+import { generateMnemonic } from "@scure/bip39";
+import { wordlist as englishWordlist } from "@scure/bip39/wordlists/english";
+import { toUint8Array } from "@xylabs/arraybuffer";
+import { assertEx } from "@xylabs/assert";
+import { globallyUnique } from "@xylabs/base";
+import {
+  hexFromHexString
+} from "@xylabs/hex";
+import { staticImplements } from "@xylabs/static-implements";
+import { Account, PrivateKey } from "@xyo-network/account";
+import {
+  isMnemonicInitializationConfig,
+  isPhraseInitializationConfig,
+  isPrivateKeyInitializationConfig
+} from "@xyo-network/account-model";
+import {
+  defaultPath,
+  HDNodeWallet,
+  Mnemonic
+} from "ethers";
+var HDWallet = class extends Account {
+  constructor(key, node, privateKey) {
+    super(Account._protectedConstructorKey, privateKey);
+    this.node = node;
+  }
+  get address() {
+    return hexFromHexString(this.node.address, { prefix: false });
+  }
+  get addressBytes() {
+    return toUint8Array(this.address, void 0, 16).buffer;
+  }
+  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 privateKey() {
+    return this.node.privateKey.toLowerCase();
+  }
+  get publicKey() {
+    return this.node.publicKey.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 Account.fromPrivateKey instead.");
+    }
+    throw new Error("Invalid initialization config");
+  }
+  static async createFromNode(node, previousHash) {
+    return await this.createFromNodeInternal(node, previousHash);
+  }
+  static async fromExtendedKey(key) {
+    const node = HDNodeWallet.fromExtendedKey(key);
+    return await HDWallet.createFromNode(node);
+  }
+  static async fromMnemonic(mnemonic, path = defaultPath) {
+    const node = HDNodeWallet.fromMnemonic(mnemonic, path);
+    const createdWallet = await this.createFromNodeInternal(node);
+    return this.getCachedWalletOrCacheNewWallet(createdWallet);
+  }
+  static async fromPhrase(phrase, path = defaultPath) {
+    return await this.fromMnemonic(Mnemonic.fromPhrase(phrase), path);
+  }
+  static async fromSeed(seed) {
+    const node = HDNodeWallet.fromSeed(toUint8Array(seed));
+    const createdWallet = await this.createFromNodeInternal(node);
+    return this.getCachedWalletOrCacheNewWallet(createdWallet);
+  }
+  static generateMnemonic(wordlist = englishWordlist, strength = 256) {
+    return generateMnemonic(wordlist, strength);
+  }
+  static async random() {
+    return await this.fromMnemonic(Mnemonic.fromPhrase(HDWallet.generateMnemonic()));
+  }
+  static async createFromNodeInternal(node, previousHash) {
+    const privateKey = toUint8Array(node.privateKey.replace("0x", ""));
+    assertEx(!privateKey || privateKey?.length === 32, () => `Private key must be 32 bytes [${privateKey?.length}]`);
+    const newWallet = await new HDWallet(Account._protectedConstructorKey, node, await PrivateKey.create(privateKey.buffer)).loadPreviousHash(previousHash);
+    return HDWallet._addressMap[newWallet.address]?.deref() ?? newWallet;
+  }
+  static getCachedWalletOrCacheNewWallet(createdWallet) {
+    const existingWallet = this._addressMap[createdWallet.address]?.deref();
+    if (existingWallet) {
+      return existingWallet;
+    }
+    const ref = new WeakRef(createdWallet);
+    this._addressMap[createdWallet.address] = ref;
+    return createdWallet;
+  }
+  async derivePath(path) {
+    if (path.startsWith("m/")) {
+      const parentPath = this.path;
+      if (parentPath !== null && path.startsWith(parentPath)) {
+        const childPath = path.slice(parentPath.length + 1);
+        return await HDWallet.createFromNode(this.node.derivePath(childPath));
+      }
+      throw new Error(`Invalid absolute path ${path} for wallet with path ${parentPath}`);
+    }
+    return await HDWallet.createFromNode(this.node.derivePath(path));
+  }
+  neuter = () => {
+    this.node.neuter();
+    return this;
+  };
+};
+__publicField(HDWallet, "uniqueName", globallyUnique("HDWallet", HDWallet, "xyo"));
+__publicField(HDWallet, "_addressMap", {});
+HDWallet = __decorateClass([
+  staticImplements()
+], HDWallet);
+export {
+  HDWallet
+};
+//# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/HDWallet.ts"],"sourcesContent":["import { generateMnemonic } from '@scure/bip39'\nimport { wordlist as englishWordlist } from '@scure/bip39/wordlists/english'\nimport { toUint8Array } from '@xylabs/arraybuffer'\nimport { assertEx } from '@xylabs/assert'\nimport { globallyUnique } from '@xylabs/base'\nimport {\n  Address, Hex, hexFromHexString,\n} from '@xylabs/hex'\nimport { staticImplements } from '@xylabs/static-implements'\nimport { Account, PrivateKey } from '@xyo-network/account'\nimport {\n  AccountConfig,\n  isMnemonicInitializationConfig,\n  isPhraseInitializationConfig,\n  isPrivateKeyInitializationConfig,\n} from '@xyo-network/account-model'\nimport type { PrivateKeyInstance } from '@xyo-network/key-model'\nimport { WalletInstance, WalletStatic } from '@xyo-network/wallet-model'\nimport {\n  defaultPath, HDNodeWallet, Mnemonic,\n} from 'ethers'\n\n@staticImplements<WalletStatic>()\nexport class HDWallet extends Account implements WalletInstance {\n  static override readonly uniqueName = globallyUnique('HDWallet', HDWallet, 'xyo')\n  protected static override _addressMap: Record<Address, WeakRef<WalletInstance>> = {}\n\n  constructor(\n    key: unknown,\n    protected readonly node: HDNodeWallet,\n    privateKey: PrivateKeyInstance,\n  ) {\n    super(Account._protectedConstructorKey, privateKey)\n  }\n\n  override get address(): Address {\n    return hexFromHexString(this.node.address, { prefix: false })\n  }\n\n  override get addressBytes(): ArrayBufferLike {\n    return toUint8Array(this.address, undefined, 16).buffer\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 privateKey(): Hex {\n    return this.node.privateKey.toLowerCase() as Hex\n  }\n\n  get publicKey(): Hex {\n    return this.node.publicKey.toLowerCase() as Hex\n  }\n\n  static override 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 Account.fromPrivateKey instead.')\n    }\n    throw new Error('Invalid initialization config')\n  }\n\n  static async createFromNode(node: HDNodeWallet, previousHash?: string): Promise<WalletInstance> {\n    return await this.createFromNodeInternal(node, previousHash)\n  }\n\n  static async fromExtendedKey(key: string): Promise<WalletInstance> {\n    const node = HDNodeWallet.fromExtendedKey(key)\n    /* TODO: Handle HDNodeVoidWallet */\n    return await HDWallet.createFromNode(node as HDNodeWallet)\n  }\n\n  static async fromMnemonic(mnemonic: Mnemonic, path: string = defaultPath): Promise<WalletInstance> {\n    const node = HDNodeWallet.fromMnemonic(mnemonic, path)\n    const createdWallet = await this.createFromNodeInternal(node)\n    return this.getCachedWalletOrCacheNewWallet(createdWallet)\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 fromSeed(seed: string | ArrayBufferLike): Promise<WalletInstance> {\n    const node = HDNodeWallet.fromSeed(toUint8Array(seed))\n    const createdWallet = await this.createFromNodeInternal(node)\n    return this.getCachedWalletOrCacheNewWallet(createdWallet)\n  }\n\n  static generateMnemonic(wordlist: string[] = englishWordlist, strength: number = 256): string {\n    return generateMnemonic(wordlist, strength)\n  }\n\n  static override async random(): Promise<WalletInstance> {\n    return await this.fromMnemonic(Mnemonic.fromPhrase(HDWallet.generateMnemonic()))\n  }\n\n  protected static async createFromNodeInternal(node: HDNodeWallet, previousHash?: string): Promise<WalletInstance> {\n    const privateKey = toUint8Array(node.privateKey.replace('0x', ''))\n    assertEx(!privateKey || privateKey?.length === 32, () => `Private key must be 32 bytes [${privateKey?.length}]`)\n    const newWallet = await new HDWallet(Account._protectedConstructorKey, node, await PrivateKey.create(privateKey.buffer)).loadPreviousHash(previousHash)\n    return HDWallet._addressMap[newWallet.address]?.deref() ?? newWallet\n  }\n\n  protected static getCachedWalletOrCacheNewWallet(createdWallet: WalletInstance): WalletInstance {\n    const existingWallet = this._addressMap[createdWallet.address]?.deref()\n    if (existingWallet) {\n      return existingWallet\n    }\n    const ref = new WeakRef(createdWallet)\n    this._addressMap[createdWallet.address] = ref\n    return createdWallet\n  }\n\n  async derivePath(path: string): Promise<WalletInstance> {\n    // if an absolute path, check if it matches the parent root and work with it\n    if (path.startsWith('m/')) {\n      const parentPath = this.path\n      if (parentPath !== null && path.startsWith(parentPath)) {\n        const childPath = path.slice(parentPath.length + 1)\n        return await HDWallet.createFromNode(this.node.derivePath(childPath))\n      }\n      throw new Error(`Invalid absolute path ${path} for wallet with path ${parentPath}`)\n    }\n    return await HDWallet.createFromNode(this.node.derivePath(path))\n  }\n\n  neuter: () => HDWallet = () => {\n    this.node.neuter()\n    return this\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA,SAAS,wBAAwB;AACjC,SAAS,YAAY,uBAAuB;AAC5C,SAAS,oBAAoB;AAC7B,SAAS,gBAAgB;AACzB,SAAS,sBAAsB;AAC/B;AAAA,EACgB;AAAA,OACT;AACP,SAAS,wBAAwB;AACjC,SAAS,SAAS,kBAAkB;AACpC;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EAAa;AAAA,EAAc;AAAA,OACtB;AAGA,IAAM,WAAN,cAAuB,QAAkC;AAAA,EAI9D,YACE,KACmB,MACnB,YACA;AACA,UAAM,QAAQ,0BAA0B,UAAU;AAH/B;AAAA,EAIrB;AAAA,EAEA,IAAa,UAAmB;AAC9B,WAAO,iBAAiB,KAAK,KAAK,SAAS,EAAE,QAAQ,MAAM,CAAC;AAAA,EAC9D;AAAA,EAEA,IAAa,eAAgC;AAC3C,WAAO,aAAa,KAAK,SAAS,QAAW,EAAE,EAAE;AAAA,EACnD;AAAA,EAEA,IAAI,YAAoB;AACtB,WAAO,KAAK,KAAK;AAAA,EACnB;AAAA,EAEA,IAAI,QAAgB;AAClB,WAAO,KAAK,KAAK;AAAA,EACnB;AAAA,EAEA,IAAI,cAAsB;AACxB,WAAO,KAAK,KAAK;AAAA,EACnB;AAAA,EAEA,IAAI,cAAsB;AACxB,WAAO,KAAK,KAAK;AAAA,EACnB;AAAA,EAEA,IAAI,QAAgB;AAClB,WAAO,KAAK,KAAK;AAAA,EACnB;AAAA,EAEA,IAAI,WAA4B;AAC9B,WAAO,KAAK,KAAK;AAAA,EACnB;AAAA,EAEA,IAAI,oBAA4B;AAC9B,WAAO,KAAK,KAAK;AAAA,EACnB;AAAA,EAEA,IAAI,OAAsB;AACxB,WAAO,KAAK,KAAK;AAAA,EACnB;AAAA,EAEA,IAAI,aAAkB;AACpB,WAAO,KAAK,KAAK,WAAW,YAAY;AAAA,EAC1C;AAAA,EAEA,IAAI,YAAiB;AACnB,WAAO,KAAK,KAAK,UAAU,YAAY;AAAA,EACzC;AAAA,EAEA,aAAsB,OAAO,MAA+C;AAC1E,QAAI,6BAA6B,IAAI,GAAG;AACtC,aAAO,MAAM,KAAK,WAAW,KAAK,MAAM;AAAA,IAC1C;AACA,QAAI,+BAA+B,IAAI,GAAG;AACxC,aAAO,MAAM,KAAK,WAAW,KAAK,UAAU,KAAK,IAAI;AAAA,IACvD;AACA,QAAI,iCAAiC,IAAI,GAAG;AAC1C,YAAM,IAAI,MAAM,oGAAoG;AAAA,IACtH;AACA,UAAM,IAAI,MAAM,+BAA+B;AAAA,EACjD;AAAA,EAEA,aAAa,eAAe,MAAoB,cAAgD;AAC9F,WAAO,MAAM,KAAK,uBAAuB,MAAM,YAAY;AAAA,EAC7D;AAAA,EAEA,aAAa,gBAAgB,KAAsC;AACjE,UAAM,OAAO,aAAa,gBAAgB,GAAG;AAE7C,WAAO,MAAM,SAAS,eAAe,IAAoB;AAAA,EAC3D;AAAA,EAEA,aAAa,aAAa,UAAoB,OAAe,aAAsC;AACjG,UAAM,OAAO,aAAa,aAAa,UAAU,IAAI;AACrD,UAAM,gBAAgB,MAAM,KAAK,uBAAuB,IAAI;AAC5D,WAAO,KAAK,gCAAgC,aAAa;AAAA,EAC3D;AAAA,EAEA,aAAa,WAAW,QAAgB,OAAe,aAAsC;AAC3F,WAAO,MAAM,KAAK,aAAa,SAAS,WAAW,MAAM,GAAG,IAAI;AAAA,EAClE;AAAA,EAEA,aAAa,SAAS,MAAyD;AAC7E,UAAM,OAAO,aAAa,SAAS,aAAa,IAAI,CAAC;AACrD,UAAM,gBAAgB,MAAM,KAAK,uBAAuB,IAAI;AAC5D,WAAO,KAAK,gCAAgC,aAAa;AAAA,EAC3D;AAAA,EAEA,OAAO,iBAAiB,WAAqB,iBAAiB,WAAmB,KAAa;AAC5F,WAAO,iBAAiB,UAAU,QAAQ;AAAA,EAC5C;AAAA,EAEA,aAAsB,SAAkC;AACtD,WAAO,MAAM,KAAK,aAAa,SAAS,WAAW,SAAS,iBAAiB,CAAC,CAAC;AAAA,EACjF;AAAA,EAEA,aAAuB,uBAAuB,MAAoB,cAAgD;AAChH,UAAM,aAAa,aAAa,KAAK,WAAW,QAAQ,MAAM,EAAE,CAAC;AACjE,aAAS,CAAC,cAAc,YAAY,WAAW,IAAI,MAAM,iCAAiC,YAAY,MAAM,GAAG;AAC/G,UAAM,YAAY,MAAM,IAAI,SAAS,QAAQ,0BAA0B,MAAM,MAAM,WAAW,OAAO,WAAW,MAAM,CAAC,EAAE,iBAAiB,YAAY;AACtJ,WAAO,SAAS,YAAY,UAAU,OAAO,GAAG,MAAM,KAAK;AAAA,EAC7D;AAAA,EAEA,OAAiB,gCAAgC,eAA+C;AAC9F,UAAM,iBAAiB,KAAK,YAAY,cAAc,OAAO,GAAG,MAAM;AACtE,QAAI,gBAAgB;AAClB,aAAO;AAAA,IACT;AACA,UAAM,MAAM,IAAI,QAAQ,aAAa;AACrC,SAAK,YAAY,cAAc,OAAO,IAAI;AAC1C,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,WAAW,MAAuC;AAEtD,QAAI,KAAK,WAAW,IAAI,GAAG;AACzB,YAAM,aAAa,KAAK;AACxB,UAAI,eAAe,QAAQ,KAAK,WAAW,UAAU,GAAG;AACtD,cAAM,YAAY,KAAK,MAAM,WAAW,SAAS,CAAC;AAClD,eAAO,MAAM,SAAS,eAAe,KAAK,KAAK,WAAW,SAAS,CAAC;AAAA,MACtE;AACA,YAAM,IAAI,MAAM,yBAAyB,IAAI,yBAAyB,UAAU,EAAE;AAAA,IACpF;AACA,WAAO,MAAM,SAAS,eAAe,KAAK,KAAK,WAAW,IAAI,CAAC;AAAA,EACjE;AAAA,EAEA,SAAyB,MAAM;AAC7B,SAAK,KAAK,OAAO;AACjB,WAAO;AAAA,EACT;AACF;AA5IE,cADW,UACc,cAAa,eAAe,YAAY,UAAU,KAAK;AAChF,cAFW,UAEe,eAAwD,CAAC;AAFxE,WAAN;AAAA,EADN,iBAA+B;AAAA,GACnB;","names":[]}

package/dist/node/index.mjs

@@ -0,0 +1,153 @@
+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/HDWallet.ts
+import { generateMnemonic } from "@scure/bip39";
+import { wordlist as englishWordlist } from "@scure/bip39/wordlists/english";
+import { toUint8Array } from "@xylabs/arraybuffer";
+import { assertEx } from "@xylabs/assert";
+import { globallyUnique } from "@xylabs/base";
+import {
+  hexFromHexString
+} from "@xylabs/hex";
+import { staticImplements } from "@xylabs/static-implements";
+import { Account, PrivateKey } from "@xyo-network/account";
+import {
+  isMnemonicInitializationConfig,
+  isPhraseInitializationConfig,
+  isPrivateKeyInitializationConfig
+} from "@xyo-network/account-model";
+import {
+  defaultPath,
+  HDNodeWallet,
+  Mnemonic
+} from "ethers";
+var HDWallet = class extends Account {
+  constructor(key, node, privateKey) {
+    super(Account._protectedConstructorKey, privateKey);
+    this.node = node;
+  }
+  get address() {
+    return hexFromHexString(this.node.address, { prefix: false });
+  }
+  get addressBytes() {
+    return toUint8Array(this.address, void 0, 16).buffer;
+  }
+  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 privateKey() {
+    return this.node.privateKey.toLowerCase();
+  }
+  get publicKey() {
+    return this.node.publicKey.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 Account.fromPrivateKey instead.");
+    }
+    throw new Error("Invalid initialization config");
+  }
+  static async createFromNode(node, previousHash) {
+    return await this.createFromNodeInternal(node, previousHash);
+  }
+  static async fromExtendedKey(key) {
+    const node = HDNodeWallet.fromExtendedKey(key);
+    return await HDWallet.createFromNode(node);
+  }
+  static async fromMnemonic(mnemonic, path = defaultPath) {
+    const node = HDNodeWallet.fromMnemonic(mnemonic, path);
+    const createdWallet = await this.createFromNodeInternal(node);
+    return this.getCachedWalletOrCacheNewWallet(createdWallet);
+  }
+  static async fromPhrase(phrase, path = defaultPath) {
+    return await this.fromMnemonic(Mnemonic.fromPhrase(phrase), path);
+  }
+  static async fromSeed(seed) {
+    const node = HDNodeWallet.fromSeed(toUint8Array(seed));
+    const createdWallet = await this.createFromNodeInternal(node);
+    return this.getCachedWalletOrCacheNewWallet(createdWallet);
+  }
+  static generateMnemonic(wordlist = englishWordlist, strength = 256) {
+    return generateMnemonic(wordlist, strength);
+  }
+  static async random() {
+    return await this.fromMnemonic(Mnemonic.fromPhrase(HDWallet.generateMnemonic()));
+  }
+  static async createFromNodeInternal(node, previousHash) {
+    const privateKey = toUint8Array(node.privateKey.replace("0x", ""));
+    assertEx(!privateKey || privateKey?.length === 32, () => `Private key must be 32 bytes [${privateKey?.length}]`);
+    const newWallet = await new HDWallet(Account._protectedConstructorKey, node, await PrivateKey.create(privateKey.buffer)).loadPreviousHash(previousHash);
+    return HDWallet._addressMap[newWallet.address]?.deref() ?? newWallet;
+  }
+  static getCachedWalletOrCacheNewWallet(createdWallet) {
+    const existingWallet = this._addressMap[createdWallet.address]?.deref();
+    if (existingWallet) {
+      return existingWallet;
+    }
+    const ref = new WeakRef(createdWallet);
+    this._addressMap[createdWallet.address] = ref;
+    return createdWallet;
+  }
+  async derivePath(path) {
+    if (path.startsWith("m/")) {
+      const parentPath = this.path;
+      if (parentPath !== null && path.startsWith(parentPath)) {
+        const childPath = path.slice(parentPath.length + 1);
+        return await HDWallet.createFromNode(this.node.derivePath(childPath));
+      }
+      throw new Error(`Invalid absolute path ${path} for wallet with path ${parentPath}`);
+    }
+    return await HDWallet.createFromNode(this.node.derivePath(path));
+  }
+  neuter = () => {
+    this.node.neuter();
+    return this;
+  };
+};
+__publicField(HDWallet, "uniqueName", globallyUnique("HDWallet", HDWallet, "xyo"));
+__publicField(HDWallet, "_addressMap", {});
+HDWallet = __decorateClass([
+  staticImplements()
+], HDWallet);
+export {
+  HDWallet
+};
+//# sourceMappingURL=index.mjs.map

package/dist/node/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/HDWallet.ts"],"sourcesContent":["import { generateMnemonic } from '@scure/bip39'\nimport { wordlist as englishWordlist } from '@scure/bip39/wordlists/english'\nimport { toUint8Array } from '@xylabs/arraybuffer'\nimport { assertEx } from '@xylabs/assert'\nimport { globallyUnique } from '@xylabs/base'\nimport {\n  Address, Hex, hexFromHexString,\n} from '@xylabs/hex'\nimport { staticImplements } from '@xylabs/static-implements'\nimport { Account, PrivateKey } from '@xyo-network/account'\nimport {\n  AccountConfig,\n  isMnemonicInitializationConfig,\n  isPhraseInitializationConfig,\n  isPrivateKeyInitializationConfig,\n} from '@xyo-network/account-model'\nimport type { PrivateKeyInstance } from '@xyo-network/key-model'\nimport { WalletInstance, WalletStatic } from '@xyo-network/wallet-model'\nimport {\n  defaultPath, HDNodeWallet, Mnemonic,\n} from 'ethers'\n\n@staticImplements<WalletStatic>()\nexport class HDWallet extends Account implements WalletInstance {\n  static override readonly uniqueName = globallyUnique('HDWallet', HDWallet, 'xyo')\n  protected static override _addressMap: Record<Address, WeakRef<WalletInstance>> = {}\n\n  constructor(\n    key: unknown,\n    protected readonly node: HDNodeWallet,\n    privateKey: PrivateKeyInstance,\n  ) {\n    super(Account._protectedConstructorKey, privateKey)\n  }\n\n  override get address(): Address {\n    return hexFromHexString(this.node.address, { prefix: false })\n  }\n\n  override get addressBytes(): ArrayBufferLike {\n    return toUint8Array(this.address, undefined, 16).buffer\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 privateKey(): Hex {\n    return this.node.privateKey.toLowerCase() as Hex\n  }\n\n  get publicKey(): Hex {\n    return this.node.publicKey.toLowerCase() as Hex\n  }\n\n  static override 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 Account.fromPrivateKey instead.')\n    }\n    throw new Error('Invalid initialization config')\n  }\n\n  static async createFromNode(node: HDNodeWallet, previousHash?: string): Promise<WalletInstance> {\n    return await this.createFromNodeInternal(node, previousHash)\n  }\n\n  static async fromExtendedKey(key: string): Promise<WalletInstance> {\n    const node = HDNodeWallet.fromExtendedKey(key)\n    /* TODO: Handle HDNodeVoidWallet */\n    return await HDWallet.createFromNode(node as HDNodeWallet)\n  }\n\n  static async fromMnemonic(mnemonic: Mnemonic, path: string = defaultPath): Promise<WalletInstance> {\n    const node = HDNodeWallet.fromMnemonic(mnemonic, path)\n    const createdWallet = await this.createFromNodeInternal(node)\n    return this.getCachedWalletOrCacheNewWallet(createdWallet)\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 fromSeed(seed: string | ArrayBufferLike): Promise<WalletInstance> {\n    const node = HDNodeWallet.fromSeed(toUint8Array(seed))\n    const createdWallet = await this.createFromNodeInternal(node)\n    return this.getCachedWalletOrCacheNewWallet(createdWallet)\n  }\n\n  static generateMnemonic(wordlist: string[] = englishWordlist, strength: number = 256): string {\n    return generateMnemonic(wordlist, strength)\n  }\n\n  static override async random(): Promise<WalletInstance> {\n    return await this.fromMnemonic(Mnemonic.fromPhrase(HDWallet.generateMnemonic()))\n  }\n\n  protected static async createFromNodeInternal(node: HDNodeWallet, previousHash?: string): Promise<WalletInstance> {\n    const privateKey = toUint8Array(node.privateKey.replace('0x', ''))\n    assertEx(!privateKey || privateKey?.length === 32, () => `Private key must be 32 bytes [${privateKey?.length}]`)\n    const newWallet = await new HDWallet(Account._protectedConstructorKey, node, await PrivateKey.create(privateKey.buffer)).loadPreviousHash(previousHash)\n    return HDWallet._addressMap[newWallet.address]?.deref() ?? newWallet\n  }\n\n  protected static getCachedWalletOrCacheNewWallet(createdWallet: WalletInstance): WalletInstance {\n    const existingWallet = this._addressMap[createdWallet.address]?.deref()\n    if (existingWallet) {\n      return existingWallet\n    }\n    const ref = new WeakRef(createdWallet)\n    this._addressMap[createdWallet.address] = ref\n    return createdWallet\n  }\n\n  async derivePath(path: string): Promise<WalletInstance> {\n    // if an absolute path, check if it matches the parent root and work with it\n    if (path.startsWith('m/')) {\n      const parentPath = this.path\n      if (parentPath !== null && path.startsWith(parentPath)) {\n        const childPath = path.slice(parentPath.length + 1)\n        return await HDWallet.createFromNode(this.node.derivePath(childPath))\n      }\n      throw new Error(`Invalid absolute path ${path} for wallet with path ${parentPath}`)\n    }\n    return await HDWallet.createFromNode(this.node.derivePath(path))\n  }\n\n  neuter: () => HDWallet = () => {\n    this.node.neuter()\n    return this\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/types/HDWallet.d.ts

@@ -0,0 +1,37 @@
+import { Address, Hex } from '@xylabs/hex';
+import { Account } from '@xyo-network/account';
+import { AccountConfig } from '@xyo-network/account-model';
+import type { PrivateKeyInstance } from '@xyo-network/key-model';
+import { WalletInstance } from '@xyo-network/wallet-model';
+import { HDNodeWallet, Mnemonic } from 'ethers';
+export declare class HDWallet extends Account implements WalletInstance {
+    protected readonly node: HDNodeWallet;
+    static readonly uniqueName: string;
+    protected static _addressMap: Record<Address, WeakRef<WalletInstance>>;
+    constructor(key: unknown, node: HDNodeWallet, privateKey: PrivateKeyInstance);
+    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 privateKey(): Hex;
+    get publicKey(): Hex;
+    static create(opts?: AccountConfig): Promise<WalletInstance>;
+    static createFromNode(node: HDNodeWallet, previousHash?: string): 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 fromSeed(seed: string | ArrayBufferLike): Promise<WalletInstance>;
+    static generateMnemonic(wordlist?: string[], strength?: number): string;
+    static random(): Promise<WalletInstance>;
+    protected static createFromNodeInternal(node: HDNodeWallet, previousHash?: string): Promise<WalletInstance>;
+    protected static getCachedWalletOrCacheNewWallet(createdWallet: WalletInstance): WalletInstance;
+    derivePath(path: string): Promise<WalletInstance>;
+    neuter: () => HDWallet;
+}
+//# sourceMappingURL=HDWallet.d.ts.map

package/dist/types/HDWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HDWallet.d.ts","sourceRoot":"","sources":["../../src/HDWallet.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,OAAO,EAAE,GAAG,EACb,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,OAAO,EAAc,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EACL,aAAa,EAId,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,cAAc,EAAgB,MAAM,2BAA2B,CAAA;AACxE,OAAO,EACQ,YAAY,EAAE,QAAQ,EACpC,MAAM,QAAQ,CAAA;AAEf,qBACa,QAAS,SAAQ,OAAQ,YAAW,cAAc;IAM3D,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY;IALvC,gBAAyB,UAAU,SAA8C;IACjF,iBAA0B,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAK;gBAGlF,GAAG,EAAE,OAAO,EACO,IAAI,EAAE,YAAY,EACrC,UAAU,EAAE,kBAAkB;IAKhC,IAAa,OAAO,IAAI,OAAO,CAE9B;IAED,IAAa,YAAY,IAAI,eAAe,CAE3C;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,QAAQ,IAAI,QAAQ,GAAG,IAAI,CAE9B;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,IAAI,IAAI,IAAI,MAAM,GAAG,IAAI,CAExB;IAED,IAAI,UAAU,IAAI,GAAG,CAEpB;IAED,IAAI,SAAS,IAAI,GAAG,CAEnB;WAEqB,MAAM,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;WAa9D,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;WAIlF,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;WAMrD,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,GAAE,MAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;WAMrF,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,MAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;WAI/E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAM9E,MAAM,CAAC,gBAAgB,CAAC,QAAQ,GAAE,MAAM,EAAoB,EAAE,QAAQ,GAAE,MAAY,GAAG,MAAM;WAIvE,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;qBAIhC,sBAAsB,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAOjH,SAAS,CAAC,MAAM,CAAC,+BAA+B,CAAC,aAAa,EAAE,cAAc,GAAG,cAAc;IAUzF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAavD,MAAM,EAAE,MAAM,QAAQ,CAGrB;CACF"}

package/dist/types/index.d.ts

@@ -1,3 +1,2 @@
-export * from './Wallet';
-export * from './Words';
+export * from './HDWallet.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA"}

package/knip.config.ts

@@ -0,0 +1,16 @@
+import type { KnipConfig } from 'knip'
+
+const config: KnipConfig = {
+  entry: [
+    'src/index.ts',
+  ],
+  ignore: ['packages/**'],
+  project: ['src/**/*.ts*'],
+  typescript: {
+    config: [
+      'tsconfig.json',
+    ],
+  },
+}
+
+export default config