@bsv/wallet-toolbox 1.5.20 → 1.6.1

package/out/src/services/providers/WhatsOnChain.js

@@ -3,19 +3,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WhatsOnChain = void 0;
+exports.WhatsOnChain = exports.WhatsOnChainNoServices = void 0;
+exports.convertWocToBlockHeaderHex = convertWocToBlockHeaderHex;
+exports.getWhatsOnChainBlockHeaderByHash = getWhatsOnChainBlockHeaderByHash;
 const sdk_1 = require("@bsv/sdk");
-const index_client_1 = require("../../index.client");
 const tscProofToMerklePath_1 = require("../../utility/tscProofToMerklePath");
 const SdkWhatsOnChain_1 = __importDefault(require("./SdkWhatsOnChain"));
-const sdk_2 = require("../../sdk");
-/**
- *
- */
-class WhatsOnChain extends SdkWhatsOnChain_1.default {
-    constructor(chain = 'main', config = {}, services) {
+const WERR_errors_1 = require("../../sdk/WERR_errors");
+const WalletError_1 = require("../../sdk/WalletError");
+const utilityHelpers_1 = require("../../utility/utilityHelpers");
+const utilityHelpers_noBuffer_1 = require("../../utility/utilityHelpers.noBuffer");
+const Services_1 = require("../Services");
+const validationHelpers_1 = require("../../sdk/validationHelpers");
+class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
+    constructor(chain = 'main', config = {}) {
         super(chain, config);
-        this.services = services || new index_client_1.Services(chain);
     }
     /**
      * POST
@@ -54,7 +56,7 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
         try {
             const response = await this.httpClient.request(url, requestOptions);
             if (!response.data || !response.ok || response.status !== 200)
-                throw new index_client_1.sdk.WERR_INVALID_OPERATION(`Unable to get status for txids at this timei.`);
+                throw new WERR_errors_1.WERR_INVALID_OPERATION(`Unable to get status for txids at this timei.`);
             const data = response.data;
             for (const txid of txids) {
                 const d = data.find(d => d.txid === txid);
@@ -72,7 +74,7 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
             r.status = 'success';
         }
         catch (eu) {
-            const e = index_client_1.sdk.WalletError.fromUnknown(eu);
+            const e = WalletError_1.WalletError.fromUnknown(eu);
             r.error = e;
         }
         return r;
@@ -90,7 +92,7 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
         const response = await this.httpClient.request(`${this.URL}/tx/hash/${txid}/propagation`, requestOptions);
         // response.statusText is often, but not always 'OK' on success...
         if (!response.data || !response.ok || response.status !== 200)
-            throw new index_client_1.sdk.WERR_INVALID_PARAMETER('txid', `valid transaction. '${txid}' response ${response.statusText}`);
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('txid', `valid transaction. '${txid}' response ${response.statusText}`);
         return 0;
     }
     /**
@@ -109,27 +111,27 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
         for (let retry = 0; retry < 2; retry++) {
             const response = await this.httpClient.request(url, requestOptions);
             if (response.statusText === 'Too Many Requests' && retry < 2) {
-                await (0, index_client_1.wait)(2000);
+                await (0, utilityHelpers_1.wait)(2000);
                 continue;
             }
             if (response.status === 404 && response.statusText === 'Not Found')
                 return undefined;
             // response.statusText is often, but not always 'OK' on success...
             if (!response.data || !response.ok || response.status !== 200)
-                throw new index_client_1.sdk.WERR_INVALID_PARAMETER('txid', `valid transaction. '${txid}' response ${response.statusText}`);
+                throw new WERR_errors_1.WERR_INVALID_PARAMETER('txid', `valid transaction. '${txid}' response ${response.statusText}`);
             return response.data;
         }
-        throw new index_client_1.sdk.WERR_INTERNAL();
+        throw new WERR_errors_1.WERR_INTERNAL();
     }
     async getRawTxResult(txid) {
-        const r = { name: 'WoC', txid: (0, index_client_1.asString)(txid) };
+        const r = { name: 'WoC', txid: (0, utilityHelpers_noBuffer_1.asString)(txid) };
         try {
             const rawTxHex = await this.getRawTx(txid);
             if (rawTxHex)
-                r.rawTx = (0, index_client_1.asArray)(rawTxHex);
+                r.rawTx = (0, utilityHelpers_noBuffer_1.asArray)(rawTxHex);
         }
         catch (err) {
-            r.error = index_client_1.sdk.WalletError.fromUnknown(err);
+            r.error = WalletError_1.WalletError.fromUnknown(err);
         }
         return r;
     }
@@ -156,7 +158,7 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
             const rawTx = sdk_1.Utils.toHex(beef.findTxid(txid).rawTx);
             if (delay) {
                 // For multiple txids, give WoC time to propagate each one.
-                await (0, index_client_1.wait)(3000);
+                await (0, utilityHelpers_1.wait)(3000);
             }
             delay = true;
             const tr = await this.postRawTx(rawTx);
@@ -180,7 +182,7 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
      * @returns txid returned by transaction processor of transaction broadcast
      */
     async postRawTx(rawTx) {
-        let txid = sdk_1.Utils.toHex((0, index_client_1.doubleSha256BE)(sdk_1.Utils.toArray(rawTx, 'hex')));
+        let txid = sdk_1.Utils.toHex((0, utilityHelpers_1.doubleSha256BE)(sdk_1.Utils.toArray(rawTx, 'hex')));
         const r = {
             txid,
             status: 'success',
@@ -203,7 +205,7 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
                 const response = await this.httpClient.request(url, requestOptions);
                 if (response.statusText === 'Too Many Requests' && retry < 2) {
                     r.notes.push({ ...nn(), what: 'postRawTxRateLimit' });
-                    await (0, index_client_1.wait)(2000);
+                    await (0, utilityHelpers_1.wait)(2000);
                     continue;
                 }
                 if (response.ok) {
@@ -255,7 +257,7 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
             }
             catch (eu) {
                 r.status = 'error';
-                const e = index_client_1.sdk.WalletError.fromUnknown(eu);
+                const e = WalletError_1.WalletError.fromUnknown(eu);
                 r.notes.push({
                     ...nne(),
                     what: 'postRawTxCatch',
@@ -276,106 +278,6 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
         });
         return r;
     }
-    /**
-     * @param txid
-     * @returns
-     */
-    async getMerklePath(txid, services) {
-        const r = { name: 'WoCTsc', notes: [] };
-        const headers = this.getHttpHeaders();
-        const requestOptions = {
-            method: 'GET',
-            headers
-        };
-        for (let retry = 0; retry < 2; retry++) {
-            try {
-                const response = await this.httpClient.request(`${this.URL}/tx/${txid}/proof/tsc`, requestOptions);
-                if (response.statusText === 'Too Many Requests' && retry < 2) {
-                    r.notes.push({
-                        what: 'getMerklePathRetry',
-                        name: r.name,
-                        status: response.status,
-                        statusText: response.statusText
-                    });
-                    await (0, index_client_1.wait)(2000);
-                    continue;
-                }
-                if (response.status === 404 && response.statusText === 'Not Found') {
-                    r.notes.push({
-                        what: 'getMerklePathNotFound',
-                        name: r.name,
-                        status: response.status,
-                        statusText: response.statusText
-                    });
-                    return r;
-                }
-                // response.statusText is often, but not always 'OK' on success...
-                if (!response.ok || response.status !== 200) {
-                    r.notes.push({
-                        what: 'getMerklePathBadStatus',
-                        name: r.name,
-                        status: response.status,
-                        statusText: response.statusText
-                    });
-                    throw new index_client_1.sdk.WERR_INVALID_PARAMETER('txid', `valid transaction. '${txid}' response ${response.statusText}`);
-                }
-                if (!response.data) {
-                    // Unmined, proof not yet available.
-                    r.notes.push({
-                        what: 'getMerklePathNoData',
-                        name: r.name,
-                        status: response.status,
-                        statusText: response.statusText
-                    });
-                    return r;
-                }
-                if (!Array.isArray(response.data))
-                    response.data = [response.data];
-                if (response.data.length != 1)
-                    return r;
-                const p = response.data[0];
-                const header = await services.hashToHeader(p.target);
-                if (header) {
-                    const proof = {
-                        index: p.index,
-                        nodes: p.nodes,
-                        height: header.height
-                    };
-                    r.merklePath = (0, tscProofToMerklePath_1.convertProofToMerklePath)(txid, proof);
-                    r.header = header;
-                    r.notes.push({
-                        what: 'getMerklePathSuccess',
-                        name: r.name,
-                        status: response.status,
-                        statusText: response.statusText
-                    });
-                }
-                else {
-                    r.notes.push({
-                        what: 'getMerklePathNoHeader',
-                        target: p.target,
-                        name: r.name,
-                        status: response.status,
-                        statusText: response.statusText
-                    });
-                    throw new index_client_1.sdk.WERR_INVALID_PARAMETER('blockhash', 'a valid on-chain block hash');
-                }
-            }
-            catch (eu) {
-                const e = index_client_1.sdk.WalletError.fromUnknown(eu);
-                r.notes.push({
-                    what: 'getMerklePathError',
-                    name: r.name,
-                    code: e.code,
-                    description: e.description
-                });
-                r.error = e;
-            }
-            return r;
-        }
-        r.notes.push({ what: 'getMerklePathInternal', name: r.name });
-        throw new index_client_1.sdk.WERR_INTERNAL();
-    }
     async updateBsvExchangeRate(rate, updateMsecs) {
         if (rate) {
             // Check if the rate we know is stale enough to update.
@@ -390,12 +292,12 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
         for (let retry = 0; retry < 2; retry++) {
             const response = await this.httpClient.request(`${this.URL}/exchangerate`, requestOptions);
             if (response.statusText === 'Too Many Requests' && retry < 2) {
-                await (0, index_client_1.wait)(2000);
+                await (0, utilityHelpers_1.wait)(2000);
                 continue;
             }
             // response.statusText is often, but not always 'OK' on success...
             if (!response.data || !response.ok || response.status !== 200)
-                throw new index_client_1.sdk.WERR_INVALID_OPERATION(`WoC exchangerate response ${response.statusText}`);
+                throw new WERR_errors_1.WERR_INVALID_OPERATION(`WoC exchangerate response ${response.statusText}`);
             const wocrate = response.data;
             if (wocrate.currency !== 'USD')
                 wocrate.rate = NaN;
@@ -406,34 +308,34 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
             };
             return newRate;
         }
-        throw new index_client_1.sdk.WERR_INTERNAL();
+        throw new WERR_errors_1.WERR_INTERNAL();
     }
     async getUtxoStatus(output, outputFormat, outpoint) {
         const r = {
             name: 'WoC',
             status: 'error',
-            error: new index_client_1.sdk.WERR_INTERNAL(),
+            error: new WERR_errors_1.WERR_INTERNAL(),
             details: []
         };
         for (let retry = 0;; retry++) {
             let url = '';
             try {
-                const scriptHash = (0, index_client_1.validateScriptHash)(output, outputFormat);
+                const scriptHash = (0, Services_1.validateScriptHash)(output, outputFormat);
                 const requestOptions = {
                     method: 'GET',
                     headers: this.getHttpHeaders()
                 };
                 const response = await this.httpClient.request(`${this.URL}/script/${scriptHash}/unspent/all`, requestOptions);
                 if (response.statusText === 'Too Many Requests' && retry < 2) {
-                    await (0, index_client_1.wait)(2000);
+                    await (0, utilityHelpers_1.wait)(2000);
                     continue;
                 }
                 // response.statusText is often, but not always 'OK' on success...
                 if (!response.data || !response.ok || response.status !== 200)
-                    throw new index_client_1.sdk.WERR_INVALID_OPERATION(`WoC getUtxoStatus response ${response.statusText}`);
+                    throw new WERR_errors_1.WERR_INVALID_OPERATION(`WoC getUtxoStatus response ${response.statusText}`);
                 const data = response.data;
                 if (data.script !== scriptHash || !Array.isArray(data.result)) {
-                    throw new index_client_1.sdk.WERR_INTERNAL('data. is not an array');
+                    throw new WERR_errors_1.WERR_INTERNAL('data. is not an array');
                 }
                 if (data.result.length === 0) {
                     r.status = 'success';
@@ -452,7 +354,7 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
                         });
                     }
                     if (outpoint) {
-                        const { txid, vout } = (0, sdk_2.parseWalletOutpoint)(outpoint);
+                        const { txid, vout } = (0, validationHelpers_1.parseWalletOutpoint)(outpoint);
                         r.isUtxo = r.details.find(d => d.txid === txid && d.index === vout) !== undefined;
                     }
                     else
@@ -461,9 +363,9 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
                 return r;
             }
             catch (eu) {
-                const e = index_client_1.sdk.WalletError.fromUnknown(eu);
+                const e = WalletError_1.WalletError.fromUnknown(eu);
                 if (e.code !== 'ECONNRESET' || retry > 2) {
-                    r.error = new index_client_1.sdk.WERR_INTERNAL(`service failure: ${url}, error: ${JSON.stringify(index_client_1.sdk.WalletError.fromUnknown(eu))}`);
+                    r.error = new WERR_errors_1.WERR_INTERNAL(`service failure: ${url}, error: ${JSON.stringify(WalletError_1.WalletError.fromUnknown(eu))}`);
                     return r;
                 }
             }
@@ -487,7 +389,7 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
                 };
                 const response = await this.httpClient.request(url, requestOptions);
                 if (response.statusText === 'Too Many Requests' && retry < 2) {
-                    await (0, index_client_1.wait)(2000);
+                    await (0, utilityHelpers_1.wait)(2000);
                     continue;
                 }
                 if (!response.ok && response.status === 404) {
@@ -497,11 +399,11 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
                 }
                 // response.statusText is often, but not always 'OK' on success...
                 if (!response.data || !response.ok || response.status !== 200) {
-                    r.error = new index_client_1.sdk.WERR_BAD_REQUEST(`WoC getScriptHashConfirmedHistory response ${response.ok} ${response.status} ${response.statusText}`);
+                    r.error = new WERR_errors_1.WERR_BAD_REQUEST(`WoC getScriptHashConfirmedHistory response ${response.ok} ${response.status} ${response.statusText}`);
                     return r;
                 }
                 if (response.data.error) {
-                    r.error = new index_client_1.sdk.WERR_BAD_REQUEST(`WoC getScriptHashConfirmedHistory error ${response.data.error}`);
+                    r.error = new WERR_errors_1.WERR_BAD_REQUEST(`WoC getScriptHashConfirmedHistory error ${response.data.error}`);
                     return r;
                 }
                 r.history = response.data.result.map(d => ({ txid: d.tx_hash, height: d.height }));
@@ -509,9 +411,9 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
                 return r;
             }
             catch (eu) {
-                const e = index_client_1.sdk.WalletError.fromUnknown(eu);
+                const e = WalletError_1.WalletError.fromUnknown(eu);
                 if (e.code !== 'ECONNRESET' || retry > 2) {
-                    r.error = new index_client_1.sdk.WERR_INTERNAL(`WoC getScriptHashConfirmedHistory service failure: ${url}, error: ${JSON.stringify(index_client_1.sdk.WalletError.fromUnknown(eu))}`);
+                    r.error = new WERR_errors_1.WERR_INTERNAL(`WoC getScriptHashConfirmedHistory service failure: ${url}, error: ${JSON.stringify(WalletError_1.WalletError.fromUnknown(eu))}`);
                     return r;
                 }
             }
@@ -536,7 +438,7 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
                 };
                 const response = await this.httpClient.request(url, requestOptions);
                 if (response.statusText === 'Too Many Requests' && retry < 2) {
-                    await (0, index_client_1.wait)(2000);
+                    await (0, utilityHelpers_1.wait)(2000);
                     continue;
                 }
                 if (!response.ok && response.status === 404) {
@@ -546,11 +448,11 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
                 }
                 // response.statusText is often, but not always 'OK' on success...
                 if (!response.data || !response.ok || response.status !== 200) {
-                    r.error = new index_client_1.sdk.WERR_BAD_REQUEST(`WoC getScriptHashUnconfirmedHistory response ${response.ok} ${response.status} ${response.statusText}`);
+                    r.error = new WERR_errors_1.WERR_BAD_REQUEST(`WoC getScriptHashUnconfirmedHistory response ${response.ok} ${response.status} ${response.statusText}`);
                     return r;
                 }
                 if (response.data.error) {
-                    r.error = new index_client_1.sdk.WERR_BAD_REQUEST(`WoC getScriptHashUnconfirmedHistory error ${response.data.error}`);
+                    r.error = new WERR_errors_1.WERR_BAD_REQUEST(`WoC getScriptHashUnconfirmedHistory error ${response.data.error}`);
                     return r;
                 }
                 r.history = response.data.result.map(d => ({ txid: d.tx_hash, height: d.height }));
@@ -558,9 +460,9 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
                 return r;
             }
             catch (eu) {
-                const e = index_client_1.sdk.WalletError.fromUnknown(eu);
+                const e = WalletError_1.WalletError.fromUnknown(eu);
                 if (e.code !== 'ECONNRESET' || retry > 2) {
-                    r.error = new index_client_1.sdk.WERR_INTERNAL(`WoC getScriptHashUnconfirmedHistory service failure: ${url}, error: ${JSON.stringify(index_client_1.sdk.WalletError.fromUnknown(eu))}`);
+                    r.error = new WERR_errors_1.WERR_INTERNAL(`WoC getScriptHashUnconfirmedHistory service failure: ${url}, error: ${JSON.stringify(WalletError_1.WalletError.fromUnknown(eu))}`);
                     return r;
                 }
             }
