@bopen-io/wallet-toolbox 2.1.21-parity-fix.2 → 2.6.2-brc153.2

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

@@ -14,11 +14,31 @@ 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 whatsOnChainHelpers_1 = require("./whatsOnChainHelpers");
 class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
+    requestGate;
     constructor(chain = 'main', config = {}) {
         if (chain === 'mock')
-            throw new Error(`WhatsOnChain does not support 'mock' chain. Use MockServices directly.`);
+            throw new Error("WhatsOnChain does not support 'mock' chain. Use MockServices directly.");
         super(chain, config);
+        this.requestGate = config.requestGate;
+    }
+    async requestWithAnonymousAuthFallback(url, requestOptions) {
+        await this.requestGate?.();
+        const response = await this.httpClient.request(url, requestOptions);
+        if ((response.status !== 401 && response.status !== 403) || this.apiKey.trim() === '') {
+            return response;
+        }
+        // Treat the anonymous retry as another public request start so a stale
+        // key cannot create a burst above the documented keyless allowance.
+        if (this.requestGate != null)
+            await this.requestGate();
+        else
+            await (0, utilityHelpers_1.wait)(350);
+        return await this.httpClient.request(url, {
+            method: 'GET',
+            headers: { Accept: 'application/json' }
+        });
     }
     /**
      * POST
@@ -56,12 +76,13 @@ class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
         const url = `${this.URL}/txs/status`;
         try {
             const response = await this.httpClient.request(url, requestOptions);
-            if (!response.data || !response.ok || response.status !== 200)
-                throw new WERR_errors_1.WERR_INVALID_OPERATION(`Unable to get status for txids at this timei.`);
+            if (!response.data || !response.ok || response.status !== 200) {
+                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);
-                if (!d || d.error === 'unknown')
+                if (d == null || d.error === 'unknown')
                     r.results.push({ txid, status: 'unknown', depth: undefined });
                 else if (d.error !== undefined) {
                     console.log(`WhatsOnChain getStatusForTxids unexpected error ${d.error} ${txid}`);
@@ -74,8 +95,8 @@ class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
             }
             r.status = 'success';
         }
-        catch (eu) {
-            const e = WalletError_1.WalletError.fromUnknown(eu);
+        catch (error_) {
+            const e = WalletError_1.WalletError.fromUnknown(error_);
             r.error = e;
         }
         return r;
@@ -92,8 +113,9 @@ class WhatsOnChainNoServices 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)
+        if (!response.data || !response.ok || response.status !== 200) {
             throw new WERR_errors_1.WERR_INVALID_PARAMETER('txid', `valid transaction. '${txid}' response ${response.statusText}`);
+        }
         return 0;
     }
     /**
@@ -118,8 +140,9 @@ class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
             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)
+            if (!response.data || !response.ok || response.status !== 200) {
                 throw new WERR_errors_1.WERR_INVALID_PARAMETER('txid', `valid transaction. '${txid}' response ${response.statusText}`);
+            }
             return response.data;
         }
         throw new WERR_errors_1.WERR_INTERNAL();
@@ -183,7 +206,7 @@ class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
      * @returns txid returned by transaction processor of transaction broadcast
      */
     async postRawTx(rawTx) {
-        let txid = sdk_1.Utils.toHex((0, utilityHelpers_1.doubleSha256BE)(sdk_1.Utils.toArray(rawTx, 'hex')));
+        const txid = sdk_1.Utils.toHex((0, utilityHelpers_1.doubleSha256BE)(sdk_1.Utils.toArray(rawTx, 'hex')));
         const r = {
             txid,
             status: 'success',
@@ -191,7 +214,7 @@ class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
         };
         const headers = this.getHttpHeaders();
         headers['Content-Type'] = 'application/json';
-        headers['Accept'] = 'text/plain';
+        headers.Accept = 'text/plain';
         const requestOptions = {
             method: 'POST',
             headers,
@@ -210,55 +233,18 @@ class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
                     continue;
                 }
                 if (response.ok) {
-                    const txid = response.data;
                     r.notes.push({ ...nn(), what: 'postRawTxSuccess' });
                 }
                 else if (response.data === 'unexpected response code 500: Transaction already in the mempool') {
                     r.notes.push({ ...nne(), what: 'postRawTxSuccessAlreadyInMempool' });
                 }
                 else {
-                    r.status = 'error';
-                    if (response.data === 'unexpected response code 500: 258: txn-mempool-conflict') {
-                        r.doubleSpend = true; // this is a possible double spend attempt
-                        r.competingTxs = undefined; // not provided with any data for this.
-                        r.notes.push({ ...nne(), what: 'postRawTxErrorMempoolConflict' });
-                    }
-                    else if (response.data === 'unexpected response code 500: Missing inputs') {
-                        r.doubleSpend = true; // this is a possible double spend attempt
-                        r.competingTxs = undefined; // not provided with any data for this.
-                        r.notes.push({ ...nne(), what: 'postRawTxErrorMissingInputs' });
-                    }
-                    else {
-                        const n = {
-                            ...nne(),
-                            what: 'postRawTxError'
-                        };
-                        if (typeof response.data === 'string') {
-                            n.data = response.data.slice(0, 128);
-                            r.data = response.data;
-                        }
-                        else {
-                            r.data = '';
-                        }
-                        if (typeof response.statusText === 'string') {
-                            n.statusText = response.statusText.slice(0, 128);
-                            r.data += `,${response.statusText}`;
-                        }
-                        if (typeof response.status === 'string') {
-                            n.status = response.status.slice(0, 128);
-                            r.data += `,${response.status}`;
-                        }
-                        if (typeof response.status === 'number') {
-                            n.status = response.status;
-                            r.data += `,${response.status}`;
-                        }
-                        r.notes.push(n);
-                    }
+                    (0, whatsOnChainHelpers_1.handlePostRawTxErrorResponse)(r, nne, response);
                 }
             }
