@leather.io/crypto 1.4.2 → 1.5.0

package/dist/index.d.mts

@@ -10,6 +10,7 @@ declare enum DerivationPathDepth {
 }
 declare const extractAccountIndexFromPath: (path: string) => number;
 declare const extractAddressIndexFromPath: (path: string) => number;
+declare function addAddressIndexToPath(path: string, index: number): string;
 declare function extractFingerprintFromKeyOriginPath(keyOriginPath: string): string;
 /**
  * @description
@@ -47,12 +48,20 @@ declare function extractAccountIndexFromDescriptor(descriptor: string): number;
  * @example `[0a3fd8ef/84'/0'/6']xpuba1b…2c3` -> `xpuba1b…2c3`
  */
 declare function extractKeyFromDescriptor(descriptor: string): string;
+declare function decomposeDescriptor(descriptor: string): {
+    descriptor: string;
+    keyOrigin: string;
+    fingerprint: string;
+    derivationPath: string;
+    accountIndex: number;
+};
 
 declare function generateMnemonic(): string;
 declare function deriveBip39SeedFromMnemonic(mnemonic: string, passphrase?: string): Promise<Uint8Array>;
 /** @deprecated Inaccurately named fn, use `deriveBip39SeedFromMnemonic` */
 declare const deriveBip39MnemonicFromSeed: typeof deriveBip39SeedFromMnemonic;
 declare function deriveRootBip32Keychain(seed: Uint8Array): HDKey;
+declare function deriveRootKeychainFromMnemonic(mnemonic: string, passphrase?: string): Promise<HDKey>;
 declare function deriveKeychainFromXpub(xpub: string): HDKey;
 /**
  * Gets keychain fingerprint directly from mnemonic. This is useful for
@@ -63,4 +72,12 @@ declare function deriveKeychainExtendedPublicKeyDescriptor(rootKeychain: HDKey,
 declare function isValidMnemonicWord(word: string): boolean;
 declare function isValidMnemonic(mnemonic: string): boolean;
 
-export { DerivationPathDepth, createDescriptor, createKeyOriginPath, deriveBip39MnemonicFromSeed, deriveBip39SeedFromMnemonic, deriveKeychainExtendedPublicKeyDescriptor, deriveKeychainFromXpub, deriveRootBip32Keychain, extractAccountIndexFromDescriptor, extractAccountIndexFromPath, extractAddressIndexFromPath, extractDerivationPathFromDescriptor, extractFingerprintFromDescriptor, extractFingerprintFromKeyOriginPath, extractKeyFromDescriptor, extractKeyOriginPathFromDescriptor, generateMnemonic, getMnemonicRootKeyFingerprint, isValidMnemonic, isValidMnemonicWord, validateKeyOriginPath };
+type SignFn<T> = (tx: T, ...args: unknown[]) => Promise<T>;
+interface Signer {
+    sign: SignFn<any>;
+    address: string;
+    publicKey: Uint8Array;
+    derivationPath: string;
+}
+
+export { DerivationPathDepth, type Signer, addAddressIndexToPath, createDescriptor, createKeyOriginPath, decomposeDescriptor, deriveBip39MnemonicFromSeed, deriveBip39SeedFromMnemonic, deriveKeychainExtendedPublicKeyDescriptor, deriveKeychainFromXpub, deriveRootBip32Keychain, deriveRootKeychainFromMnemonic, extractAccountIndexFromDescriptor, extractAccountIndexFromPath, extractAddressIndexFromPath, extractDerivationPathFromDescriptor, extractFingerprintFromDescriptor, extractFingerprintFromKeyOriginPath, extractKeyFromDescriptor, extractKeyOriginPathFromDescriptor, generateMnemonic, getMnemonicRootKeyFingerprint, isValidMnemonic, isValidMnemonicWord, validateKeyOriginPath };

package/dist/index.mjs

@@ -23,6 +23,12 @@ var extractAccountIndexFromPath = extractSectionFromDerivationPath(
 var extractAddressIndexFromPath = extractSectionFromDerivationPath(
   5 /* AddressIndex */
 );