@@ -577,6 +479,202 @@ class WhatsOnChain extends SdkWhatsOnChain_1.default {
         r1.history = r1.history.concat(r2.history);
         return r1;
     }
+    /**
+      {
+        "hash": "000000000000000004a288072ebb35e37233f419918f9783d499979cb6ac33eb",
+        "confirmations": 328433,
+        "size": 14421,
+        "height": 575045,
+        "version": 536928256,
+        "versionHex": "2000e000",
+        "merkleroot": "4ebcba09addd720991d03473f39dce4b9a72cc164e505cd446687a54df9b1585",
+        "time": 1553416668,
+        "mediantime": 1553414858,
+        "nonce": 87914848,
+        "bits": "180997ee",
+        "difficulty": 114608607557.4425,
+        "chainwork": "000000000000000000000000000000000000000000ddf5d385546872bab7dc01",
+        "previousblockhash": "00000000000000000988156c7075dc9147a5b62922f1310862e8b9000d46dd9b",
+        "nextblockhash": "00000000000000000112b36a37c10235fa0c991f680bc5482ba9692e0ae697db",
+        "nTx": 0,
+        "num_tx": 5
+      }
+     */
+    async getBlockHeaderByHash(hash) {
+        const headers = this.getHttpHeaders();
+        const requestOptions = {
+            method: 'GET',
+            headers
+        };
+        const url = `${this.URL}/block/${hash}/header`;
+        for (let retry = 0; retry < 2; retry++) {
+            const response = await this.httpClient.request(url, requestOptions);
+            if (response.statusText === 'Too Many Requests' && retry < 2) {
+                await (0, utilityHelpers_1.wait)(2000);
+                continue;
+            }
+            if (response.status === 404 && response.statusText === 'Not Found')
+                return undefined;
+            // response.statusText is often, but not always 'OK' on success...
+            if (!response.data || !response.ok || response.status !== 200)
+                throw new WERR_errors_1.WERR_INVALID_PARAMETER('hash', `valid block hash. '${hash}' response ${response.statusText}`);
+            const header = convertWocToBlockHeaderHex(response.data);
+            return header;
+        }
+        throw new WERR_errors_1.WERR_INTERNAL();
+    }
+    async getChainInfo() {
+        const headers = this.getHttpHeaders();
+        const requestOptions = {
+            method: 'GET',
+            headers
+        };
+        const url = `${this.URL}/chain/info`;
+        for (let retry = 0; retry < 2; retry++) {
+            const response = await this.httpClient.request(url, requestOptions);
+            if (response.statusText === 'Too Many Requests' && retry < 2) {
+                await (0, utilityHelpers_1.wait)(2000);
+                continue;
+            }
+            // response.statusText is often, but not always 'OK' on success...
+            if (!response.data || !response.ok || response.status !== 200)
+                throw new WERR_errors_1.WERR_INVALID_PARAMETER('hash', `valid block hash. '${url}' response ${response.statusText}`);
+            return response.data;
+        }
+        throw new WERR_errors_1.WERR_INTERNAL();
+    }
+}
+exports.WhatsOnChainNoServices = WhatsOnChainNoServices;
+/**
+ *
+ */
+class WhatsOnChain extends WhatsOnChainNoServices {
+    constructor(chain = 'main', config = {}, services) {
+        super(chain, config);
+        this.services = services || new Services_1.Services(chain);
+    }
+    /**
+     * @param txid
+     * @returns
+     */
+    async getMerklePath(txid, services) {
+        const r = { name: 'WoCTsc', notes: [] };
+        const headers = this.getHttpHeaders();
+        const requestOptions = {
+            method: 'GET',
+            headers
+        };
+        for (let retry = 0; retry < 2; retry++) {
+            try {
+                const response = await this.httpClient.request(`${this.URL}/tx/${txid}/proof/tsc`, requestOptions);
+                if (response.statusText === 'Too Many Requests' && retry < 2) {
+                    r.notes.push({
+                        what: 'getMerklePathRetry',
+                        name: r.name,
+                        status: response.status,
+                        statusText: response.statusText
+                    });
+                    await (0, utilityHelpers_1.wait)(2000);
+                    continue;
+                }
+                if (response.status === 404 && response.statusText === 'Not Found') {
+                    r.notes.push({
+                        what: 'getMerklePathNotFound',
+                        name: r.name,
+                        status: response.status,
+                        statusText: response.statusText
+                    });
+                    return r;
+                }
+                // response.statusText is often, but not always 'OK' on success...
+                if (!response.ok || response.status !== 200) {
+                    r.notes.push({
+                        what: 'getMerklePathBadStatus',
+                        name: r.name,
+                        status: response.status,
+                        statusText: response.statusText
+                    });
+                    throw new WERR_errors_1.WERR_INVALID_PARAMETER('txid', `valid transaction. '${txid}' response ${response.statusText}`);
+                }
+                if (!response.data) {
+                    // Unmined, proof not yet available.
+                    r.notes.push({
+                        what: 'getMerklePathNoData',
+                        name: r.name,
+                        status: response.status,
+                        statusText: response.statusText
+                    });
+                    return r;
+                }
+                if (!Array.isArray(response.data))
+                    response.data = [response.data];
+                if (response.data.length != 1)
+                    return r;
+                const p = response.data[0];
+                const header = await services.hashToHeader(p.target);
+                if (header) {
+                    const proof = {
+                        index: p.index,
+                        nodes: p.nodes,
+                        height: header.height
+                    };
+                    r.merklePath = (0, tscProofToMerklePath_1.convertProofToMerklePath)(txid, proof);
+                    r.header = header;
+                    r.notes.push({
+                        what: 'getMerklePathSuccess',
+                        name: r.name,
+                        status: response.status,
+                        statusText: response.statusText
+                    });
+                }
+                else {
+                    r.notes.push({
+                        what: 'getMerklePathNoHeader',
+                        target: p.target,
+                        name: r.name,
+                        status: response.status,
+                        statusText: response.statusText
+                    });
+                    throw new WERR_errors_1.WERR_INVALID_PARAMETER('blockhash', 'a valid on-chain block hash');
+                }
+            }
+            catch (eu) {
+                const e = WalletError_1.WalletError.fromUnknown(eu);
+                r.notes.push({
+                    what: 'getMerklePathError',
+                    name: r.name,
+                    code: e.code,
+                    description: e.description
+                });
+                r.error = e;
+            }
+            return r;
+        }
+        r.notes.push({ what: 'getMerklePathInternal', name: r.name });
+        throw new WERR_errors_1.WERR_INTERNAL();
+    }
 }
 exports.WhatsOnChain = WhatsOnChain;
+function convertWocToBlockHeaderHex(woc) {
+    const bits = typeof woc.bits === 'string' ? parseInt(woc.bits, 16) : woc.bits;
+    if (!woc.previousblockhash) {
+        woc.previousblockhash = '0000000000000000000000000000000000000000000000000000000000000000'; // genesis
+    }
+    return {
+        version: woc.version,
+        previousHash: woc.previousblockhash,
+        merkleRoot: woc.merkleroot,
+        time: woc.time,
+        bits,
+        nonce: woc.nonce,
+        hash: woc.hash,
+        height: woc.height
+    };
+}
+async function getWhatsOnChainBlockHeaderByHash(hash, chain = 'main', apiKey) {
+    const config = apiKey ? { apiKey } : {};
+    const woc = new WhatsOnChain(chain, config);
+    const header = await woc.getBlockHeaderByHash(hash);
+    return header;
+}
 //# sourceMappingURL=WhatsOnChain.js.map