-            catch (eu) {
+            catch (error_) {
                 r.status = 'error';
-                const e = WalletError_1.WalletError.fromUnknown(eu);
+                const e = WalletError_1.WalletError.fromUnknown(error_);
                 r.notes.push({
                     ...nne(),
                     what: 'postRawTxCatch',
@@ -280,9 +266,9 @@ class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
         return r;
     }
     async updateBsvExchangeRate(rate, updateMsecs) {
-        if (rate) {
+        if (rate != null) {
             // Check if the rate we know is stale enough to update.
-            updateMsecs || (updateMsecs = 1000 * 60 * 15);
+            updateMsecs ||= 1000 * 60 * 15;
             if (new Date(Date.now() - updateMsecs) < rate.timestamp)
                 return rate;
         }
@@ -297,11 +283,12 @@ class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
                 continue;
             }
             // response.statusText is often, but not always 'OK' on success...
-            if (!response.data || !response.ok || response.status !== 200)
+            if (!response.data || !response.ok || response.status !== 200) {
                 throw new WERR_errors_1.WERR_INVALID_OPERATION(`WoC exchangerate response ${response.statusText}`);
+            }
             const wocrate = response.data;
             if (wocrate.currency !== 'USD')
-                wocrate.rate = NaN;
+                wocrate.rate = Number.NaN;
             const newRate = {
                 timestamp: new Date(),
                 base: 'USD',
@@ -312,65 +299,41 @@ class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
         throw new WERR_errors_1.WERR_INTERNAL();
     }
     async getUtxoStatus(output, outputFormat, outpoint) {
-        const r = {
-            name: 'WoC',
-            status: 'error',
-            error: new WERR_errors_1.WERR_INTERNAL(),
-            details: []
-        };
-        for (let retry = 0;; retry++) {
-            let url = '';
+        const r = { name: 'WoC', status: 'error', error: new WERR_errors_1.WERR_INTERNAL(), details: [] };
+        const scriptHash = (0, Services_1.validateScriptHash)(output, outputFormat);
+        const url = `${this.URL}/script/${scriptHash}/unspent/all`;
+        const requestOptions = { method: 'GET', headers: this.getHttpHeaders() };
+        for (let retry = 0; retry <= 2; retry++) {
             try {
-                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);
+                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_OPERATION(`WoC getUtxoStatus response ${response.statusText}`);
-                const data = response.data;
-                if (data.script !== scriptHash || !Array.isArray(data.result)) {
-                    throw new WERR_errors_1.WERR_INTERNAL('data. is not an array');
-                }
-                if (data.result.length === 0) {
-                    r.status = 'success';
-                    r.error = undefined;
-                    r.isUtxo = false;
-                }
-                else {
-                    r.status = 'success';
-                    r.error = undefined;
-                    for (const s of data.result) {
-                        r.details.push({
-                            txid: s.tx_hash,
-                            satoshis: s.value,
-                            height: s.height,
-                            index: s.tx_pos
-                        });
-                    }
-                    if (outpoint) {
-                        const { txid, vout } = sdk_1.Validation.parseWalletOutpoint(outpoint);
-                        r.isUtxo = r.details.find(d => d.txid === txid && d.index === vout) !== undefined;
-                    }
-                    else
-                        r.isUtxo = r.details.length > 0;
-                }
+                this.applyUtxoStatusResponse(r, response, scriptHash, outpoint);
                 return r;
             }
-            catch (eu) {
-                const e = WalletError_1.WalletError.fromUnknown(eu);
-                if (e.code !== 'ECONNRESET' || retry > 2) {
-                    r.error = new WERR_errors_1.WERR_INTERNAL(`service failure: ${url}, error: ${JSON.stringify(WalletError_1.WalletError.fromUnknown(eu))}`);
+            catch (error_) {
+                const shouldRetry = (0, whatsOnChainHelpers_1.handleUtxoConnReset)(r, error_, url, retry, 2);
+                if (!shouldRetry)
                     return r;
-                }
             }
         }
+        return r;
+    }
+    applyUtxoStatusResponse(r, response, scriptHash, outpoint) {
+        if (!response.data || !response.ok || response.status !== 200) {
+            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 WERR_errors_1.WERR_INTERNAL('data. is not an array');
+        r.status = 'success';
+        r.error = undefined;
+        if (data.result.length === 0)
+            r.isUtxo = false;
+        else
+            (0, whatsOnChainHelpers_1.populateUtxoDetails)(r, data.result, outpoint);
     }
     async getScriptHashConfirmedHistory(hash) {
         const r = {
@@ -382,41 +345,29 @@ class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
         // reverse hash from LE to BE for Woc
         hash = sdk_1.Utils.toHex(sdk_1.Utils.toArray(hash, 'hex').reverse());
         const url = `${this.URL}/script/${hash}/confirmed/history`;
-        for (let retry = 0;; retry++) {
+        const methodName = 'getScriptHashConfirmedHistory';
+        for (let retry = 0; retry <= 2; retry++) {
             try {
-                const requestOptions = {
-                    method: 'GET',
-                    headers: this.getHttpHeaders()
-                };
+                const requestOptions = { method: 'GET', headers: this.getHttpHeaders() };
                 const response = await this.httpClient.request(url, requestOptions);
-                if (response.statusText === 'Too Many Requests' && retry < 2) {
+                const action = (0, whatsOnChainHelpers_1.handleScriptHashHistoryResponse)(r, response, methodName, retry);
+                if (action === 'continue') {
                     await (0, utilityHelpers_1.wait)(2000);
                     continue;
                 }
-                if (!response.ok && response.status === 404) {
-                    // There is no history for this script hash...
-                    r.status = 'success';
-                    return r;
-                }
-                // response.statusText is often, but not always 'OK' on success...
-                if (!response.data || !response.ok || response.status !== 200) {
-                    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 WERR_errors_1.WERR_BAD_REQUEST(`WoC getScriptHashConfirmedHistory error ${response.data.error}`);
+                if (action === 'return')
                     return r;
-                }
-                r.history = response.data.result.map(d => ({ txid: d.tx_hash, height: d.height }));
+                r.history = response.data.result.map((d) => ({
+                    txid: d.tx_hash,
+                    height: d.height
+                }));
                 r.status = 'success';
                 return r;
             }
-            catch (eu) {
-                const e = WalletError_1.WalletError.fromUnknown(eu);
-                if (e.code !== 'ECONNRESET' || retry > 2) {
-                    r.error = new WERR_errors_1.WERR_INTERNAL(`WoC getScriptHashConfirmedHistory service failure: ${url}, error: ${JSON.stringify(WalletError_1.WalletError.fromUnknown(eu))}`);
+            catch (error_) {
+                const shouldRetry = (0, whatsOnChainHelpers_1.handleScriptHashHistoryCatch)(r, error_, url, methodName, retry, 2);
+                if (!shouldRetry)
                     return r;
-                }
             }
         }
         return r;
@@ -431,44 +382,32 @@ class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
         // reverse hash from LE to BE for Woc
         hash = sdk_1.Utils.toHex(sdk_1.Utils.toArray(hash, 'hex').reverse());
         const url = `${this.URL}/script/${hash}/unconfirmed/history`;
+        const methodName = 'getScriptHashUnconfirmedHistory';
         for (let retry = 0;; retry++) {
             try {
-                const requestOptions = {
-                    method: 'GET',
-                    headers: this.getHttpHeaders()
-                };
+                const requestOptions = { method: 'GET', headers: this.getHttpHeaders() };
                 const response = await this.httpClient.request(url, requestOptions);
-                if (response.statusText === 'Too Many Requests' && retry < 2) {
+                const action = (0, whatsOnChainHelpers_1.handleScriptHashHistoryResponse)(r, response, methodName, retry);
+                if (action === 'continue') {
                     await (0, utilityHelpers_1.wait)(2000);
                     continue;
                 }
-                if (!response.ok && response.status === 404) {
-                    // There is no history for this script hash...
-                    r.status = 'success';
-                    return r;
-                }
-                // response.statusText is often, but not always 'OK' on success...
-                if (!response.data || !response.ok || response.status !== 200) {
-                    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 WERR_errors_1.WERR_BAD_REQUEST(`WoC getScriptHashUnconfirmedHistory error ${response.data.error}`);
+                if (action === 'return')
                     return r;
-                }
-                r.history = response.data.result.map(d => ({ txid: d.tx_hash, height: d.height }));
+                r.history = response.data.result.map((d) => ({
+                    txid: d.tx_hash,
+                    height: d.height
+                }));
                 r.status = 'success';
                 return r;
             }
-            catch (eu) {
-                const e = WalletError_1.WalletError.fromUnknown(eu);
-                if (e.code !== 'ECONNRESET' || retry > 2) {
-                    r.error = new WERR_errors_1.WERR_INTERNAL(`WoC getScriptHashUnconfirmedHistory service failure: ${url}, error: ${JSON.stringify(WalletError_1.WalletError.fromUnknown(eu))}`);
+            catch (error_) {
+                // Note: original used retry > 2 (not >= 2) for the unconfirmed variant
+                const shouldRetry = (0, whatsOnChainHelpers_1.handleScriptHashHistoryCatch)(r, error_, url, methodName, retry, 3);
+                if (!shouldRetry)
                     return r;
-                }
             }
         }
-        return r;
     }
     async getScriptHashHistory(hash) {
         const r1 = await this.getScriptHashConfirmedHistory(hash);
@@ -509,7 +448,7 @@ class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
         };
         const url = `${this.URL}/block/${hash}/header`;
         for (let retry = 0; retry < 2; retry++) {
-            const response = await this.httpClient.request(url, requestOptions);
+            const response = await this.requestWithAnonymousAuthFallback(url, requestOptions);
             if (response.statusText === 'Too Many Requests' && retry < 2) {
                 await (0, utilityHelpers_1.wait)(2000);
                 continue;
@@ -517,8 +456,9 @@ class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
             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)
+            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;
         }
@@ -532,14 +472,15 @@ class WhatsOnChainNoServices extends SdkWhatsOnChain_1.default {
         };
         const url = `${this.URL}/chain/info`;
         for (let retry = 0; retry < 2; retry++) {
-            const response = await this.httpClient.request(url, requestOptions);
+            const response = await this.requestWithAnonymousAuthFallback(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)
+            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();
@@ -550,6 +491,7 @@ exports.WhatsOnChainNoServices = WhatsOnChainNoServices;
  *
  */
 class WhatsOnChain extends WhatsOnChainNoServices {
+    services;
     constructor(chain = 'main', config = {}, services) {
         super(chain, config);
         this.services = services || new Services_1.Services(chain);
@@ -560,104 +502,71 @@ class WhatsOnChain extends WhatsOnChainNoServices {
      */
     async getMerklePath(txid, services) {
         const r = { name: 'WoCTsc', notes: [] };
-        const headers = this.getHttpHeaders();
-        const requestOptions = {
-            method: 'GET',
-            headers
-        };
+        const name = r.name;
+        const requestOptions = { method: 'GET', headers: this.getHttpHeaders() };
+        const url = `${this.URL}/tx/${txid}/proof/tsc`;
         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
-                    });
+                const response = await this.httpClient.request(url, requestOptions);
+                const classification = (0, whatsOnChainHelpers_1.classifyMerklePathResponse)(response.status, response.statusText, retry);
+                if (classification === 'retry') {
+                    r.notes.push((0, whatsOnChainHelpers_1.makeMerklePathNote)('getMerklePathRetry', 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,
+                if (classification === 'notFound') {
+                    r.notes.push((0, whatsOnChainHelpers_1.makeMerklePathNote)('getMerklePathNotFound', 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');
-                }
+                await this.applyMerklePathResponse(r, name, txid, response, services);
             }
-            catch (eu) {
-                const e = WalletError_1.WalletError.fromUnknown(eu);
-                r.notes.push({
-                    what: 'getMerklePathError',
-                    name: r.name,
-                    code: e.code,
-                    description: e.description
-                });
+            catch (error_) {
+                const e = WalletError_1.WalletError.fromUnknown(error_);
+                r.notes.push((0, whatsOnChainHelpers_1.makeMerklePathNote)('getMerklePathError', name, { code: e.code, description: e.description }));
                 r.error = e;
             }
             return r;
         }
-        r.notes.push({ what: 'getMerklePathInternal', name: r.name });
+        r.notes.push((0, whatsOnChainHelpers_1.makeMerklePathNote)('getMerklePathInternal', name));
         throw new WERR_errors_1.WERR_INTERNAL();
     }
+    async applyMerklePathResponse(r, name, txid, response, services) {
+        if (!response.ok || response.status !== 200) {
+            r.notes.push((0, whatsOnChainHelpers_1.makeMerklePathNote)('getMerklePathBadStatus', 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((0, whatsOnChainHelpers_1.makeMerklePathNote)('getMerklePathNoData', name, { status: response.status, statusText: response.statusText }));
+            return;
+        }
+        if (!Array.isArray(response.data))
+            response.data = [response.data];
+        if (response.data.length !== 1)
+            return;
+        const p = response.data[0];
+        const header = await services.hashToHeader(p.target);
+        if (header) {
+            r.merklePath = (0, tscProofToMerklePath_1.convertProofToMerklePath)(txid, { index: p.index, nodes: p.nodes, height: header.height });
+            r.header = header;
+            r.notes.push((0, whatsOnChainHelpers_1.makeMerklePathNote)('getMerklePathSuccess', name, { status: response.status, statusText: response.statusText }));
+        }
+        else {
+            r.notes.push((0, whatsOnChainHelpers_1.makeMerklePathNote)('getMerklePathNoHeader', name, {
+                target: p.target,
+                status: response.status,
+                statusText: response.statusText
+            }));
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('blockhash', 'a valid on-chain block hash');
+        }
+    }
 }
 exports.WhatsOnChain = WhatsOnChain;
 function convertWocToBlockHeaderHex(woc) {
-    const bits = typeof woc.bits === 'string' ? parseInt(woc.bits, 16) : woc.bits;
+    const bits = typeof woc.bits === 'string' ? Number.parseInt(woc.bits, 16) : woc.bits;
     if (!woc.previousblockhash) {
         woc.previousblockhash = '0000000000000000000000000000000000000000000000000000000000000000'; // genesis
     }