mainnet-js 0.4.28 → 0.4.32

package/src/constant.ts

@@ -8,3 +8,20 @@ export const MEMPOOL_CHAIN_LIMIT = 50;
 
 // time in milliseconds to cache the usd exchange rate
 export const EXCHANGE_RATE_TTL = 250000;
+
+// list of common derivation paths
+// a la: https://github.com/Electron-Cash/Electron-Cash/blob/1de24c509992cfebc22217a2a77c862c2b02bc54/electroncash_gui/qt/installwizard.py#L624
+export const DERIVATION_PATHS = [
+  "m/0",
+  "m/0'",
+  "m/0'/0",
+  "m/0'/0'",
+  "m/0'/0'/0'",
+  "m/44'/0'/0'",
+  "m/44'/0'/0'/0",
+  "m/44'/145'/0'",
+  "m/44'/145'/0'/0",
+  "m/44'/245'/0",
+  "m/44'/245'/0'",
+  "m/44'/245'/0'/0",
+];

package/src/util/getAddrsByXpubKey.test.ts

@@ -0,0 +1,115 @@
+import {
+  derivePublicNodeCashaddr,
+  getAddrsByXpubKey,
+  getXpubKeyInfo,
+} from "./getAddrsByXpubKey";
+
+test("Should decode xpubInfo", async () => {
+  let xpub =
+    "xpub6BosfCnifzxcFwrSzQiqu2DBVTshkCXacvNsWGYJVVhhawA7d4R5WSWGFNbi8Aw6ZRc1brxMyWMzG3DSSSSoekkudhUd9yLb6qx39T9nMdj";
+  let xpubInfo = await getXpubKeyInfo(xpub);
+  expect(xpubInfo.version).toBe("mainnet");
+  expect(xpubInfo.depth).toBe(3);
+  expect(xpubInfo.parentFingerprint).toBe("155bca59");
+  expect(xpubInfo.childNumber).toBe(2147483648);
+  expect(xpubInfo.chain).toBe(
+    "3da4bc190a2680111d31fadfdc905f2a7f6ce77c6f109919116f253d43445219"
+  );
+  expect(xpubInfo.data).toBe(
+    "03774c910fcf07fa96886ea794f0d5caed9afe30b44b83f7e213bb92930e7df4bd"
+  );
+  expect(xpubInfo.fingerprint).toBe("6cc9f252");
+});
+
+test("Should derive cashaddr given xpub and path", async () => {
+  // abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about
+  // m/0
+  const xpub =
+    "xpub6F2iaK2JUPcgrZ6RTGH6t8VybLPu1XzfrHsDsaKvK6NfULznU6i6aw6ZoefDW2DpNruSLw73RwQg46qvpqB3eryeJJ2tkFCF4Z6gbr8Pjja";
+  const vectors = [
+    //  M/44'/145'/0'/0/0
+    "bitcoincash:qqyx49mu0kkn9ftfj6hje6g2wfer34yfnq5tahq3q6",
+    //  M/44'/145'/0'/0/1
+    "bitcoincash:qp8sfdhgjlq68hlzka9lcsxtcnvuvnd0xqxugfzzc5",
+    //  M/44'/145'/0'/0/2
+    "bitcoincash:qqkuy34ntrye9a2h4xpdstcu4aq5wfrwscjtaphenr",
+  ];
+
+  for (let i = 0; i < vectors.length; i++) {
+    // M/44'/145'/0'/0/
+    const publicNode = await derivePublicNodeCashaddr(xpub, 0, `M/${i}`);
+    expect(publicNode).toBe(vectors[i]);
+  }
+});
+
+test("Should derive list of cashaddrs from m/44'/0'/0' given xpub path, & limit", async () => {
+  // abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about
+  // m/44'/0'/0'
+  const xpub =
+    "xpub6BosfCnifzxcFwrSzQiqu2DBVTshkCXacvNsWGYJVVhhawA7d4R5WSWGFNbi8Aw6ZRc1brxMyWMzG3DSSSSoekkudhUd9yLb6qx39T9nMdj";
+  const vectors = [
+    // m/44'/0'/0'/0/0
+    "bitcoincash:qrvcdmgpk73zyfd8pmdl9wnuld36zh9n4gms8s0u59",
+    // m/44'/0'/0'/0/1
+    "bitcoincash:qp4wzvqu73x22ft4r5tk8tz0aufdz9fescwtpcmhc7",
+    // m/44'/0'/0'/0/2
+    "bitcoincash:qr0kwqzf2h3wvjjhn4pg895lrxwp96wqgyhkksq2nh",
+  ];
+
+  // M/44'/0'/0'/0/i
+  const cashaddrs = await getAddrsByXpubKey(xpub, "0/0", 3);
+  expect(cashaddrs).toStrictEqual(vectors);
+});
+
+test("Should derive list of change cashaddrs from m/44'/0'/0' given xpub path, & limit", async () => {
+  // abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about
+  // m/44'/0'/0'
+  const xpub =
+    "xpub6BosfCnifzxcFwrSzQiqu2DBVTshkCXacvNsWGYJVVhhawA7d4R5WSWGFNbi8Aw6ZRc1brxMyWMzG3DSSSSoekkudhUd9yLb6qx39T9nMdj";
+  const vectors = [
+    // m/44'/0'/0'/1/0
+    "bitcoincash:qzawj0yw07mgys3dy3uqkxsj54gwlapg7gjw8v3grk",
+    // m/44'/0'/0'/1/1
+    "bitcoincash:qqsqv86eghvyxcq7q5eg3l3ad7r7xcff65egddy9e9",
+    // m/44'/0'/0'/1/2
+    "bitcoincash:qrdexhxheryn7n2kf2s7g9kypfe0ynakrqm3j0f69w",
+  ];
+
+  // M/44'/0'/0'/0/i
+  const cashaddrs = await getAddrsByXpubKey(xpub, "1/0", 3);
+  expect(cashaddrs).toStrictEqual(vectors);
+});
+
+test("Should derive list of cashaddrs from M/44'/145'/0' given xpub, path and limit", async () => {
+  // abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about
+  // m/0
+  const xpub =
+    "xpub6ByHsPNSQXTWZ7PLESMY2FufyYWtLXagSUpMQq7Un96SiThZH2iJB1X7pwviH1WtKVeDP6K8d6xxFzzoaFzF3s8BKCZx8oEDdDkNnp4owAZ";
+  const vectors = [
+    //  M/44'/145'/0'/0/0
+    "bitcoincash:qqyx49mu0kkn9ftfj6hje6g2wfer34yfnq5tahq3q6",
+    //  M/44'/145'/0'/0/1
+    "bitcoincash:qp8sfdhgjlq68hlzka9lcsxtcnvuvnd0xqxugfzzc5",
+    //  M/44'/145'/0'/0/2
+    "bitcoincash:qqkuy34ntrye9a2h4xpdstcu4aq5wfrwscjtaphenr",
+  ];
+
+  const cashaddrs = await getAddrsByXpubKey(xpub, "0/0", 3);
+  expect(cashaddrs).toStrictEqual(vectors);
+});
+test("Should derive list of change cashaddrs from M/44'/145'/0' given xpub, path and limit", async () => {
+  // abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about
+  // m/0
+  const xpub =
+    "xpub6ByHsPNSQXTWZ7PLESMY2FufyYWtLXagSUpMQq7Un96SiThZH2iJB1X7pwviH1WtKVeDP6K8d6xxFzzoaFzF3s8BKCZx8oEDdDkNnp4owAZ";
+  const vectors = [
+    //  M/44'/145'/0'/1/0
+    "bitcoincash:qr8aeharupyrmhfu0d4tdmsnc5y8cfk47y6qrsjsrx",
+    //  M/44'/145'/0'/1/1
+    "bitcoincash:qr88m3rp5nd5aerz5rh9lzly9u5pevykagwscmjk0c",
+    //  M/44'/145'/0'/1/2
+    "bitcoincash:qp57cex47jtyhedphe2c63gpzsx3zs0ryvejxly47d",
+  ];
+  const cashaddrs = await getAddrsByXpubKey(xpub, "1/0", 3);
+  expect(cashaddrs).toStrictEqual(vectors);
+});

