@bsv/wallet-toolbox 2.12.0 → 2.13.2

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

@@ -1,6 +1,43 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const sdk_1 = require("@bsv/sdk");
+const HEX_32_BYTES = /^[0-9a-fA-F]{64}$/;
+const MAX_BLOCK_HEIGHT = 0x7fffffff;
+const DEFAULT_REQUEST_TIMEOUT_MSECS = 30_000;
+const MAX_REQUEST_TIMEOUT_MSECS = 60 * 60 * 1000;
+function plainDataProperties(value, name) {
+    if (value == null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${name} must be an accessor-free plain data object.`);
+    }
+    const prototype = Object.getPrototypeOf(value);
+    const properties = Object.getOwnPropertyDescriptors(value);
+    if ((prototype !== Object.prototype && prototype !== null) ||
+        Object.getOwnPropertySymbols(value).length !== 0 ||
+        Object.keys(properties).length > 64 ||
+        Object.values(properties).some(property => property.get != null || property.set != null)) {
+        throw new Error(`${name} must be an accessor-free plain data object.`);
+    }
+    return properties;
+}
+function firstHeaderHeight(value) {
+    if (!Array.isArray(value) || value.length === 0 || value.length > 2_000) {
+        throw new Error('WhatsOnChain block headers must be a bounded dense array.');
+    }
+    const properties = Object.getOwnPropertyDescriptors(value);
+    const expected = new Set(['length', ...Array.from({ length: value.length }, (_, index) => String(index))]);
+    if (Object.getOwnPropertySymbols(value).length !== 0 ||
+        Object.keys(properties).length !== expected.size ||
+        Object.keys(properties).some(key => !expected.has(key)) ||
+        Object.values(properties).some(property => property.get != null || property.set != null)) {
+        throw new Error('WhatsOnChain block headers must be a bounded dense array.');
+    }
+    const header = plainDataProperties(properties['0'].value, 'WhatsOnChain block header');
+    const height = header.height?.value;
+    if (!Number.isSafeInteger(height) || height < 0 || height > MAX_BLOCK_HEIGHT) {
+        throw new Error('WhatsOnChain returned an invalid block height.');
+    }
+    return height;
+}
 /**
  * Represents a chain tracker based on What's On Chain .
  */
@@ -9,6 +46,7 @@ class SdkWhatsOnChain {
     apiKey;
     URL;
     httpClient;
+    requestTimeoutMsecs;
     /**
      * Constructs an instance of the WhatsOnChain ChainTracker.
      *
@@ -16,7 +54,25 @@ class SdkWhatsOnChain {
      * @param {WhatsOnChainConfig} config - Configuration options for the WhatsOnChain ChainTracker.
      */
     constructor(network = 'main', config = {}) {
-        const { apiKey, httpClient } = config;
+        if (!['main', 'test', 'stn', 'ttn', 'tstn'].includes(network)) {
+            throw new Error('WhatsOnChain network is invalid.');
+        }
+        const properties = plainDataProperties(config, 'WhatsOnChain config');
+        const apiKey = properties.apiKey?.value;
+        const httpClient = properties.httpClient?.value;
+        const requestTimeoutMsecs = properties.requestTimeoutMsecs?.value ?? DEFAULT_REQUEST_TIMEOUT_MSECS;
+        if (apiKey !== undefined &&
+            (typeof apiKey !== 'string' || apiKey.length > 4_096 || /\p{Cc}/u.test(apiKey))) {
+            throw new Error('WhatsOnChain API key is invalid.');
+        }
+        if (httpClient !== undefined && (httpClient == null || typeof httpClient.request !== 'function')) {
+            throw new Error('WhatsOnChain HTTP client is invalid.');
+        }
+        if (!Number.isSafeInteger(requestTimeoutMsecs) ||
+            requestTimeoutMsecs < 1 ||
+            requestTimeoutMsecs > MAX_REQUEST_TIMEOUT_MSECS) {
+            throw new Error(`WhatsOnChain request timeout must be an integer from 1 through ${MAX_REQUEST_TIMEOUT_MSECS}.`);
+        }
         this.network = network;
         if (network === 'ttn') {
             this.URL = 'https://api.woc-ttn.bsvblockchain.tech/v1/bsv/test';
@@ -32,22 +88,39 @@ class SdkWhatsOnChain {
         }
         this.httpClient = httpClient ?? (0, sdk_1.defaultHttpClient)();
         this.apiKey = apiKey ?? '';
+        this.requestTimeoutMsecs = requestTimeoutMsecs;
+    }
+    async request(url, options) {
+        const timeoutSignal = AbortSignal.timeout(this.requestTimeoutMsecs);
+        const signal = options.signal == null ? timeoutSignal : AbortSignal.any([options.signal, timeoutSignal]);
+        return await this.httpClient.request(url, { ...options, signal });
     }
     async isValidRootForHeight(root, height) {
+        if (typeof root !== 'string' || !HEX_32_BYTES.test(root)) {
+            throw new Error('WhatsOnChain Merkle root must be 32 hex bytes.');
+        }
+        if (!Number.isSafeInteger(height) || height < 0 || height > MAX_BLOCK_HEIGHT) {
+            throw new Error(`WhatsOnChain height must be an integer from 0 through ${MAX_BLOCK_HEIGHT}.`);
+        }
+        root = root.toLowerCase();
         const requestOptions = {
             method: 'GET',
             headers: this.getHttpHeaders()
         };
-        const response = await this.httpClient.request(`${this.URL}/block/${height}/header`, requestOptions);
+        const response = await this.request(`${this.URL}/block/${height}/header`, requestOptions);
         if (response.ok) {
-            const { merkleroot } = response.data;
-            return merkleroot === root;
+            const properties = plainDataProperties(response.data, 'WhatsOnChain block header');
+            const merkleRoot = properties.merkleroot?.value;
+            if (typeof merkleRoot !== 'string' || !HEX_32_BYTES.test(merkleRoot)) {
+                throw new Error('WhatsOnChain returned an invalid Merkle root.');
+            }
+            return merkleRoot.toLowerCase() === root;
         }
         else if (response.status === 404) {
             return false;
         }
         else {
-            throw new Error(`Failed to verify merkleroot for height ${height} because of an error: ${JSON.stringify(response.data)} `);
+            throw new Error('Failed to verify Merkle root with WhatsOnChain.');
         }
     }
     async currentHeight() {
@@ -56,16 +129,16 @@ class SdkWhatsOnChain {
                 method: 'GET',
                 headers: this.getHttpHeaders()
             };
-            const response = await this.httpClient.request(`${this.URL}/block/headers`, requestOptions);
+            const response = await this.request(`${this.URL}/block/headers`, requestOptions);
             if (response.ok) {
-                return response.data[0].height;
+                return firstHeaderHeight(response.data);
             }
             else {
-                throw new Error(`Failed to get current height because of an error: ${JSON.stringify(response.data)} `);
+                throw new Error('Failed to get current height from WhatsOnChain.');
             }
         }
-        catch (error) {
-            throw new Error(`Failed to get current height because of an error: ${error instanceof Error ? error.message : String(error)}`);
+        catch {
+            throw new Error('Failed to get current height from WhatsOnChain.');
         }
     }
     getHttpHeaders() {

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

@@ -1 +1 @@
-{"version":3,"file":"SdkWhatsOnChain.js","sourceRoot":"","sources":["../../../../src/services/providers/SdkWhatsOnChain.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SdkWhatsOnChain.js","sourceRoot":"","sources":["../../../../src/services/providers/SdkWhatsOnChain.ts"],"names":[],"mappings":"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"}

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

@@ -3,9 +3,12 @@ import SdkWhatsOnChain from './SdkWhatsOnChain';
 import { Chain } from '../../sdk/types';
 import { BlockHeader, BsvExchangeRate, GetMerklePathResult, GetRawTxResult, GetScriptHashHistoryResult, GetStatusForTxidsResult, GetUtxoStatusOutputFormat, GetUtxoStatusResult, PostBeefResult, PostTxResultForTxid, WalletServices } from '../../sdk/WalletServices.interfaces';
 import { Services } from '../Services';
+export declare function validateWocChainInfo(value: unknown, expectedChain: Chain): WocChainInfo;
 export interface WalletToolboxWhatsOnChainConfig extends WhatsOnChainConfig {
     /** Optional request-start gate used by ChainTracks' shared public-rate scheduler. */
     requestGate?: () => Promise<void>;
+    /** Whole-request deadline applied to every explorer call. Defaults to 30 seconds. */
+    requestTimeoutMsecs?: number;
 }
 export declare class WhatsOnChainNoServices extends SdkWhatsOnChain {
     private readonly requestGate?;

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

@@ -1 +1 @@
-{"version":3,"file":"WhatsOnChain.d.ts","sourceRoot":"","sources":["../../../../src/services/providers/WhatsOnChain.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"WhatsOnChain.d.ts","sourceRoot":"","sources":["../../../../src/services/providers/WhatsOnChain.ts"],"names":[],"mappings":"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"}