Add isValidBIP32Path function

Author: Mrtenz

src/constants.ts

@@ -19,6 +19,8 @@ export type BIP44Depth = MinBIP44Depth | 1 | 2 | 3 | 4 | MaxBIP44Depth;
 // always "0". Here's an example Ethereum HD path for account "0":
 // m  / 44' / 60' / 0' / 0 / 0
 
+export type UnprefixedNode = `${number}'`;
+
 export type AnonymizedBIP39Node = 'm';
 export type BIP39StringNode = `bip39:${string}`;
 export type BIP39Node = BIP39StringNode | Uint8Array;
@@ -35,6 +37,13 @@ export const BIP44PurposeNodeToken = `bip32:44'`;
 
 export const UNPREFIXED_PATH_REGEX = /^\d+$/u;
 
+/**
+ * e.g.
+ * -  0
+ * -  0'
+ */
+export const UNPREFIXED_BIP_32_PATH_REGEX = /^(?<index>\d+)'?$/u;
+
 /**
  * e.g.
  * -  bip32:0

src/index.ts

@@ -28,4 +28,4 @@ export {
   getBIP44AddressKeyDeriver,
 } from './BIP44CoinTypeNode';
 export * from './constants';
-export type { CoinTypeToAddressIndices } from './utils';
+export type { CoinTypeToAddressIndices, isValidBIP32Path } from './utils';

src/utils.test.ts

@@ -23,6 +23,7 @@ import {
   decodeBase58check,
   mnemonicPhraseToBytes,
   getBytesUnsafe,
+  isValidBIP32Path,
 } from './utils';
 
 // Inputs used for testing non-negative integers
@@ -197,6 +198,24 @@ describe('isValidBIP32Index', () => {
   });
 });
 
+describe('isValidBIP32Path', () => {
+  it('returns true if the path is valid', () => {
+    expect(isValidBIP32Path(`0`)).toBe(true);
+    expect(isValidBIP32Path(`0'`)).toBe(true);
+    expect(isValidBIP32Path(`1`)).toBe(true);
+    expect(isValidBIP32Path(`1'`)).toBe(true);
+    expect(isValidBIP32Path(`1000`)).toBe(true);
+    expect(isValidBIP32Path(`1000'`)).toBe(true);
+  });
+
+  it.each(['foo', `123''`, `'123'`, `123'/456'`])(
+    'returns false if the index is invalid',
+    (input) => {
+      expect(isValidBIP32Path(input)).toBe(false);
+    },
+  );
+});
+
 describe('isHardened', () => {
   it('returns true if the index is hardened', () => {
     expect(isHardened(`0'`)).toBe(true);

src/utils.ts

@@ -13,6 +13,8 @@ import {
   HardenedBIP32Node,
   MAX_BIP_32_INDEX,
   UnhardenedBIP32Node,
+  UNPREFIXED_BIP_32_PATH_REGEX,
+  UnprefixedNode,
 } from './constants';
 import { curves, SupportedCurve } from './curves';
 
@@ -170,6 +172,27 @@ export function isValidBIP32Index(index: number): boolean {
   return isValidInteger(index) && index <= MAX_BIP_32_INDEX;
 }
 
+/**
+ * Check if the value is a valid BIP-32 path, i.e., a string of the form
+ * `0'`.
+ *
+ * @param path - The BIP-32 path to test.
+ * @returns Whether the path is a valid BIP-32 path.
+ */
+export function isValidBIP32Path(path: string): path is UnprefixedNode {
+  if (typeof path !== 'string') {
+    return false;
+  }
+
+  const match = path.match(UNPREFIXED_BIP_32_PATH_REGEX);
+  if (!match?.groups) {
+    return false;
+  }
+
+  const index = parseInt(match.groups.index, 10);
+  return isValidBIP32Index(index);
+}
+
 /**
  * Check if the value is a hardened BIP-32 index. This only checks if the value
  * ends with a `'` character, and does not validate that the index is a valid