package/src/util/getAddrsByXpubKey.ts

@@ -0,0 +1,98 @@
+import {
+  deriveHdPublicNodeChild,
+  decodeHdPublicKey,
+  encodeHdPublicKey,
+  encodeCashAddress,
+  instantiateBIP32Crypto,
+  deriveHdPath,
+  HdPublicNode,
+  HdKeyNetwork,
+  binToHex,
+} from "@bitauth/libauth";
+import path from "path";
+
+import { hash160 } from "./hash160";
+
+export async function getAddrsByXpubKey(
+  xpub: string,
+  path: string,
+  count: number
+) {
+  let pathComponents = path.split("/");
+  let rootStr = pathComponents.shift()!;
+  let root: number;
+  if (rootStr === "M" || rootStr === "m") {
+    rootStr = pathComponents.shift()!;
+  }
+  root = parseInt(rootStr);
+  let result: any = [];
+
+  const start = parseInt(pathComponents.pop()!);
+  const end = start + count;
+  for (let curr = start; curr < end; curr++) {
+    let childPath = ["M", root, ...pathComponents, curr].join("/");
+    result.push(derivePublicNodeCashaddr(xpub, root, childPath));
+  }
+  return await Promise.all(result).then((result) => {
+    return result;
+  });
+}
+
+export async function getAddrsByXpubKeyObject(obj) {
+  return await getAddrsByXpubKey(obj.xpubkey, obj.path, obj.count);
+}
+
+export async function derivePublicNodeCashaddr(
+  xpub,
+  index: number,
+  path?: string
+) {
+  const crypto = await instantiateBIP32Crypto();
+  const publicParent = await decodeHdPublicKey(crypto, xpub);
+
+  if (typeof publicParent === "string") {
+    throw new Error(publicParent);
+  }
+  let prefix = publicParent.network === "mainnet" ? "bitcoincash" : "bchtest";
+
+  let node = await deriveHdPublicNodeChild(crypto, publicParent.node, index);
+  if (typeof node === "string") {
+    throw new Error(node);
+  }
+
+  let cashaddr;
+  if (typeof path === "string") {
+    if (path[0] !== "M") {
+      throw Error("use M for public path derivation");
+    }
+    let childNode = deriveHdPath(crypto, publicParent.node, path);
+    if (typeof childNode === "string") {
+      throw new Error(childNode);
+    } else {
+      let childPkh = await hash160(childNode.publicKey);
+      cashaddr = encodeCashAddress(prefix, 0, childPkh);
+    }
+  }
+  return cashaddr;
+}
+
+export async function getXpubKeyInfo(hdPublicKey) {
+  const crypto = await instantiateBIP32Crypto();
+  let node = decodeHdPublicKey(crypto, hdPublicKey);
+  if (typeof node === "string") {
+    throw new Error(node);
+  }
+  return {
+    version: node.network,
+    depth: node.node.depth,
+    parentFingerprint: binToHex(node.node.parentFingerprint),
+    childNumber: node.node.childIndex,
+    chain: binToHex(node.node.chainCode),
+    data: binToHex(node.node.publicKey),
+    fingerprint: binToHex((await hash160(node.node.publicKey)).slice(0, 4)),
+  };
+}
+
+export async function getXpubKeyInfoObject(obj) {
+  return await getXpubKeyInfo(obj.xpubkey);
+}

