@bsv/wallet-toolbox 1.3.20 → 1.3.22

package/mobile/out/src/services/providers/SdkWhatsOnChain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdkWhatsOnChain.js","sourceRoot":"","sources":["../../../../../src/services/providers/SdkWhatsOnChain.ts"],"names":[],"mappings":";;AAAA,kCAA0F;AAM1F;;GAEG;AACH,MAAqB,eAAe;IAMlC;;;;;OAKG;IACH,YAAY,UAAmC,MAAM,EAAE,SAA6B,EAAE;QACpF,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAA;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,GAAG,GAAG,uCAAuC,OAAO,EAAE,CAAA;QAC3D,IAAI,CAAC,UAAU,GAAG,UAAU,aAAV,UAAU,cAAV,UAAU,GAAI,IAAA,uBAAiB,GAAE,CAAA;QACnD,IAAI,CAAC,MAAM,GAAG,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAA;IAC5B,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,IAAY,EAAE,MAAc;QACrD,MAAM,cAAc,GAAG;YACrB,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE;SAC/B,CAAA;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAC5C,GAAG,IAAI,CAAC,GAAG,UAAU,MAAM,SAAS,EACpC,cAAc,CACf,CAAA;QACD,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAA;YACpC,OAAO,UAAU,KAAK,IAAI,CAAA;QAC5B,CAAC;aAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACnC,OAAO,KAAK,CAAA;QACd,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,0CAA0C,MAAM,yBAAyB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAC1G,CAAA;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC;YACH,MAAM,cAAc,GAAG;gBACrB,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE;aAC/B,CAAA;YAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAqB,GAAG,IAAI,CAAC,GAAG,gBAAgB,EAAE,cAAc,CAAC,CAAA;YAC/G,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;YAChC,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,qDAAqD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACxG,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,qDAAqD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC9G,CAAA;QACH,CAAC;IACH,CAAC;IAES,cAAc;QACtB,MAAM,OAAO,GAA2B;YACtC,MAAM,EAAE,kBAAkB;SAC3B,CAAA;QAED,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACjE,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,MAAM,CAAA;QACrC,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;CACF;AAzED,kCAyEC"}

package/mobile/out/src/services/providers/WhatsOnChain.d.ts

@@ -0,0 +1,71 @@
+import { Beef, HexString, WhatsOnChainConfig } from '@bsv/sdk';
+import { sdk, Services } from '../../index.client';
+import SdkWhatsOnChain from './SdkWhatsOnChain';
+/**
+ *
+ */
+export declare class WhatsOnChain extends SdkWhatsOnChain {
+    services: Services;
+    constructor(chain?: sdk.Chain, config?: WhatsOnChainConfig, services?: Services);
+    /**
+     * POST
+     * https://api.whatsonchain.com/v1/bsv/main/txs/status
+     * Content-Type: application/json
+     * data: "{\"txids\":[\"6815f8014db74eab8b7f75925c68929597f1d97efa970109d990824c25e5e62b\"]}"
+     *
+     * result for a mined txid:
+     *     [{
+     *        "txid":"294cd1ebd5689fdee03509f92c32184c0f52f037d4046af250229b97e0c8f1aa",
+     *        "blockhash":"000000000000000004b5ce6670f2ff27354a1e87d0a01bf61f3307f4ccd358b5",
+     *        "blockheight":612251,
+     *        "blocktime":1575841517,
+     *        "confirmations":278272
+     *      }]
+     *
+     * result for a valid recent txid:
+     *     [{"txid":"6815f8014db74eab8b7f75925c68929597f1d97efa970109d990824c25e5e62b"}]
+     *
+     * result for an unknown txid:
+     *     [{"txid":"6815f8014db74eab8b7f75925c68929597f1d97efa970109d990824c25e5e62c","error":"unknown"}]
+     */
+    getStatusForTxids(txids: string[]): Promise<sdk.GetStatusForTxidsResult>;
+    /**
+     * 2025-02-16 throwing internal server error 500.
+     * @param txid
+     * @returns
+     */
+    getTxPropagation(txid: string): Promise<number>;
+    /**
+     * May return undefined for unmined transactions that are in the mempool.
+     * @param txid
+     * @returns raw transaction as hex string or undefined if txid not found in mined block.
+     */
+    getRawTx(txid: string): Promise<string | undefined>;
+    getRawTxResult(txid: string): Promise<sdk.GetRawTxResult>;
+    /**
+     * WhatsOnChain does not natively support a postBeef end-point aware of multiple txids of interest in the Beef.
+     *
+     * Send rawTx in `txids` order from beef.
+     *
+     * @param beef
+     * @param txids
+     * @returns
+     */
+    postBeef(beef: Beef, txids: string[]): Promise<sdk.PostBeefResult>;
+    /**
+     * @param rawTx raw transaction to broadcast as hex string
+     * @returns txid returned by transaction processor of transaction broadcast
+     */
+    postRawTx(rawTx: HexString): Promise<sdk.PostTxResultForTxid>;
+    /**
+     * @param txid
+     * @returns
+     */
+    getMerklePath(txid: string, services: sdk.WalletServices): Promise<sdk.GetMerklePathResult>;
+    updateBsvExchangeRate(rate?: sdk.BsvExchangeRate, updateMsecs?: number): Promise<sdk.BsvExchangeRate>;
+    getUtxoStatus(output: string, outputFormat?: sdk.GetUtxoStatusOutputFormat, outpoint?: string): Promise<sdk.GetUtxoStatusResult>;
+    getScriptHashConfirmedHistory(hash: string): Promise<sdk.GetScriptHashHistoryResult>;
+    getScriptHashUnconfirmedHistory(hash: string): Promise<sdk.GetScriptHashHistoryResult>;
+    getScriptHashHistory(hash: string): Promise<sdk.GetScriptHashHistoryResult>;
+}
+//# sourceMappingURL=WhatsOnChain.d.ts.map

