@leather.io/crypto 1.12.7 → 1.12.8

package/dist/{index.d.mts → index.d.ts}

@@ -1,12 +1,13 @@
-import { HDKey } from '@scure/bip32';
+import { HDKey } from "@scure/bip32";
 
+//#region src/derivation-path-utils.d.ts
 declare enum DerivationPathDepth {
-    Root = 0,
-    Purpose = 1,
-    CoinType = 2,
-    Account = 3,
-    Change = 4,
-    AddressIndex = 5
+  Root = 0,
+  Purpose = 1,
+  CoinType = 2,
+  Account = 3,
+  Change = 4,
+  AddressIndex = 5,
 }
 declare const extractPurposeFromPath: (path: string) => number;
 declare const extractAccountIndexFromPath: (path: string) => number;
@@ -56,13 +57,14 @@ declare function extractKeyFromDescriptor(descriptor: string): string;
 declare function extractAccountPathFromFullPath(path: string): string;
 declare function keyOriginToDerivationPath(keyOrigin: string): string;
 declare function decomposeDescriptor(descriptor: string): {
-    descriptor: string;
-    keyOrigin: string;
-    fingerprint: string;
-    derivationPath: string;
-    accountIndex: number;
+  descriptor: string;
+  keyOrigin: string;
+  fingerprint: string;
+  derivationPath: string;
+  accountIndex: number;
 };
-
+//#endregion
+//#region src/keychain.d.ts
 declare function generateMnemonic(): string;
 declare function deriveBip39SeedFromMnemonic(mnemonic: string, passphrase?: string): Promise<Uint8Array<ArrayBufferLike>>;
 /** @deprecated Inaccurately named fn, use `deriveBip39SeedFromMnemonic` */
@@ -83,13 +85,15 @@ declare function isValidMnemonic(mnemonic: string): boolean;
  * Create a unique accountId using wallet's fingerprint and accountIndex
  */
 declare function makeAccountIdentifer(fingerprint: string, accountIndex: number): string;
-
+//#endregion
+//#region src/signer/signer.d.ts
 type SignFn<T> = (tx: T, ...args: unknown[]) => Promise<T>;
 interface Signer {
-    sign: SignFn<any>;
-    address: string;
-    publicKey: Uint8Array;
-    derivationPath: string;
+  sign: SignFn<any>;
+  address: string;
+  publicKey: Uint8Array;
+  derivationPath: string;
 }
-
-export { DerivationPathDepth, type Signer, appendAddressIndexToPath, createDescriptor, createKeyOriginPath, decomposeDescriptor, deriveBip39MnemonicFromSeed, deriveBip39SeedFromMnemonic, deriveChildKeychainFromMnemnonic, deriveKeychainExtendedPublicKeyDescriptor, deriveKeychainFromXpub, deriveRootBip32Keychain, deriveRootKeychainFromMnemonic, extractAccountIndexFromDescriptor, extractAccountIndexFromPath, extractAccountPathFromFullPath, extractAddressIndexFromPath, extractChangeIndexFromPath, extractDerivationPathFromDescriptor, extractFingerprintFromDescriptor, extractFingerprintFromKeyOriginPath, extractKeyFromDescriptor, extractKeyOriginPathFromDescriptor, extractPurposeFromPath, generateMnemonic, getMnemonicRootKeyFingerprint, isValidMnemonic, isValidMnemonicWord, keyOriginToDerivationPath, makeAccountIdentifer, validateKeyOriginPath };
+//#endregion
+export { DerivationPathDepth, Signer, appendAddressIndexToPath, createDescriptor, createKeyOriginPath, decomposeDescriptor, deriveBip39MnemonicFromSeed, deriveBip39SeedFromMnemonic, deriveChildKeychainFromMnemnonic, deriveKeychainExtendedPublicKeyDescriptor, deriveKeychainFromXpub, deriveRootBip32Keychain, deriveRootKeychainFromMnemonic, extractAccountIndexFromDescriptor, extractAccountIndexFromPath, extractAccountPathFromFullPath, extractAddressIndexFromPath, extractChangeIndexFromPath, extractDerivationPathFromDescriptor, extractFingerprintFromDescriptor, extractFingerprintFromKeyOriginPath, extractKeyFromDescriptor, extractKeyOriginPathFromDescriptor, extractPurposeFromPath, generateMnemonic, getMnemonicRootKeyFingerprint, isValidMnemonic, isValidMnemonicWord, keyOriginToDerivationPath, makeAccountIdentifer, validateKeyOriginPath };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/derivation-path-utils.ts","../src/keychain.ts","../src/signer/signer.ts"],"sourcesContent":[],"mappings":";;;aAEY,mBAAA;;;EAAA,QAAA,GAAA,CAAA;EAkBC,OAAA,GAAA,CAAA;EAEA,MAAA,GAAA,CAAA;EAIA,YAAA,GAAA,CAAA;AAIb;AAIgB,cAdH,sBAc2B,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,GAAA,MAAA;AAMxB,cAlBH,2BAkBsC,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,GAAA,MAAA;AAcnC,cA5BH,0BA4BsB,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,GAAA,MAAA;AAKnB,cA7BH,2BA6BwB,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,GAAA,MAAA;AAqBrB,iBA9CA,wBAAA,CA8CgB,IAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAQhB,iBAhDA,mCAAA,CAgDkC,aAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AASlD;AAQA;AAOA;AAOA;AAOA;AAKA;AAKA;;iBAlFgB,mBAAA;iBAKA,qBAAA;ACzChB;AAIA;;;;AAAuF,iBD0DvE,gBAAA,CC1DuE,aAAA,EAAA,MAAA,EAAA,GAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAIvF;AAEA;AAIA;AAIsB,iBDoDN,kCAAA,CCjDK,UAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAMrB;AAMA;AAKA;AAWgB,iBD8BA,mCAAA,CC9BmB,UAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAInC;AAMA;;iBD4BgB,gCAAA;;;;AEzGwC,iBFgHxC,iCAAA,CEhHwC,UAAA,EAAA,MAAA,CAAA,EAAA,MAAA;;;AAExD;iBFqHgB,wBAAA;;;;iBAOA,8BAAA;iBAKA,yBAAA;iBAKA,mBAAA;;;;;;;;;iBCtHA,gBAAA,CAAA;iBAIM,2BAAA,yCAAiE,QAAA,WAAA;ADpBvF;AAkBa,cCMA,2BDNsF,EAAA,OCM3D,2BDN2D;AAEtF,iBCMG,uBAAA,CDJf,IAAA,ECI6C,UDJ7C,CAAA,ECIuD,KDJvD;AAEY,iBCMS,8BAAA,CDJrB,QAAA,EAAA,MAAA,EAAA,UAAA,CAAA,EAAA,MAAA,CAAA,ECIyF,ODJzF,CCIyF,KDJzF,CAAA;AAEY,iBCMS,gCAAA,CDJrB,IAAA,EAAA,MAAA,EAAA,QAAA,EAAA,MAAA,EAAA,UAAA,CAAA,EAAA,MAAA,CAAA,ECOoB,ODPpB,CCOoB,KDPpB,CAAA;AAEe,cCWH,sBDX2B,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,GCWmB,KDXnB;AAMxC;AAcA;AAKA;AAqBA;AAQgB,iBCrCM,6BAAA,CDqC4B,QAAA,EAAA,MAAA,EAAA,UAAA,CAAA,EAAA,MAAA,CAAA,ECrCuC,ODqCvC,CAAA,MAAA,CAAA;AASlC,iBCzCA,yCAAA,CDyCmC,YAAA,ECzCqB,KDyCrB,EAAA,IAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAQnC,iBCtCA,mBAAA,CDsCgC,IAAA,EAAA,MAAA,CAAA,EAAA,OAAA;AAOhC,iBCzCA,eAAA,CDyCiC,QAAA,EAAA,MAAA,CAAA,EAAA,OAAA;AAOjD;AAOA;AAKA;AAKgB,iBC3DA,oBAAA,CD2DmB,WAAA,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,CAAA,EAAA,MAAA;;;KExI9B,iBAAiB,0BAA0B,QAAQ;UAEvC,MAAA;QACT;EFDI,OAAA,EAAA,MAAA;EAkBC,SAAA,EEfA,UFeA;EAEA,cAAA,EAAA,MAAA;AAIb"}