package/src/util/getXPubKey.ts

@@ -0,0 +1,36 @@
+import {
+  deriveHdPrivateNodeFromSeed,
+  deriveHdPath,
+  deriveHdPublicNode,
+  encodeHdPublicKey,
+  HdKeyNetwork,
+  instantiateBIP32Crypto,
+  hexToBin,
+} from "@bitauth/libauth";
+
+export async function getXPubKey(
+  seed: Uint8Array | string,
+  derivationPath: string,
+  network: string
+) {
+  if (typeof seed === "string") {
+    seed = hexToBin(seed);
+  }
+  const crypto = await instantiateBIP32Crypto();
+  let hdNode = deriveHdPrivateNodeFromSeed(crypto, seed);
+  if (!hdNode.valid) {
+    throw Error("Invalid private key derived from mnemonic seed");
+  }
+
+  let node = deriveHdPath(crypto, hdNode, derivationPath);
+  if (typeof node === "string") {
+    throw node;
+  }
+  let parentPublicNode = deriveHdPublicNode(crypto, node);
+
+  let xPubKey = encodeHdPublicKey(crypto, {
+    network: network as HdKeyNetwork,
+    node: parentPublicNode,
+  });
+  return xPubKey;
+}

package/src/util/index.ts

@@ -1,16 +1,23 @@
 export { amountInSatoshi } from "./amountInSatoshi";
 export { asSendRequestObject } from "./asSendRequestObject";
-export { btoa, atob } from "./base64";
+export { atob, btoa } from "./base64";
 export { convert, convertObject } from "./convert";
 export { delay } from "./delay";