package/mobile/out/src/services/providers/WhatsOnChain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WhatsOnChain.d.ts","sourceRoot":"","sources":["../../../../../src/services/providers/WhatsOnChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAS,kBAAkB,EAAE,MAAM,UAAU,CAAA;AACrE,OAAO,EAAqC,GAAG,EAAE,QAAQ,EAA4B,MAAM,oBAAoB,CAAA;AAE/G,OAAO,eAAe,MAAM,mBAAmB,CAAA;AAG/C;;GAEG;AACH,qBAAa,YAAa,SAAQ,eAAe;IAC/C,QAAQ,EAAE,QAAQ,CAAA;gBAEN,KAAK,GAAE,GAAG,CAAC,KAAc,EAAE,MAAM,GAAE,kBAAuB,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAK3F;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IAyC9E;;;;OAIG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAerD;;;;OAIG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA6BnD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAa/D;;;;;;;;OAQG;IACG,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAwCxE;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAiGnE;;;OAGG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAwG3F,qBAAqB,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,eAAe,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAyCrG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,GAAG,CAAC,yBAAyB,EAC5C,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAwE7B,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;IA+DpF,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;IA+DtF,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;CAQlF"}

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

@@ -0,0 +1,582 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhatsOnChain = void 0;
+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) {
+        super(chain, config);
+        this.services = services || new index_client_1.Services(chain);
+    }
+    /**
+     * POST
+     * https://api.whatsonchain.com/v1/bsv/main/txs/status
+     * Content-Type: application/json
+     * data: "{\"txids\":[\"6815f8014db74eab8b7f75925c68929597f1d97efa970109d990824c25e5e62b\"]}"
+     *
+     * result for a mined txid:
+     *     [{
+     *        "txid":"294cd1ebd5689fdee03509f92c32184c0f52f037d4046af250229b97e0c8f1aa",
+     *        "blockhash":"000000000000000004b5ce6670f2ff27354a1e87d0a01bf61f3307f4ccd358b5",
+     *        "blockheight":612251,
+     *        "blocktime":1575841517,
+     *        "confirmations":278272
+     *      }]
+     *
+     * result for a valid recent txid:
+     *     [{"txid":"6815f8014db74eab8b7f75925c68929597f1d97efa970109d990824c25e5e62b"}]
+     *
+     * result for an unknown txid:
+     *     [{"txid":"6815f8014db74eab8b7f75925c68929597f1d97efa970109d990824c25e5e62c","error":"unknown"}]
+     */
+    async getStatusForTxids(txids) {
+        const r = {
+            name: 'WoC',
+            status: 'error',
+            error: undefined,
+            results: []
+        };
+        const requestOptions = {
+            method: 'POST',
+            headers: this.getHttpHeaders(),
+            data: { txids }
+        };
+        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 index_client_1.sdk.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')
+                    r.results.push({ txid, status: 'unknown', depth: undefined });
+                else if (d.error !== undefined) {
+                    console.log(`WhatsOnChain getStatusForTxids unexpected error ${d.error} ${txid}`);
+                    r.results.push({ txid, status: 'unknown', depth: undefined });
+                }
+                else if (d.confirmations === undefined)
+                    r.results.push({ txid, status: 'known', depth: 0 });
+                else
+                    r.results.push({ txid, status: 'mined', depth: d.confirmations });
+            }
+            r.status = 'success';
+        }
+        catch (eu) {
+            const e = index_client_1.sdk.WalletError.fromUnknown(eu);
+            r.error = e;
+        }
+        return r;
+    }
+    /**
+     * 2025-02-16 throwing internal server error 500.
+     * @param txid
+     * @returns
+     */
+    async getTxPropagation(txid) {
+        const requestOptions = {
+            method: 'GET',
+            headers: this.getHttpHeaders()
+        };
+        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}`);
+        return 0;
+    }
+    /**
+     * May return undefined for unmined transactions that are in the mempool.
+     * @param txid
+     * @returns raw transaction as hex string or undefined if txid not found in mined block.
+     */
+    async getRawTx(txid) {
+        const headers = this.getHttpHeaders();
+        headers['Cache-Control'] = 'no-cache';
+        const requestOptions = {
+            method: 'GET',
+            headers
+        };
+        const url = `${this.URL}/tx/${txid}/hex`;
+        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);
+                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}`);
+            return response.data;
+        }
+        throw new index_client_1.sdk.WERR_INTERNAL();
+    }
+    async getRawTxResult(txid) {
+        const r = { name: 'WoC', txid: (0, index_client_1.asString)(txid) };
+        try {
+            const rawTxHex = await this.getRawTx(txid);
+            if (rawTxHex)
+                r.rawTx = (0, index_client_1.asArray)(rawTxHex);
+        }
+        catch (err) {
+            r.error = index_client_1.sdk.WalletError.fromUnknown(err);
+        }
+        return r;
+    }
+    /**
+     * WhatsOnChain does not natively support a postBeef end-point aware of multiple txids of interest in the Beef.
+     *
+     * Send rawTx in `txids` order from beef.
+     *
+     * @param beef
+     * @param txids
+     * @returns
+     */
+    async postBeef(beef, txids) {
+        const r = {
+            name: 'WoC',
+            status: 'success',
+            txidResults: [],
+            notes: []
+        };
+        let delay = false;
+        const nn = () => ({ name: 'WoCpostBeef', when: new Date().toISOString() });
+        const nne = () => ({ ...nn(), beef: beef.toHex(), txids: txids.join(',') });
+        for (const txid of txids) {
+            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);
+            }
+            delay = true;
+            const tr = await this.postRawTx(rawTx);
+            if (txid !== tr.txid) {
+                tr.notes.push({ ...nne(), what: 'postRawTxTxidChanged', txid, trTxid: tr.txid });
+            }
+            r.txidResults.push(tr);
+            if (r.status === 'success' && tr.status !== 'success')
+                r.status = 'error';
+        }
+        if (r.status === 'success') {
+            r.notes.push({ ...nn(), what: 'postBeefSuccess' });
+        }
+        else {
+            r.notes.push({ ...nne(), what: 'postBeefError' });
+        }
+        return r;
+    }
+    /**
+     * @param rawTx raw transaction to broadcast as hex string
+     * @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')));
+        const r = {
+            txid,
+            status: 'success',
+            notes: []
+        };
+        const headers = this.getHttpHeaders();
+        headers['Content-Type'] = 'application/json';
+        headers['Accept'] = 'text/plain';
+        const requestOptions = {
+            method: 'POST',
+            headers,
+            data: { txhex: rawTx }
+        };
+        const url = `${this.URL}/tx/raw`;
+        const nn = () => ({ name: 'WoCpostRawTx', when: new Date().toISOString() });
+        const nne = () => ({ ...nn(), rawTx, txid, url });
+        const retryLimit = 5;
+        for (let retry = 0; retry < retryLimit; retry++) {
+            try {
+                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);
+                    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);
+                    }
+                }
+            }
+            catch (eu) {
+                r.status = 'error';
+                const e = index_client_1.sdk.WalletError.fromUnknown(eu);
+                r.notes.push({
+                    ...nne(),
+                    what: 'postRawTxCatch',
+                    code: e.code,
+                    description: e.description
+                });
+                r.serviceError = true;
+                r.data = `${e.code} ${e.description}`;
+            }
+            return r;
+        }
+        r.status = 'error';
+        r.serviceError = true;
+        r.notes.push({
+            ...nne(),
+            what: 'postRawTxRetryLimit',
+            retryLimit
+        });
+        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.
+            updateMsecs || (updateMsecs = 1000 * 60 * 15);
+            if (new Date(Date.now() - updateMsecs) < rate.timestamp)
+                return rate;
+        }
+        const requestOptions = {
+            method: 'GET',
+            headers: this.getHttpHeaders()
+        };
+        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);
+                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}`);
+            const wocrate = response.data;
+            if (wocrate.currency !== 'USD')
+                wocrate.rate = NaN;
+            const newRate = {
+                timestamp: new Date(),
+                base: 'USD',
+                rate: wocrate.rate
+            };
+            return newRate;
+        }
+        throw new index_client_1.sdk.WERR_INTERNAL();
+    }
+    async getUtxoStatus(output, outputFormat, outpoint) {
+        const r = {
+            name: 'WoC',
+            status: 'error',
+            error: new index_client_1.sdk.WERR_INTERNAL(),
+            details: []
+        };
+        for (let retry = 0;; retry++) {
+            let url = '';
+            try {
+                const scriptHash = (0, index_client_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);
+                    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}`);
+                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');
+                }
+                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 } = (0, sdk_2.parseWalletOutpoint)(outpoint);
+                        r.isUtxo = r.details.find(d => d.txid === txid && d.index === vout) !== undefined;
+                    }
+                    else
+                        r.isUtxo = r.details.length > 0;
+                }
+                return r;
+            }
+            catch (eu) {
+                const e = index_client_1.sdk.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))}`);
+                    return r;
+                }
+            }
+        }
+    }
+    async getScriptHashConfirmedHistory(hash) {
+        const r = {
+            name: 'WoC',
+            status: 'error',
+            error: undefined,
+            history: []
+        };
+        // 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++) {
+            try {
+                const requestOptions = {
+                    method: 'GET',
+                    headers: this.getHttpHeaders()
+                };
+                const response = await this.httpClient.request(url, requestOptions);
+                if (response.statusText === 'Too Many Requests' && retry < 2) {
+                    await (0, index_client_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 index_client_1.sdk.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}`);
+                    return r;
+                }
+                r.history = response.data.result.map(d => ({ txid: d.tx_hash, height: d.height }));
+                r.status = 'success';
+                return r;
+            }
+            catch (eu) {
+                const e = index_client_1.sdk.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))}`);
+                    return r;
+                }
+            }
+        }
+        return r;
+    }
+    async getScriptHashUnconfirmedHistory(hash) {
+        const r = {
+            name: 'WoC',
+            status: 'error',
+            error: undefined,
+            history: []
+        };
+        // 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`;
+        for (let retry = 0;; retry++) {
+            try {
+                const requestOptions = {
+                    method: 'GET',
+                    headers: this.getHttpHeaders()
+                };
+                const response = await this.httpClient.request(url, requestOptions);
+                if (response.statusText === 'Too Many Requests' && retry < 2) {
+                    await (0, index_client_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 index_client_1.sdk.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}`);
+                    return r;
+                }
+                r.history = response.data.result.map(d => ({ txid: d.tx_hash, height: d.height }));
+                r.status = 'success';
+                return r;
+            }
+            catch (eu) {
+                const e = index_client_1.sdk.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))}`);
+                    return r;
+                }
+            }
+        }
+        return r;
+    }
+    async getScriptHashHistory(hash) {
+        const r1 = await this.getScriptHashConfirmedHistory(hash);
+        if (r1.error || r1.status !== 'success')
+            return r1;
+        const r2 = await this.getScriptHashUnconfirmedHistory(hash);
+        if (r2.error || r2.status !== 'success')
+            return r2;
+        r1.history = r1.history.concat(r2.history);
+        return r1;
+    }
+}
+exports.WhatsOnChain = WhatsOnChain;
+//# sourceMappingURL=WhatsOnChain.js.map