package/dist/index.js

@@ -0,0 +1,166 @@
+import { isHexString, toHexString } from "@leather.io/utils";
+import { HDKey } from "@scure/bip32";
+import { generateMnemonic as generateMnemonic$1, mnemonicToSeed, validateMnemonic } from "@scure/bip39";
+import { wordlist } from "@scure/bip39/wordlists/english";
+import memoize from "just-memoize";
+
+//#region src/derivation-path-utils.ts
+let DerivationPathDepth = /* @__PURE__ */ function(DerivationPathDepth$1) {
+	DerivationPathDepth$1[DerivationPathDepth$1["Root"] = 0] = "Root";
+	DerivationPathDepth$1[DerivationPathDepth$1["Purpose"] = 1] = "Purpose";
+	DerivationPathDepth$1[DerivationPathDepth$1["CoinType"] = 2] = "CoinType";
+	DerivationPathDepth$1[DerivationPathDepth$1["Account"] = 3] = "Account";
+	DerivationPathDepth$1[DerivationPathDepth$1["Change"] = 4] = "Change";
+	DerivationPathDepth$1[DerivationPathDepth$1["AddressIndex"] = 5] = "AddressIndex";
+	return DerivationPathDepth$1;
+}({});
+function extractSectionFromDerivationPath(depth) {
+	return (path) => {
+		const segments = path.split("/");
+		const accountNum = parseInt(segments[depth].replaceAll("'", ""), 10);
+		if (isNaN(accountNum)) throw new Error(`Cannot parse ${DerivationPathDepth[depth]} from path`);
+		return accountNum;
+	};
+}
+const extractPurposeFromPath = extractSectionFromDerivationPath(DerivationPathDepth.Purpose);
+const extractAccountIndexFromPath = extractSectionFromDerivationPath(DerivationPathDepth.Account);
+const extractChangeIndexFromPath = extractSectionFromDerivationPath(DerivationPathDepth.Change);
+const extractAddressIndexFromPath = extractSectionFromDerivationPath(DerivationPathDepth.AddressIndex);
+function appendAddressIndexToPath(path, change, addressIndex) {
+	const accountIndex = extractAccountIndexFromPath(path);
+	if (!Number.isInteger(accountIndex)) throw new Error("Invalid path, must have account index");
+	return `${path}/${change}/${addressIndex}`;
+}
+function extractFingerprintFromKeyOriginPath(keyOriginPath) {
+	const fingerprint = keyOriginPath.split("/")[0];
+	if (!isHexString(fingerprint)) throw new Error("Fingerprint must be a hexadecimal string");
+	return fingerprint;
+}
+/**
+* @description
+* A key origin path refers to the identifier commonly used as part of the key
+* information provided as part of a Output Descriptor described in BIP-380. It
+* replaces the `m/` part of a derivation path with the master key fingerprint to which the
+* key it describes belongs.
+* @example `0a3fd8ef/84'/0'/0'`
+*/
+function createKeyOriginPath(fingerprint, path) {
+	if (!isHexString(fingerprint)) throw new Error("Fingerprint must be a hexadecimal string");
+	return `${fingerprint}/${path.replace("m/", "")}`;
+}
+function validateKeyOriginPath(keyOriginPath) {
+	if (keyOriginPath.includes("[") || keyOriginPath.includes("]")) throw new Error("Key origin path should not contain square brackets");
+	if (!keyOriginPath.includes("/")) throw new Error("Key origin path must contain a fingerprint and derivation path");
+	if (!isHexString(extractFingerprintFromKeyOriginPath(keyOriginPath))) throw new Error("Fingerprint must be a hexadecimal string");
+	if (keyOriginPath.split("/").length < 4) throw new Error("Key origin path is too short. Should describe at least to the account level");
+	return true;
+}
+/**
+* @description
+* Creates a descriptor with key origin and xpub or public key
+* @returns `[0a3fd8ef/84'/0'/0']xpuba1b…2c3`
+*/
+function createDescriptor(keyOriginPath, key) {
+	validateKeyOriginPath(keyOriginPath);
+	return `[${keyOriginPath}]${key}`;
+}
+/**
+* @example `[0a3fd8ef/84'/0'/0']xpuba1b…2c3` -> `0a3fd8ef/84'/0'/0'`
+*/
+function extractKeyOriginPathFromDescriptor(descriptor) {
+	const keyOriginPath = descriptor.split("]")[0].replace("[", "");
+	validateKeyOriginPath(keyOriginPath);
+	return keyOriginPath;
+}
+/**
+* @example `[0a3fd8ef/84'/0'/0']xpuba1b…2c3` -> `m/84'/0'/0'`
+*/
+function extractDerivationPathFromDescriptor(descriptor) {
+	return "m/" + extractKeyOriginPathFromDescriptor(descriptor).split("/").slice(1).join("/");
+}
+/**
+* @example `[0a3fd8ef/84'/0'/0']xpuba1b…2c3` -> `0a3fd8ef`
+*/
+function extractFingerprintFromDescriptor(descriptor) {
+	return extractFingerprintFromKeyOriginPath(extractKeyOriginPathFromDescriptor(descriptor));
+}
+/**
+* @example `[0a3fd8ef/84'/0'/6']xpuba1b…2c3` -> `6`
+*/
+function extractAccountIndexFromDescriptor(descriptor) {
+	return extractAccountIndexFromPath(extractKeyOriginPathFromDescriptor(descriptor));
+}
+/**
+* @example `[0a3fd8ef/84'/0'/6']xpuba1b…2c3` -> `xpuba1b…2c3`
+*/
+function extractKeyFromDescriptor(descriptor) {
+	return descriptor.split("]")[1];
+}
+/**
+* @example `0a3fd8ef/84'/0'/0/0/0` -> `0a3fd8ef/84'/0'/0`
+*/
+function extractAccountPathFromFullPath(path) {
+	return path.split("/").slice(0, 4).join("/");
+}
+function keyOriginToDerivationPath(keyOrigin) {
+	const [_fingerprint, ...remainingPath] = keyOrigin.split("/");
+	return `m/${remainingPath.join("/")}`;
+}
+function decomposeDescriptor(descriptor) {
+	return {
+		descriptor,
+		keyOrigin: extractKeyOriginPathFromDescriptor(descriptor),
+		fingerprint: extractFingerprintFromDescriptor(descriptor),
+		derivationPath: extractDerivationPathFromDescriptor(descriptor),
+		accountIndex: extractAccountIndexFromDescriptor(descriptor)
+	};
+}
+
+//#endregion
+//#region src/keychain.ts
+function generateMnemonic() {
+	return generateMnemonic$1(wordlist, 256);
+}
+async function deriveBip39SeedFromMnemonic(mnemonic, passphrase) {
+	return mnemonicToSeed(mnemonic, passphrase);
+}
+/** @deprecated Inaccurately named fn, use `deriveBip39SeedFromMnemonic` */
+const deriveBip39MnemonicFromSeed = deriveBip39SeedFromMnemonic;
+function deriveRootBip32Keychain(seed) {
+	return HDKey.fromMasterSeed(seed);
+}
+async function deriveRootKeychainFromMnemonic(mnemonic, passphrase) {
+	return deriveRootBip32Keychain(await deriveBip39SeedFromMnemonic(mnemonic, passphrase));
+}
+async function deriveChildKeychainFromMnemnonic(path, mnemonic, passphrase) {
+	return deriveRootBip32Keychain(await mnemonicToSeed(mnemonic, passphrase)).derive(keyOriginToDerivationPath(path));
+}
+const deriveKeychainFromXpub = memoize((xpub) => HDKey.fromExtendedKey(xpub));
+/**
+* Gets keychain fingerprint directly from mnemonic. This is useful for
+* referencing a mnemonic safely by an identifier.
+*/
+async function getMnemonicRootKeyFingerprint(mnemonic, passphrase) {
+	return toHexString(deriveRootBip32Keychain(await deriveBip39SeedFromMnemonic(mnemonic, passphrase)).fingerprint);
+}
+function deriveKeychainExtendedPublicKeyDescriptor(rootKeychain, path) {
+	const keyOriginPath = createKeyOriginPath(toHexString(rootKeychain.fingerprint), path);
+	if (rootKeychain.depth !== DerivationPathDepth.Root) throw new Error("Cannot derive account keychain from non-root keychain");
+	return createDescriptor(keyOriginPath, rootKeychain.derive(path).publicExtendedKey);
+}
+function isValidMnemonicWord(word) {
+	return wordlist.includes(word);
+}
+function isValidMnemonic(mnemonic) {
+	return validateMnemonic(mnemonic, wordlist);
+}
+/**
+* Create a unique accountId using wallet's fingerprint and accountIndex
+*/
+function makeAccountIdentifer(fingerprint, accountIndex) {
+	return [fingerprint, accountIndex].join("/");
+}
+
+//#endregion
+export { DerivationPathDepth, appendAddressIndexToPath, createDescriptor, createKeyOriginPath, decomposeDescriptor, deriveBip39MnemonicFromSeed, deriveBip39SeedFromMnemonic, deriveChildKeychainFromMnemnonic, deriveKeychainExtendedPublicKeyDescriptor, deriveKeychainFromXpub, deriveRootBip32Keychain, deriveRootKeychainFromMnemonic, extractAccountIndexFromDescriptor, extractAccountIndexFromPath, extractAccountPathFromFullPath, extractAddressIndexFromPath, extractChangeIndexFromPath, extractDerivationPathFromDescriptor, extractFingerprintFromDescriptor, extractFingerprintFromKeyOriginPath, extractKeyFromDescriptor, extractKeyOriginPathFromDescriptor, extractPurposeFromPath, generateMnemonic, getMnemonicRootKeyFingerprint, isValidMnemonic, isValidMnemonicWord, keyOriginToDerivationPath, makeAccountIdentifer, validateKeyOriginPath };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["scureGenerateMnemonic"],"sources":["../src/derivation-path-utils.ts","../src/keychain.ts"],"sourcesContent":["import { isHexString } from '@leather.io/utils';\n\nexport enum DerivationPathDepth {\n  Root = 0,\n  Purpose = 1,\n  CoinType = 2,\n  Account = 3,\n  Change = 4,\n  AddressIndex = 5,\n}\n\nfunction extractSectionFromDerivationPath(depth: DerivationPathDepth) {\n  return (path: string) => {\n    const segments = path.split('/');\n    const accountNum = parseInt(segments[depth].replaceAll(\"'\", ''), 10);\n    if (isNaN(accountNum)) throw new Error(`Cannot parse ${DerivationPathDepth[depth]} from path`);\n    return accountNum;\n  };\n}\n\nexport const extractPurposeFromPath = extractSectionFromDerivationPath(DerivationPathDepth.Purpose);\n\nexport const extractAccountIndexFromPath = extractSectionFromDerivationPath(\n  DerivationPathDepth.Account\n);\n\nexport const extractChangeIndexFromPath = extractSectionFromDerivationPath(\n  DerivationPathDepth.Change\n);\n\nexport const extractAddressIndexFromPath = extractSectionFromDerivationPath(\n  DerivationPathDepth.AddressIndex\n);\n\nexport function appendAddressIndexToPath(path: string, change: number, addressIndex: number) {\n  const accountIndex = extractAccountIndexFromPath(path);\n  if (!Number.isInteger(accountIndex)) throw new Error('Invalid path, must have account index');\n  return `${path}/${change}/${addressIndex}`;\n}\n\nexport function extractFingerprintFromKeyOriginPath(keyOriginPath: string) {\n  const fingerprint = keyOriginPath.split('/')[0];\n  if (!isHexString(fingerprint)) throw new Error('Fingerprint must be a hexadecimal string');\n  return fingerprint;\n}\n\n/**\n * @description\n * A key origin path refers to the identifier commonly used as part of the key\n * information provided as part of a Output Descriptor described in BIP-380. It\n * replaces the `m/` part of a derivation path with the master key fingerprint to which the\n * key it describes belongs.\n * @example `0a3fd8ef/84'/0'/0'`\n */\nexport function createKeyOriginPath(fingerprint: string, path: string) {\n  if (!isHexString(fingerprint)) throw new Error('Fingerprint must be a hexadecimal string');\n  return `${fingerprint}/${path.replace('m/', '')}`;\n}\n\nexport function validateKeyOriginPath(keyOriginPath: string) {\n  if (keyOriginPath.includes('[') || keyOriginPath.includes(']'))\n    throw new Error('Key origin path should not contain square brackets');\n\n  if (!keyOriginPath.includes('/'))\n    throw new Error('Key origin path must contain a fingerprint and derivation path');\n\n  if (!isHexString(extractFingerprintFromKeyOriginPath(keyOriginPath)))\n    throw new Error('Fingerprint must be a hexadecimal string');\n\n  if (keyOriginPath.split('/').length < 4)\n    throw new Error('Key origin path is too short. Should describe at least to the account level');\n\n  return true;\n}\n\n/**\n * @description\n * Creates a descriptor with key origin and xpub or public key\n * @returns `[0a3fd8ef/84'/0'/0']xpuba1b…2c3`\n */\nexport function createDescriptor(keyOriginPath: string, key: string) {\n  validateKeyOriginPath(keyOriginPath);\n  return `[${keyOriginPath}]${key}`;\n}\n\n/**\n * @example `[0a3fd8ef/84'/0'/0']xpuba1b…2c3` -> `0a3fd8ef/84'/0'/0'`\n */\nexport function extractKeyOriginPathFromDescriptor(descriptor: string) {\n  const keyOriginPath = descriptor.split(']')[0].replace('[', '');\n  validateKeyOriginPath(keyOriginPath);\n  return keyOriginPath;\n}\n\n/**\n * @example `[0a3fd8ef/84'/0'/0']xpuba1b…2c3` -> `m/84'/0'/0'`\n */\nexport function extractDerivationPathFromDescriptor(descriptor: string) {\n  const keyOriginPath = extractKeyOriginPathFromDescriptor(descriptor);\n  return 'm/' + keyOriginPath.split('/').slice(1).join('/');\n}\n\n/**\n * @example `[0a3fd8ef/84'/0'/0']xpuba1b…2c3` -> `0a3fd8ef`\n */\nexport function extractFingerprintFromDescriptor(descriptor: string) {\n  return extractFingerprintFromKeyOriginPath(extractKeyOriginPathFromDescriptor(descriptor));\n}\n\n/**\n * @example `[0a3fd8ef/84'/0'/6']xpuba1b…2c3` -> `6`\n */\nexport function extractAccountIndexFromDescriptor(descriptor: string) {\n  return extractAccountIndexFromPath(extractKeyOriginPathFromDescriptor(descriptor));\n}\n\n/**\n * @example `[0a3fd8ef/84'/0'/6']xpuba1b…2c3` -> `xpuba1b…2c3`\n */\nexport function extractKeyFromDescriptor(descriptor: string) {\n  return descriptor.split(']')[1];\n}\n\n/**\n * @example `0a3fd8ef/84'/0'/0/0/0` -> `0a3fd8ef/84'/0'/0`\n */\nexport function extractAccountPathFromFullPath(path: string) {\n  const segments = path.split('/');\n  return segments.slice(0, 4).join('/');\n}\n\nexport function keyOriginToDerivationPath(keyOrigin: string) {\n  const [_fingerprint, ...remainingPath] = keyOrigin.split('/');\n  return `m/${remainingPath.join('/')}`;\n}\n\nexport function decomposeDescriptor(descriptor: string) {\n  return {\n    descriptor,\n    keyOrigin: extractKeyOriginPathFromDescriptor(descriptor),\n    fingerprint: extractFingerprintFromDescriptor(descriptor),\n    derivationPath: extractDerivationPathFromDescriptor(descriptor),\n    accountIndex: extractAccountIndexFromDescriptor(descriptor),\n  };\n}\n","import { HDKey } from '@scure/bip32';\nimport {\n  mnemonicToSeed,\n  generateMnemonic as scureGenerateMnemonic,\n  validateMnemonic,\n} from '@scure/bip39';\nimport { wordlist } from '@scure/bip39/wordlists/english';\nimport memoize from 'just-memoize';\n\nimport { toHexString } from '@leather.io/utils';\n\nimport {\n  DerivationPathDepth,\n  createDescriptor,\n  createKeyOriginPath,\n  keyOriginToDerivationPath,\n} from './derivation-path-utils';\n\nexport function generateMnemonic() {\n  return scureGenerateMnemonic(wordlist, 256);\n}\n\nexport async function deriveBip39SeedFromMnemonic(mnemonic: string, passphrase?: string) {\n  return mnemonicToSeed(mnemonic, passphrase);\n}\n/** @deprecated Inaccurately named fn, use `deriveBip39SeedFromMnemonic` */\nexport const deriveBip39MnemonicFromSeed = deriveBip39SeedFromMnemonic;\n\nexport function deriveRootBip32Keychain(seed: Uint8Array) {\n  return HDKey.fromMasterSeed(seed);\n}\n\nexport async function deriveRootKeychainFromMnemonic(mnemonic: string, passphrase?: string) {\n  return deriveRootBip32Keychain(await deriveBip39SeedFromMnemonic(mnemonic, passphrase));\n}\n\nexport async function deriveChildKeychainFromMnemnonic(\n  path: string,\n  mnemonic: string,\n  passphrase?: string\n) {\n  const rootKeychain = deriveRootBip32Keychain(await mnemonicToSeed(mnemonic, passphrase));\n  return rootKeychain.derive(keyOriginToDerivationPath(path));\n}\n\nexport const deriveKeychainFromXpub = memoize((xpub: string) => HDKey.fromExtendedKey(xpub));\n\n/**\n * Gets keychain fingerprint directly from mnemonic. This is useful for\n * referencing a mnemonic safely by an identifier.\n */\nexport async function getMnemonicRootKeyFingerprint(mnemonic: string, passphrase?: string) {\n  const keychain = deriveRootBip32Keychain(await deriveBip39SeedFromMnemonic(mnemonic, passphrase));\n  return toHexString(keychain.fingerprint);\n}\n\nexport function deriveKeychainExtendedPublicKeyDescriptor(rootKeychain: HDKey, path: string) {\n  const masterFingerprint = toHexString(rootKeychain.fingerprint);\n  const keyOriginPath = createKeyOriginPath(masterFingerprint, path);\n\n  if (rootKeychain.depth !== DerivationPathDepth.Root)\n    throw new Error('Cannot derive account keychain from non-root keychain');\n\n  const accountKeychain = rootKeychain.derive(path);\n  return createDescriptor(keyOriginPath, accountKeychain.publicExtendedKey);\n}\n\nexport function isValidMnemonicWord(word: string): boolean {\n  return wordlist.includes(word);\n}\n\nexport function isValidMnemonic(mnemonic: string): boolean {\n  return validateMnemonic(mnemonic, wordlist);\n}\n/**\n * Create a unique accountId using wallet's fingerprint and accountIndex\n */\nexport function makeAccountIdentifer(fingerprint: string, accountIndex: number) {\n  return [fingerprint, accountIndex].join('/');\n}\n"],"mappings":"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"}