+export { derivedNetwork } from "./deriveNetwork";
+export { derivePublicKeyHash } from "./derivePublicKeyHash";
+export {
+  getAddrsByXpubKey,
+  getAddrsByXpubKeyObject,
+  getXpubKeyInfo,
+  getXpubKeyInfoObject,
+} from "../util/getAddrsByXpubKey";
 export { getRuntimePlatform, RuntimePlatform } from "./getRuntimePlatform";
 export { getUsdRate } from "./getUsdRate";
 export { ExchangeRate } from "../rate/ExchangeRate";
-export { derivedNetwork } from "./deriveNetwork";
-export { derivePublicKeyHash } from "./derivePublicKeyHash";
 export { sanitizeAddress } from "./sanitizeAddress";
 export { sanitizeUnit } from "./sanitizeUnit";
 export { getRandomInt } from "./randomInt";
+export { getXPubKey } from "../util/getXPubKey";
 import * as randomValues from "./randomValues";
 export { randomValues };
 export { sumUtxoValue } from "./sumUtxoValue";

package/src/wallet/Base.ts

@@ -14,6 +14,8 @@ import { WalletTypeEnum } from "./enum";
 export class BaseWallet implements WalletI {
   provider?: any;
   derivationPath: string = "m/44'/0'/0'/0/0";
+  parentDerivationPath: string = "m/44'/0'/0'";
+  parentXPubKey?: string;
   mnemonic?: string;
   address?: string;
   privateKey?: any;
@@ -69,6 +71,7 @@ export class BaseWallet implements WalletI {
     return {
       seed: this.mnemonic,
       derivationPath: this.derivationPath,
+      parentDerivationPath: this.parentDerivationPath,
     };
   }
   //#endregion Accessors
@@ -182,7 +185,7 @@ export class BaseWallet implements WalletI {
   /**
    * replaceNamed - replace (recover) named wallet with a new walletId
    *
-   * If wallet with a provided name does not exist yet, it will be creted with a `walletId` supplied
+   * If wallet with a provided name does not exist yet, it will be created with a `walletId` supplied
    * If wallet exists it will be overwritten without exception
    *
    * @param name   user friendly wallet alias

package/src/wallet/Wif.test.ts

@@ -3,7 +3,7 @@ import { bchParam } from "../chain";
 import { BalanceResponse } from "../util/balanceObjectFromSatoshi";
 import { UnitEnum } from "../enum";
 import { initProviders, disconnectProviders } from "../network/Connection";
-import { DUST_UTXO_THRESHOLD as DUST } from "../constant";
+import { DERIVATION_PATHS, DUST_UTXO_THRESHOLD as DUST } from "../constant";
 import { delay } from "../util/delay";
 import { OpReturnData, SendResponse } from "./model";
 import { ElectrumRawTransaction } from "../network/interface";
@@ -183,6 +183,9 @@ describe(`Mnemonic wallet creation`, () => {
         "04aaeb52dd7494c361049de67cc680e83ebcbbbdbeb13637d92cd845f70308af5e9370164133294e5fd1679672fe7866c307daf97281a28f66dca7cbb52919824f",
       publicKeyHash: "d986ed01b7a22225a70edbf2ba7cfb63a15cb3aa",
 
+      parentXPubKey:
+        "xpub6BosfCnifzxcFwrSzQiqu2DBVTshkCXacvNsWGYJVVhhawA7d4R5WSWGFNbi8Aw6ZRc1brxMyWMzG3DSSSSoekkudhUd9yLb6qx39T9nMdj",
+      parentDerivationPath: "m/44'/0'/0'",
       derivationPath: "m/44'/0'/0'/0/0",
       seed: "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about",
 
@@ -208,6 +211,7 @@ describe(`Mnemonic wallet creation`, () => {
       "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
     );
     expect(w.getSeed().derivationPath).toBe("m/44'/145'/0'/0/0");
+    expect(w.getSeed().parentDerivationPath).toBe("m/44'/145'/0'");
   });
   test("Expect '11x abandon about' to have the correct key, seed and path from regtest wallet", async () => {
     let w = await RegTestWallet.fromId(
@@ -226,6 +230,172 @@ describe(`Mnemonic wallet creation`, () => {
   });
 });
 
+describe(`XPubKey path derivation`, () => {
+  test("Expect '11x abandon about' to have the correct xpubs for common derivation paths, seed and path", async () => {
+    let w = await Wallet.fromId(
+      "seed:mainnet:abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
+    );
+    let commonPaths = await w.deriveHdPaths(DERIVATION_PATHS);
+    expect(commonPaths).toStrictEqual([
+      {
+        path: "m/0",
+        xPubKey:
+          "xpub68jrRzQfUmwSaf5Y37Yd5uwfnMRxiR14M3HBonDr91GB7GKEh7R9Mvu2UeCtbASfXZ9FdNo9FwFx6a37HNXUDiXVQFXuadXmevRBa3y7rL8",
+      },
+      {
+        path: "m/0'",
+        xPubKey:
+          "xpub68jrRzQopSUQm76hJ6TNtiJMJfhj38u1X12xCzExrw388hcN443UVnYpswdUkV7vPJ3KayiCdp3Q5E23s4wvkucohVTh7eSstJdBFyn2DMx",
+      },
+      {
+        path: "m/0'/0",
+        xPubKey:
+          "xpub6A7PsGUCo9qsn1jhZVB68WKWU9bTt1Wu7fzRqhczRbJ3u3xsF1bJmWBL1MvygTtrfmvNw1adLzmRjQHtDCJDXAHFa4K3wELpGGqEXL4e6d4",
+      },
+      {
+        path: "m/0'/0'",
+        xPubKey:
+          "xpub6A7PsGUM8pNqwy9AceVuFK6KxY88FhvFMRGP9fjEDKA3P4WpR1zyHH3Lmczj7eorx4RbDC4Qttd8C7HhLA2W9LsxxZzXo1DMCwJFb3zZKZ8",
+      },
+      {
+        path: "m/0'/0'/0'",
+        xPubKey:
+          "xpub6BiChRN7aqq51RA7RnAmKhqKdGckPncrHWLrj1xoj6ZMfdMJ1dX4Ysh9V3yEhpFCpC3BapjR83xPKY693XXTEU6qgWU3qZs78WBHA15uhYf",
+      },
+      {
+        path: "m/44'/0'/0'",
+        xPubKey:
+          "xpub6BosfCnifzxcFwrSzQiqu2DBVTshkCXacvNsWGYJVVhhawA7d4R5WSWGFNbi8Aw6ZRc1brxMyWMzG3DSSSSoekkudhUd9yLb6qx39T9nMdj",
+      },
+      {
+        path: "m/44'/0'/0'/0",
+        xPubKey:
+          "xpub6ELHKXNimKbxMCytPh7EdC2QXx46T9qLDJWGnTraz1H9kMMFdcduoU69wh9cxP12wDxqAAfbaESWGYt5rREsX1J8iR2TEunvzvddduAPYcY",
+      },
+      {
+        path: "m/44'/145'/0'",
+        xPubKey:
+          "xpub6ByHsPNSQXTWZ7PLESMY2FufyYWtLXagSUpMQq7Un96SiThZH2iJB1X7pwviH1WtKVeDP6K8d6xxFzzoaFzF3s8BKCZx8oEDdDkNnp4owAZ",
+      },
+      {
+        path: "m/44'/145'/0'/0",
+        xPubKey:
+          "xpub6F2iaK2JUPcgrZ6RTGH6t8VybLPu1XzfrHsDsaKvK6NfULznU6i6aw6ZoefDW2DpNruSLw73RwQg46qvpqB3eryeJJ2tkFCF4Z6gbr8Pjja",
+      },
+      {
+        path: "m/44'/245'/0",
+        xPubKey:
+          "xpub6Ch34ms5osevEtkEZX81n8EG4c6vgHWGH1gQXBG2uf2Tihb1eed4H1wozLfZB31mV9JD7mymYTQxcLKFFjZHdM5NGdH2Ud1ksSkfwSFjjCg",
+      },
+      {
+        path: "m/44'/245'/0'",
+        xPubKey:
+          "xpub6Ch34msE9YBtQV7pZrLyRXHwocrpJtNN4KDG8bbyxyhGmEM5MirtqkiH4h9dvnVJ3MekET3w2Fkvej3fyo8WLz9bRPyDynDf6NXNfuydhv1",
+      },
+      {
+        path: "m/44'/245'/0'/0",
+        xPubKey:
+          "xpub6FFeETss5Zwkw78NDAibKEaGxigU3bgYzLihcqbQqqTyb6jorR9mgR9AexYydxmiPU8koAf5ndaQPjPWK3sDz1wjBjf2TkLbD982S9PWd9Z",
+      },
+    ]);
+  });
+  test("Expect '11x abandon about' to return 'protected' for root path", async () => {
+    expect.assertions(1);
+    try {
+      let w = await Wallet.fromId(
+        "seed:mainnet:abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
+      );
+      let commonPaths = await w.deriveHdPaths(["m"]);
+    } catch (e: any) {
+      expect(e.message).toBe(
+        "Storing or sharing of parent public key may lead to loss of funds. Storing or sharing *root* parent public keys is strongly discouraged, although all parent keys have risk. See: https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki#implications"
+      );
+    }
+  });
+
+  test("Expect '11x abandon about' to have the correct xpubs for common derivation paths, seed and path", async () => {
+    let w = await Wallet.fromId(
+      "seed:mainnet:abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
+    );
+    let commonPaths = await w.getXPubKeys();
+    expect(commonPaths).toStrictEqual([
+      {
+        path: "m/0",
+        xPubKey:
+          "xpub68jrRzQfUmwSaf5Y37Yd5uwfnMRxiR14M3HBonDr91GB7GKEh7R9Mvu2UeCtbASfXZ9FdNo9FwFx6a37HNXUDiXVQFXuadXmevRBa3y7rL8",
+      },
+      {
+        path: "m/0'",
+        xPubKey:
+          "xpub68jrRzQopSUQm76hJ6TNtiJMJfhj38u1X12xCzExrw388hcN443UVnYpswdUkV7vPJ3KayiCdp3Q5E23s4wvkucohVTh7eSstJdBFyn2DMx",
+      },
+      {
+        path: "m/0'/0",
+        xPubKey:
+          "xpub6A7PsGUCo9qsn1jhZVB68WKWU9bTt1Wu7fzRqhczRbJ3u3xsF1bJmWBL1MvygTtrfmvNw1adLzmRjQHtDCJDXAHFa4K3wELpGGqEXL4e6d4",
+      },
+      {
+        path: "m/0'/0'",
+        xPubKey:
+          "xpub6A7PsGUM8pNqwy9AceVuFK6KxY88FhvFMRGP9fjEDKA3P4WpR1zyHH3Lmczj7eorx4RbDC4Qttd8C7HhLA2W9LsxxZzXo1DMCwJFb3zZKZ8",
+      },
+      {
+        path: "m/0'/0'/0'",
+        xPubKey:
+          "xpub6BiChRN7aqq51RA7RnAmKhqKdGckPncrHWLrj1xoj6ZMfdMJ1dX4Ysh9V3yEhpFCpC3BapjR83xPKY693XXTEU6qgWU3qZs78WBHA15uhYf",
+      },
+      {
+        path: "m/44'/0'/0'",
+        xPubKey:
+          "xpub6BosfCnifzxcFwrSzQiqu2DBVTshkCXacvNsWGYJVVhhawA7d4R5WSWGFNbi8Aw6ZRc1brxMyWMzG3DSSSSoekkudhUd9yLb6qx39T9nMdj",
+      },
+      {
+        path: "m/44'/0'/0'/0",
+        xPubKey:
+          "xpub6ELHKXNimKbxMCytPh7EdC2QXx46T9qLDJWGnTraz1H9kMMFdcduoU69wh9cxP12wDxqAAfbaESWGYt5rREsX1J8iR2TEunvzvddduAPYcY",
+      },
+      {
+        path: "m/44'/145'/0'",
+        xPubKey:
+          "xpub6ByHsPNSQXTWZ7PLESMY2FufyYWtLXagSUpMQq7Un96SiThZH2iJB1X7pwviH1WtKVeDP6K8d6xxFzzoaFzF3s8BKCZx8oEDdDkNnp4owAZ",
+      },
+      {
+        path: "m/44'/145'/0'/0",
+        xPubKey:
+          "xpub6F2iaK2JUPcgrZ6RTGH6t8VybLPu1XzfrHsDsaKvK6NfULznU6i6aw6ZoefDW2DpNruSLw73RwQg46qvpqB3eryeJJ2tkFCF4Z6gbr8Pjja",
+      },
+      {
+        path: "m/44'/245'/0",
+        xPubKey:
+          "xpub6Ch34ms5osevEtkEZX81n8EG4c6vgHWGH1gQXBG2uf2Tihb1eed4H1wozLfZB31mV9JD7mymYTQxcLKFFjZHdM5NGdH2Ud1ksSkfwSFjjCg",
+      },
+      {
+        path: "m/44'/245'/0'",
+        xPubKey:
+          "xpub6Ch34msE9YBtQV7pZrLyRXHwocrpJtNN4KDG8bbyxyhGmEM5MirtqkiH4h9dvnVJ3MekET3w2Fkvej3fyo8WLz9bRPyDynDf6NXNfuydhv1",
+      },
+      {
+        path: "m/44'/245'/0'/0",
+        xPubKey:
+          "xpub6FFeETss5Zwkw78NDAibKEaGxigU3bgYzLihcqbQqqTyb6jorR9mgR9AexYydxmiPU8koAf5ndaQPjPWK3sDz1wjBjf2TkLbD982S9PWd9Z",
+      },
+    ]);
+  });
+  test("Expect '11x abandon about' to return 'protected' for root path", async () => {
+    expect.assertions(1);
+    try {
+      let w = await Wallet.fromId(
+        "seed:mainnet:abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
+      );
+      let commonPaths = await w.getXPubKeys(["m"]);
+    } catch (e: any) {
+      expect(e.message).toBe(
+        "Storing or sharing of parent public key may lead to loss of funds. Storing or sharing *root* parent public keys is strongly discouraged, although all parent keys have risk. See: https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki#implications"
+      );
+    }
+  });
+});
+
 describe(`Watch only Wallets`, () => {
   test("Create a watch only testnet wallet from string id", async () => {
     let w = await TestNetWallet.fromId(
@@ -242,6 +412,8 @@ describe(`Watch only Wallets`, () => {
       isTestnet: true,
       name: "",
       network: "testnet",
+      parentDerivationPath: undefined,
+      parentXPubKey: undefined,
       privateKey: undefined,
       privateKeyWif: undefined,
       publicKey: undefined,
@@ -311,7 +483,6 @@ describe(`Watch only Wallets`, () => {
       let aliceBalance = await alice.send([
         { cashaddr: alice.cashaddr!, value: 526, unit: "sat" },
       ]);
-      expect(aliceBalance.explorerUrl!).toContain("explorer.bitcoin.com");
       expect(aliceBalance.balance!.sat!).toBeGreaterThan(5000);
     }
   });
@@ -329,6 +500,24 @@ describe(`Watch only Wallets`, () => {
       expect(aliceBalance.sat).toBeGreaterThan(2000);
     }
   });
+
+  test("Should get last transaction", async () => {
+    const aliceWif = `wif:regtest:${process.env.PRIVATE_WIF!}`;
+    const aliceWallet = await RegTestWallet.fromId(aliceWif);
+    const bobWallet = await RegTestWallet.newRandom();
+
+    expect(await bobWallet.getLastTransaction()).toBeNull();
+
+    await aliceWallet.send([
+      {
+        cashaddr: bobWallet.cashaddr!,
+        value: 2000,
+        unit: "satoshis",
+      },
+    ]);
+
+    expect(await bobWallet.getLastTransaction()).not.toBeNull();
+  });
 });
 describe(`Wallet subscriptions`, () => {
   test("Should wait for transaction", async () => {
@@ -881,4 +1070,28 @@ describe(`Wallet extrema behavior regression testing`, () => {
       0x6a, 0x4c, 0x00,
     ]);
   });
+
+  test("Test slpSemiAware", async () => {
+    const alice = await RegTestWallet.fromId(process.env.ALICE_ID!);
+    const bob = await RegTestWallet.newRandom();
+    await alice.send([
+      { cashaddr: bob.getDepositAddress(), unit: UnitEnum.SAT, value: 546 },
+      { cashaddr: bob.getDepositAddress(), unit: UnitEnum.SAT, value: 1000 },
+    ]);
+    expect(await bob.getBalance("sat")).toBe(1546);
+    bob.slpSemiAware();
+    expect(await bob.getBalance("sat")).toBe(1000);
+
+    expect(
+      (await bob.getMaxAmountToSend({ options: { slpSemiAware: true } })).sat
+    ).toBe(780);
+    await bob.sendMax(alice.getDepositAddress());
+    expect(await bob.getBalance("sat")).toBe(0);
+
+    bob.slpSemiAware(false);
+    expect(await bob.getBalance("sat")).toBe(546);
+    expect(
+      (await bob.getMaxAmountToSend({ options: { slpSemiAware: false } })).sat
+    ).toBeLessThanOrEqual(546);
+  });
 });