+function addAddressIndexToPath(path, index) {
+  const accountIndex = extractAccountIndexFromPath(path);
+  if (!Number.isInteger(accountIndex)) throw new Error("Invalid path, must have account index");
+  const assumedReceiveChangeIndex = 0;
+  return `${path}/${assumedReceiveChangeIndex}/${index}`;
+}
 function extractFingerprintFromKeyOriginPath(keyOriginPath) {
   const fingerprint = keyOriginPath.split("/")[0];
   if (!isHexString(fingerprint)) throw new Error("Fingerprint must be a hexadecimal string");
@@ -65,6 +71,15 @@ function extractAccountIndexFromDescriptor(descriptor) {
 function extractKeyFromDescriptor(descriptor) {
   return descriptor.split("]")[1];
 }
+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";
@@ -85,6 +100,9 @@ var deriveBip39MnemonicFromSeed = deriveBip39SeedFromMnemonic;
 function deriveRootBip32Keychain(seed) {
   return HDKey.fromMasterSeed(seed);
 }
+async function deriveRootKeychainFromMnemonic(mnemonic, passphrase) {
+  return deriveRootBip32Keychain(await deriveBip39SeedFromMnemonic(mnemonic, passphrase));
+}
 function deriveKeychainFromXpub(xpub) {
   return HDKey.fromExtendedKey(xpub);
 }
@@ -108,13 +126,16 @@ function isValidMnemonic(mnemonic) {
 }
 export {
   DerivationPathDepth,
+  addAddressIndexToPath,
   createDescriptor,
   createKeyOriginPath,
+  decomposeDescriptor,
   deriveBip39MnemonicFromSeed,
   deriveBip39SeedFromMnemonic,
   deriveKeychainExtendedPublicKeyDescriptor,
   deriveKeychainFromXpub,
   deriveRootBip32Keychain,
+  deriveRootKeychainFromMnemonic,
   extractAccountIndexFromDescriptor,
   extractAccountIndexFromPath,
   extractAddressIndexFromPath,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"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  ChangeReceive = 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 extractAccountIndexFromPath = extractSectionFromDerivationPath(\n  DerivationPathDepth.Account\n);\n\nexport const extractAddressIndexFromPath = extractSectionFromDerivationPath(\n  DerivationPathDepth.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","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';\n\nimport { toHexString } from '@leather.io/utils';\n\nimport {\n  DerivationPathDepth,\n  createDescriptor,\n  createKeyOriginPath,\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 function deriveKeychainFromXpub(xpub: string) {\n  return HDKey.fromExtendedKey(xpub);\n}\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"],"mappings":"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","names":["DerivationPathDepth"]}
+{"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  ChangeReceive = 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 extractAccountIndexFromPath = extractSectionFromDerivationPath(\n  DerivationPathDepth.Account\n);\n\nexport const extractAddressIndexFromPath = extractSectionFromDerivationPath(\n  DerivationPathDepth.AddressIndex\n);\n\nexport function addAddressIndexToPath(path: string, index: number) {\n  const accountIndex = extractAccountIndexFromPath(path);\n  if (!Number.isInteger(accountIndex)) throw new Error('Invalid path, must have account index');\n  const assumedReceiveChangeIndex = 0;\n  return `${path}/${assumedReceiveChangeIndex}/${index}`;\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\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';\n\nimport { toHexString } from '@leather.io/utils';\n\nimport {\n  DerivationPathDepth,\n  createDescriptor,\n  createKeyOriginPath,\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 function deriveKeychainFromXpub(xpub: string) {\n  return HDKey.fromExtendedKey(xpub);\n}\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"],"mappings":"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","names":["DerivationPathDepth"]}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@leather.io/crypto",
   "author": "leather.io",
   "description": "Generic crypto utils package for Leather",
-  "version": "1.4.2",
+  "version": "1.5.0",
   "license": "MIT",
   "exports": {
     ".": "./dist/index.mjs"
@@ -10,7 +10,7 @@
   "dependencies": {
     "@scure/bip32": "1.4.0",
     "@scure/bip39": "1.3.0",
-    "@leather.io/utils": "0.13.2"
+    "@leather.io/utils": "0.13.3"
   },
   "devDependencies": {
     "@vitest/coverage-istanbul": "0.34.6",