package/package.json

@@ -2,30 +2,37 @@
   "name": "@leather.io/crypto",
   "author": "leather.io",
   "description": "Generic crypto utils package for Leather",
-  "version": "1.12.7",
+  "version": "1.12.8",
   "license": "MIT",
+  "type": "module",
   "exports": {
-    ".": "./dist/index.mjs"
+    ".": "./dist/index.js"
   },
   "dependencies": {
     "@scure/bip32": "1.6.2",
     "@scure/bip39": "1.5.4",
     "just-memoize": "2.2.0",
-    "@leather.io/utils": "0.49.1"
+    "@leather.io/utils": "0.49.2"
   },
   "devDependencies": {
-    "tsup": "8.4.0",
-    "vitest": "2.1.9"
+    "prettier": "3.5.1",
+    "tsdown": "0.16.5",
+    "vitest": "2.1.9",
+    "@leather.io/test-config": "0.1.1",
+    "@leather.io/prettier-config": "0.9.0"
   },
   "files": [
     "dist"
   ],
+  "prettier": "@leather.io/prettier-config",
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
-    "build:watch": "tsup --watch --onSuccess 'tsup --dts-only'",
+    "build": "tsdown",
+    "build:watch": "tsdown --watch",
+    "format": "prettier . --write --ignore-path ../../.prettierignore",
+    "format:check": "prettier . --check --ignore-path ../../.prettierignore",
     "prepublish": "pnpm build",
     "test:coverage": "vitest run --coverage",
     "test:unit": "vitest run",

package/dist/index.mjs

@@ -1,176 +0,0 @@
-// src/derivation-path-utils.ts
-import { isHexString } from "@leather.io/utils";
-var DerivationPathDepth = /* @__PURE__ */ ((DerivationPathDepth2) => {
-  DerivationPathDepth2[DerivationPathDepth2["Root"] = 0] = "Root";
-  DerivationPathDepth2[DerivationPathDepth2["Purpose"] = 1] = "Purpose";
-  DerivationPathDepth2[DerivationPathDepth2["CoinType"] = 2] = "CoinType";
-  DerivationPathDepth2[DerivationPathDepth2["Account"] = 3] = "Account";
-  DerivationPathDepth2[DerivationPathDepth2["Change"] = 4] = "Change";
-  DerivationPathDepth2[DerivationPathDepth2["AddressIndex"] = 5] = "AddressIndex";
-  return DerivationPathDepth2;
-})(DerivationPathDepth || {});
-function extractSectionFromDerivationPath(depth) {
-  return (path) => {
-    const segments = path.split("/");
-    const accountNum = parseInt(segments[depth].replaceAll("'", ""), 10);
-    if (isNaN(accountNum)) throw new Error(`Cannot parse ${DerivationPathDepth[depth]} from path`);
-    return accountNum;
-  };
-}
-var extractPurposeFromPath = extractSectionFromDerivationPath(1 /* Purpose */);
-var extractAccountIndexFromPath = extractSectionFromDerivationPath(
-  3 /* Account */
-);
-var extractChangeIndexFromPath = extractSectionFromDerivationPath(
-  4 /* Change */
-);
-var extractAddressIndexFromPath = extractSectionFromDerivationPath(
-  5 /* AddressIndex */
-);
-function appendAddressIndexToPath(path, change, addressIndex) {
-  const accountIndex = extractAccountIndexFromPath(path);
-  if (!Number.isInteger(accountIndex)) throw new Error("Invalid path, must have account index");
-  return `${path}/${change}/${addressIndex}`;
-}
-function extractFingerprintFromKeyOriginPath(keyOriginPath) {
-  const fingerprint = keyOriginPath.split("/")[0];
-  if (!isHexString(fingerprint)) throw new Error("Fingerprint must be a hexadecimal string");
-  return fingerprint;
-}
-function createKeyOriginPath(fingerprint, path) {
-  if (!isHexString(fingerprint)) throw new Error("Fingerprint must be a hexadecimal string");
-  return `${fingerprint}/${path.replace("m/", "")}`;
-}
-function validateKeyOriginPath(keyOriginPath) {
-  if (keyOriginPath.includes("[") || keyOriginPath.includes("]"))
-    throw new Error("Key origin path should not contain square brackets");
-  if (!keyOriginPath.includes("/"))
-    throw new Error("Key origin path must contain a fingerprint and derivation path");
-  if (!isHexString(extractFingerprintFromKeyOriginPath(keyOriginPath)))
-    throw new Error("Fingerprint must be a hexadecimal string");
-  if (keyOriginPath.split("/").length < 4)
-    throw new Error("Key origin path is too short. Should describe at least to the account level");
-  return true;
-}
-function createDescriptor(keyOriginPath, key) {
-  validateKeyOriginPath(keyOriginPath);
-  return `[${keyOriginPath}]${key}`;
-}
-function extractKeyOriginPathFromDescriptor(descriptor) {
-  const keyOriginPath = descriptor.split("]")[0].replace("[", "");
-  validateKeyOriginPath(keyOriginPath);
-  return keyOriginPath;
-}
-function extractDerivationPathFromDescriptor(descriptor) {
-  const keyOriginPath = extractKeyOriginPathFromDescriptor(descriptor);
-  return "m/" + keyOriginPath.split("/").slice(1).join("/");
-}
-function extractFingerprintFromDescriptor(descriptor) {
-  return extractFingerprintFromKeyOriginPath(extractKeyOriginPathFromDescriptor(descriptor));
-}
-function extractAccountIndexFromDescriptor(descriptor) {
-  return extractAccountIndexFromPath(extractKeyOriginPathFromDescriptor(descriptor));
-}
-function extractKeyFromDescriptor(descriptor) {
-  return descriptor.split("]")[1];
-}
-function extractAccountPathFromFullPath(path) {
-  const segments = path.split("/");
-  return segments.slice(0, 4).join("/");
-}
-function keyOriginToDerivationPath(keyOrigin) {
-  const [_fingerprint, ...remainingPath] = keyOrigin.split("/");
-  return `m/${remainingPath.join("/")}`;
-}
-function decomposeDescriptor(descriptor) {
-  return {
-    descriptor,
-    keyOrigin: extractKeyOriginPathFromDescriptor(descriptor),
-    fingerprint: extractFingerprintFromDescriptor(descriptor),
-    derivationPath: extractDerivationPathFromDescriptor(descriptor),
-    accountIndex: extractAccountIndexFromDescriptor(descriptor)
-  };
-}
-
-// src/keychain.ts
-import { HDKey } from "@scure/bip32";
-import {
-  mnemonicToSeed,
-  generateMnemonic as scureGenerateMnemonic,
-  validateMnemonic
-} from "@scure/bip39";
-import { wordlist } from "@scure/bip39/wordlists/english";
-import memoize from "just-memoize";
-import { toHexString } from "@leather.io/utils";
-function generateMnemonic() {
-  return scureGenerateMnemonic(wordlist, 256);
-}
-async function deriveBip39SeedFromMnemonic(mnemonic, passphrase) {
-  return mnemonicToSeed(mnemonic, passphrase);
-}
-var deriveBip39MnemonicFromSeed = deriveBip39SeedFromMnemonic;
-function deriveRootBip32Keychain(seed) {
-  return HDKey.fromMasterSeed(seed);
-}
-async function deriveRootKeychainFromMnemonic(mnemonic, passphrase) {
-  return deriveRootBip32Keychain(await deriveBip39SeedFromMnemonic(mnemonic, passphrase));
-}
-async function deriveChildKeychainFromMnemnonic(path, mnemonic, passphrase) {
-  const rootKeychain = deriveRootBip32Keychain(await mnemonicToSeed(mnemonic, passphrase));
-  return rootKeychain.derive(keyOriginToDerivationPath(path));
-}
-var deriveKeychainFromXpub = memoize((xpub) => HDKey.fromExtendedKey(xpub));
-async function getMnemonicRootKeyFingerprint(mnemonic, passphrase) {
-  const keychain = deriveRootBip32Keychain(await deriveBip39SeedFromMnemonic(mnemonic, passphrase));
-  return toHexString(keychain.fingerprint);
-}
-function deriveKeychainExtendedPublicKeyDescriptor(rootKeychain, path) {
-  const masterFingerprint = toHexString(rootKeychain.fingerprint);
-  const keyOriginPath = createKeyOriginPath(masterFingerprint, path);
-  if (rootKeychain.depth !== 0 /* Root */)
-    throw new Error("Cannot derive account keychain from non-root keychain");
-  const accountKeychain = rootKeychain.derive(path);
-  return createDescriptor(keyOriginPath, accountKeychain.publicExtendedKey);
-}
-function isValidMnemonicWord(word) {
-  return wordlist.includes(word);
-}
-function isValidMnemonic(mnemonic) {
-  return validateMnemonic(mnemonic, wordlist);
-}
-function makeAccountIdentifer(fingerprint, accountIndex) {
-  return [fingerprint, accountIndex].join("/");
-}
-export {
-  DerivationPathDepth,
-  appendAddressIndexToPath,
-  createDescriptor,
-  createKeyOriginPath,
-  decomposeDescriptor,
-  deriveBip39MnemonicFromSeed,
-  deriveBip39SeedFromMnemonic,
-  deriveChildKeychainFromMnemnonic,
-  deriveKeychainExtendedPublicKeyDescriptor,
-  deriveKeychainFromXpub,
-  deriveRootBip32Keychain,
-  deriveRootKeychainFromMnemonic,
-  extractAccountIndexFromDescriptor,
-  extractAccountIndexFromPath,
-  extractAccountPathFromFullPath,
-  extractAddressIndexFromPath,
-  extractChangeIndexFromPath,
-  extractDerivationPathFromDescriptor,
-  extractFingerprintFromDescriptor,
-  extractFingerprintFromKeyOriginPath,
-  extractKeyFromDescriptor,
-  extractKeyOriginPathFromDescriptor,
-  extractPurposeFromPath,
-  generateMnemonic,
-  getMnemonicRootKeyFingerprint,
-  isValidMnemonic,
-  isValidMnemonicWord,
-  keyOriginToDerivationPath,
-  makeAccountIdentifer,
-  validateKeyOriginPath
-};
-//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/derivation-path-utils.ts","../src/keychain.ts"],"sourcesContent":["import { isHexString } from '@leather.io/utils';\n\nexport enum DerivationPathDepth {\n  Root = 0,\n  Purpose = 1,\n  CoinType = 2,\n  Account = 3,\n  Change = 4,\n  AddressIndex = 5,\n}\n\nfunction extractSectionFromDerivationPath(depth: DerivationPathDepth) {\n  return (path: string) => {\n    const segments = path.split('/');\n    const accountNum = parseInt(segments[depth].replaceAll(\"'\", ''), 10);\n    if (isNaN(accountNum)) throw new Error(`Cannot parse ${DerivationPathDepth[depth]} from path`);\n    return accountNum;\n  };\n}\n\nexport const extractPurposeFromPath = extractSectionFromDerivationPath(DerivationPathDepth.Purpose);\n\nexport const extractAccountIndexFromPath = extractSectionFromDerivationPath(\n  DerivationPathDepth.Account\n);\n\nexport const extractChangeIndexFromPath = extractSectionFromDerivationPath(\n  DerivationPathDepth.Change\n);\n\nexport const extractAddressIndexFromPath = extractSectionFromDerivationPath(\n  DerivationPathDepth.AddressIndex\n);\n\nexport function appendAddressIndexToPath(path: string, change: number, addressIndex: number) {\n  const accountIndex = extractAccountIndexFromPath(path);\n  if (!Number.isInteger(accountIndex)) throw new Error('Invalid path, must have account index');\n  return `${path}/${change}/${addressIndex}`;\n}\n\nexport function extractFingerprintFromKeyOriginPath(keyOriginPath: string) {\n  const fingerprint = keyOriginPath.split('/')[0];\n  if (!isHexString(fingerprint)) throw new Error('Fingerprint must be a hexadecimal string');\n  return fingerprint;\n}\n\n/**\n * @description\n * A key origin path refers to the identifier commonly used as part of the key\n * information provided as part of a Output Descriptor described in BIP-380. It\n * replaces the `m/` part of a derivation path with the master key fingerprint to which the\n * key it describes belongs.\n * @example `0a3fd8ef/84'/0'/0'`\n */\nexport function createKeyOriginPath(fingerprint: string, path: string) {\n  if (!isHexString(fingerprint)) throw new Error('Fingerprint must be a hexadecimal string');\n  return `${fingerprint}/${path.replace('m/', '')}`;\n}\n\nexport function validateKeyOriginPath(keyOriginPath: string) {\n  if (keyOriginPath.includes('[') || keyOriginPath.includes(']'))\n    throw new Error('Key origin path should not contain square brackets');\n\n  if (!keyOriginPath.includes('/'))\n    throw new Error('Key origin path must contain a fingerprint and derivation path');\n\n  if (!isHexString(extractFingerprintFromKeyOriginPath(keyOriginPath)))\n    throw new Error('Fingerprint must be a hexadecimal string');\n\n  if (keyOriginPath.split('/').length < 4)\n    throw new Error('Key origin path is too short. Should describe at least to the account level');\n\n  return true;\n}\n\n/**\n * @description\n * Creates a descriptor with key origin and xpub or public key\n * @returns `[0a3fd8ef/84'/0'/0']xpuba1b…2c3`\n */\nexport function createDescriptor(keyOriginPath: string, key: string) {\n  validateKeyOriginPath(keyOriginPath);\n  return `[${keyOriginPath}]${key}`;\n}\n\n/**\n * @example `[0a3fd8ef/84'/0'/0']xpuba1b…2c3` -> `0a3fd8ef/84'/0'/0'`\n */\nexport function extractKeyOriginPathFromDescriptor(descriptor: string) {\n  const keyOriginPath = descriptor.split(']')[0].replace('[', '');\n  validateKeyOriginPath(keyOriginPath);\n  return keyOriginPath;\n}\n\n/**\n * @example `[0a3fd8ef/84'/0'/0']xpuba1b…2c3` -> `m/84'/0'/0'`\n */\nexport function extractDerivationPathFromDescriptor(descriptor: string) {\n  const keyOriginPath = extractKeyOriginPathFromDescriptor(descriptor);\n  return 'm/' + keyOriginPath.split('/').slice(1).join('/');\n}\n\n/**\n * @example `[0a3fd8ef/84'/0'/0']xpuba1b…2c3` -> `0a3fd8ef`\n */\nexport function extractFingerprintFromDescriptor(descriptor: string) {\n  return extractFingerprintFromKeyOriginPath(extractKeyOriginPathFromDescriptor(descriptor));\n}\n\n/**\n * @example `[0a3fd8ef/84'/0'/6']xpuba1b…2c3` -> `6`\n */\nexport function extractAccountIndexFromDescriptor(descriptor: string) {\n  return extractAccountIndexFromPath(extractKeyOriginPathFromDescriptor(descriptor));\n}\n\n/**\n * @example `[0a3fd8ef/84'/0'/6']xpuba1b…2c3` -> `xpuba1b…2c3`\n */\nexport function extractKeyFromDescriptor(descriptor: string) {\n  return descriptor.split(']')[1];\n}\n\n/**\n * @example `0a3fd8ef/84'/0'/0/0/0` -> `0a3fd8ef/84'/0'/0`\n */\nexport function extractAccountPathFromFullPath(path: string) {\n  const segments = path.split('/');\n  return segments.slice(0, 4).join('/');\n}\n\nexport function keyOriginToDerivationPath(keyOrigin: string) {\n  const [_fingerprint, ...remainingPath] = keyOrigin.split('/');\n  return `m/${remainingPath.join('/')}`;\n}\n\nexport function decomposeDescriptor(descriptor: string) {\n  return {\n    descriptor,\n    keyOrigin: extractKeyOriginPathFromDescriptor(descriptor),\n    fingerprint: extractFingerprintFromDescriptor(descriptor),\n    derivationPath: extractDerivationPathFromDescriptor(descriptor),\n    accountIndex: extractAccountIndexFromDescriptor(descriptor),\n  };\n}\n","import { HDKey } from '@scure/bip32';\nimport {\n  mnemonicToSeed,\n  generateMnemonic as scureGenerateMnemonic,\n  validateMnemonic,\n} from '@scure/bip39';\nimport { wordlist } from '@scure/bip39/wordlists/english';\nimport memoize from 'just-memoize';\n\nimport { toHexString } from '@leather.io/utils';\n\nimport {\n  DerivationPathDepth,\n  createDescriptor,\n  createKeyOriginPath,\n  keyOriginToDerivationPath,\n} from './derivation-path-utils';\n\nexport function generateMnemonic() {\n  return scureGenerateMnemonic(wordlist, 256);\n}\n\nexport async function deriveBip39SeedFromMnemonic(mnemonic: string, passphrase?: string) {\n  return mnemonicToSeed(mnemonic, passphrase);\n}\n/** @deprecated Inaccurately named fn, use `deriveBip39SeedFromMnemonic` */\nexport const deriveBip39MnemonicFromSeed = deriveBip39SeedFromMnemonic;\n\nexport function deriveRootBip32Keychain(seed: Uint8Array) {\n  return HDKey.fromMasterSeed(seed);\n}\n\nexport async function deriveRootKeychainFromMnemonic(mnemonic: string, passphrase?: string) {\n  return deriveRootBip32Keychain(await deriveBip39SeedFromMnemonic(mnemonic, passphrase));\n}\n\nexport async function deriveChildKeychainFromMnemnonic(\n  path: string,\n  mnemonic: string,\n  passphrase?: string\n) {\n  const rootKeychain = deriveRootBip32Keychain(await mnemonicToSeed(mnemonic, passphrase));\n  return rootKeychain.derive(keyOriginToDerivationPath(path));\n}\n\nexport const deriveKeychainFromXpub = memoize((xpub: string) => HDKey.fromExtendedKey(xpub));\n\n/**\n * Gets keychain fingerprint directly from mnemonic. This is useful for\n * referencing a mnemonic safely by an identifier.\n */\nexport async function getMnemonicRootKeyFingerprint(mnemonic: string, passphrase?: string) {\n  const keychain = deriveRootBip32Keychain(await deriveBip39SeedFromMnemonic(mnemonic, passphrase));\n  return toHexString(keychain.fingerprint);\n}\n\nexport function deriveKeychainExtendedPublicKeyDescriptor(rootKeychain: HDKey, path: string) {\n  const masterFingerprint = toHexString(rootKeychain.fingerprint);\n  const keyOriginPath = createKeyOriginPath(masterFingerprint, path);\n\n  if (rootKeychain.depth !== DerivationPathDepth.Root)\n    throw new Error('Cannot derive account keychain from non-root keychain');\n\n  const accountKeychain = rootKeychain.derive(path);\n  return createDescriptor(keyOriginPath, accountKeychain.publicExtendedKey);\n}\n\nexport function isValidMnemonicWord(word: string): boolean {\n  return wordlist.includes(word);\n}\n\nexport function isValidMnemonic(mnemonic: string): boolean {\n  return validateMnemonic(mnemonic, wordlist);\n}\n/**\n * Create a unique accountId using wallet's fingerprint and accountIndex\n */\nexport function makeAccountIdentifer(fingerprint: string, accountIndex: number) {\n  return [fingerprint, accountIndex].join('/');\n}\n"],"mappings":"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","names":["DerivationPathDepth"]}