@bsv/wallet-toolbox-client 1.7.15 → 1.7.17

package/out/src/services/chaintracker/chaintracks/Ingest/BulkIngestorCDNBabbage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BulkIngestorCDNBabbage.d.ts","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/Ingest/BulkIngestorCDNBabbage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAE3E,qBAAa,sBAAuB,SAAQ,eAAe;IACzD;;;;;OAKG;IACH,MAAM,CAAC,mCAAmC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,GAAG,sBAAsB;CAM7G"}

package/out/src/services/chaintracker/chaintracks/Ingest/BulkIngestorCDNBabbage.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BulkIngestorCDNBabbage = void 0;
+const BulkIngestorCDN_1 = require("./BulkIngestorCDN");
+class BulkIngestorCDNBabbage extends BulkIngestorCDN_1.BulkIngestorCDN {
+    /**
+     *
+     * @param chain
+     * @param rootFolder defaults to './data/bulk_cdn_babbage_headers/'
+     * @returns
+     */
+    static createBulkIngestorCDNBabbageOptions(chain, fetch) {
+        const options = {
+            ...BulkIngestorCDN_1.BulkIngestorCDN.createBulkIngestorCDNOptions(chain, 'https://cdn.projectbabbage.com/blockheaders/', fetch)
+        };
+        return options;
+    }
+}
+exports.BulkIngestorCDNBabbage = BulkIngestorCDNBabbage;
+//# sourceMappingURL=BulkIngestorCDNBabbage.js.map

package/out/src/services/chaintracker/chaintracks/Ingest/BulkIngestorCDNBabbage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BulkIngestorCDNBabbage.js","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/Ingest/BulkIngestorCDNBabbage.ts"],"names":[],"mappings":";;;AAEA,uDAA2E;AAE3E,MAAa,sBAAuB,SAAQ,iCAAe;IACzD;;;;;OAKG;IACH,MAAM,CAAC,mCAAmC,CAAC,KAAY,EAAE,KAA0B;QACjF,MAAM,OAAO,GAA2B;YACtC,GAAG,iCAAe,CAAC,4BAA4B,CAAC,KAAK,EAAE,8CAA8C,EAAE,KAAK,CAAC;SAC9G,CAAA;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;CACF;AAbD,wDAaC"}

package/out/src/services/chaintracker/chaintracks/Ingest/BulkIngestorWhatsOnChainCdn.d.ts

@@ -0,0 +1,62 @@
+import { Chain } from '../../../../sdk';
+import { BlockHeader } from '../Api/BlockHeaderApi';
+import { BulkIngestorBaseOptions } from '../Api/BulkIngestorApi';
+import { ChaintracksFetchApi } from '../Api/ChaintracksFetchApi';
+import { BulkIngestorBase } from './BulkIngestorBase';
+import { HeightRange, HeightRanges } from '../util/HeightRange';
+import { StopListenerToken } from './WhatsOnChainIngestorWs';
+import { WhatsOnChainServices, WhatsOnChainServicesOptions } from './WhatsOnChainServices';
+export interface BulkIngestorWhatsOnChainOptions extends BulkIngestorBaseOptions, WhatsOnChainServicesOptions {
+    /**
+     * Maximum msces of "normal" pause with no new data arriving.
+     */
+    idleWait: number | undefined;
+    /**
+     * Which chain is being tracked: main, test, or stn.
+     */
+    chain: Chain;
+    /**
+     * WhatsOnChain.com API Key
+     * https://docs.taal.com/introduction/get-an-api-key
+     * If unknown or empty, maximum request rate is limited.
+     * https://developers.whatsonchain.com/#rate-limits
+     */
+    apiKey?: string;
+    /**
+     * Request timeout for GETs to https://api.whatsonchain.com/v1/bsv
+     */
+    timeout: number;
+    /**
+     * User-Agent header value for requests to https://api.whatsonchain.com/v1/bsv
+     */
+    userAgent: string;
+    /**
+     * Enable WhatsOnChain client cache option.
+     */
+    enableCache: boolean;
+    /**
+     * How long chainInfo is considered still valid before updating (msecs).
+     */
+    chainInfoMsecs: number;
+    /**
+     *
+     */
+    fetch?: ChaintracksFetchApi;
+}
+export declare class BulkIngestorWhatsOnChainCdn extends BulkIngestorBase {
+    /**
+     *
+     * @param chain
+     * @param localCachePath defaults to './data/ingest_whatsonchain_headers'
+     * @returns
+     */
+    static createBulkIngestorWhatsOnChainOptions(chain: Chain): BulkIngestorWhatsOnChainOptions;
+    fetch: ChaintracksFetchApi;
+    idleWait: number;
+    woc: WhatsOnChainServices;
+    stopOldListenersToken: StopListenerToken;
+    constructor(options: BulkIngestorWhatsOnChainOptions);
+    getPresentHeight(): Promise<number | undefined>;
+    fetchHeaders(before: HeightRanges, fetchRange: HeightRange, bulkRange: HeightRange, priorLiveHeaders: BlockHeader[]): Promise<BlockHeader[]>;
+}
+//# sourceMappingURL=BulkIngestorWhatsOnChainCdn.d.ts.map

package/out/src/services/chaintracker/chaintracks/Ingest/BulkIngestorWhatsOnChainCdn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BulkIngestorWhatsOnChainCdn.d.ts","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/Ingest/BulkIngestorWhatsOnChainCdn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAGrD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAA;AAE1F,MAAM,WAAW,+BAAgC,SAAQ,uBAAuB,EAAE,2BAA2B;IAC3G;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B;;OAEG;IACH,KAAK,EAAE,KAAK,CAAA;IACZ;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAA;IACpB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAA;CAC5B;AAED,qBAAa,2BAA4B,SAAQ,gBAAgB;IAC/D;;;;;OAKG;IACH,MAAM,CAAC,qCAAqC,CAAC,KAAK,EAAE,KAAK,GAAG,+BAA+B;IAS3F,KAAK,EAAE,mBAAmB,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,oBAAoB,CAAA;IACzB,qBAAqB,EAAE,iBAAiB,CAAsB;gBAElD,OAAO,EAAE,+BAA+B;IAOrC,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAMxD,YAAY,CAChB,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,WAAW,EACvB,SAAS,EAAE,WAAW,EACtB,gBAAgB,EAAE,WAAW,EAAE,GAC9B,OAAO,CAAC,WAAW,EAAE,CAAC;CAwB1B"}

package/out/src/services/chaintracker/chaintracks/Ingest/BulkIngestorWhatsOnChainCdn.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BulkIngestorWhatsOnChainCdn = void 0;
+const BulkIngestorBase_1 = require("./BulkIngestorBase");
+const blockHeaderUtilities_1 = require("../util/blockHeaderUtilities");
+const ChaintracksFetch_1 = require("../util/ChaintracksFetch");
+const WhatsOnChainServices_1 = require("./WhatsOnChainServices");
+class BulkIngestorWhatsOnChainCdn extends BulkIngestorBase_1.BulkIngestorBase {
+    /**
+     *
+     * @param chain
+     * @param localCachePath defaults to './data/ingest_whatsonchain_headers'
+     * @returns
+     */
+    static createBulkIngestorWhatsOnChainOptions(chain) {
+        const options = {
+            ...WhatsOnChainServices_1.WhatsOnChainServices.createWhatsOnChainServicesOptions(chain),
+            ...BulkIngestorBase_1.BulkIngestorBase.createBulkIngestorBaseOptions(chain),
+            idleWait: 5000
+        };
+        return options;
+    }
+    constructor(options) {
+        super(options);
+        this.stopOldListenersToken = { stop: undefined };
+        this.idleWait = options.idleWait || 5000;
+        this.woc = new WhatsOnChainServices_1.WhatsOnChainServices(options);
+        this.fetch = options.fetch || new ChaintracksFetch_1.ChaintracksFetch();
+    }
+    async getPresentHeight() {
+        const presentHeight = await this.woc.getChainTipHeight();
+        this.log(`presentHeight=${presentHeight}`);
+        return presentHeight;
+    }
+    async fetchHeaders(before, fetchRange, bulkRange, priorLiveHeaders) {
+        const oldHeaders = [];
+        try {
+            const ranges = await this.woc.getHeaderByteFileLinks(fetchRange, this.fetch);
+            const headers = [];
+            for (const range of ranges) {
+                for (let height = range.range.minHeight; height <= range.range.maxHeight; height++) {
+                    if (fetchRange.contains(height)) {
+                        if (!range.data)
+                            range.data = await this.fetch.download(this.fetch.pathJoin(range.sourceUrl, range.fileName));
+                        const h = (0, blockHeaderUtilities_1.deserializeBlockHeader)(range.data, (height - range.range.minHeight) * 80, height);
+                        oldHeaders.push(h);
+                    }
+                }
+            }
+        }
+        catch (e) {
+            this.log(`Errors during WhatsOnChain ingestion:\n${e}`);
+        }
+        const liveHeaders = await this.storage().addBulkHeaders(oldHeaders, bulkRange, priorLiveHeaders);
+        return liveHeaders;
+    }
+}
+exports.BulkIngestorWhatsOnChainCdn = BulkIngestorWhatsOnChainCdn;
+//# sourceMappingURL=BulkIngestorWhatsOnChainCdn.js.map

package/out/src/services/chaintracker/chaintracks/Ingest/BulkIngestorWhatsOnChainCdn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BulkIngestorWhatsOnChainCdn.js","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/Ingest/BulkIngestorWhatsOnChainCdn.ts"],"names":[],"mappings":";;;AAIA,yDAAqD;AACrD,uEAAqE;AACrE,+DAA2D;AAG3D,iEAA0F;AAwC1F,MAAa,2BAA4B,SAAQ,mCAAgB;IAC/D;;;;;OAKG;IACH,MAAM,CAAC,qCAAqC,CAAC,KAAY;QACvD,MAAM,OAAO,GAAoC;YAC/C,GAAG,2CAAoB,CAAC,iCAAiC,CAAC,KAAK,CAAC;YAChE,GAAG,mCAAgB,CAAC,6BAA6B,CAAC,KAAK,CAAC;YACxD,QAAQ,EAAE,IAAI;SACf,CAAA;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAOD,YAAY,OAAwC;QAClD,KAAK,CAAC,OAAO,CAAC,CAAA;QAHhB,0BAAqB,GAAsB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;QAI5D,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAA;QACxC,IAAI,CAAC,GAAG,GAAG,IAAI,2CAAoB,CAAC,OAAO,CAAC,CAAA;QAC5C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,mCAAgB,EAAE,CAAA;IACtD,CAAC;IAEQ,KAAK,CAAC,gBAAgB;QAC7B,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAA;QACxD,IAAI,CAAC,GAAG,CAAC,iBAAiB,aAAa,EAAE,CAAC,CAAA;QAC1C,OAAO,aAAa,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,MAAoB,EACpB,UAAuB,EACvB,SAAsB,EACtB,gBAA+B;QAE/B,MAAM,UAAU,GAAkB,EAAE,CAAA;QAEpC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;YAC5E,MAAM,OAAO,GAAkB,EAAE,CAAA;YACjC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,KAAK,IAAI,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;oBACnF,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;wBAChC,IAAI,CAAC,KAAK,CAAC,IAAI;4BACb,KAAK,CAAC,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;wBAC9F,MAAM,CAAC,GAAG,IAAA,6CAAsB,EAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAA;wBAC3F,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;oBACpB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,GAAG,CAAC,0CAA0C,CAAC,EAAE,CAAC,CAAA;QACzD,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAA;QAEhG,OAAO,WAAW,CAAA;IACpB,CAAC;CACF;AA/DD,kEA+DC"}

package/out/src/services/chaintracker/chaintracks/Ingest/LiveIngestorBase.d.ts

@@ -0,0 +1,62 @@
+import { Chain } from '../../../../sdk/types';
+import { LiveIngestorApi } from '../Api/LiveIngestorApi';
+import { ChaintracksStorageApi } from '../Api/ChaintracksStorageApi';
+import { BlockHeader } from '../Api/BlockHeaderApi';
+export interface LiveIngestorBaseOptions {
+    /**
+     * The target chain: "main" or "test"
+     */
+    chain: Chain;
+}
+/**
+ *
+ */
+export declare abstract class LiveIngestorBase implements LiveIngestorApi {
+    static createLiveIngestorBaseOptions(chain: Chain): LiveIngestorBaseOptions;
+    chain: Chain;
+    log: (...args: any[]) => void;
+    constructor(options: LiveIngestorBaseOptions);
+    /**
+     * Release resources.
+     * Override if required.
+     */
+    shutdown(): Promise<void>;
+    private storageEngine?;
+    /**
+     * Allocate resources.
+     * @param storage coordinating storage engine.
+     */
+    setStorage(storage: ChaintracksStorageApi, log: (...args: any[]) => void): Promise<void>;
+    /**
+     *
+     * @returns coordinating storage engine.
+     */
+    storage(): ChaintracksStorageApi;
+    /**
+     * Called to retrieve a missing block header,
+     * when the previousHash of a new header is unknown.
+     *
+     * @param hash block hash of missing header
+     */
+    abstract getHeaderByHash(hash: string): Promise<BlockHeader | undefined>;
+    /**
+     * Begin retrieving new block headers.
+     *
+     * New headers are pushed onto the liveHeaders array.
+     *
+     * Continue waiting for new headers.
+     *
+     * Return only when either `stopListening` or `shutdown` are called.
+     *
+     * Be prepared to resume listening after `stopListening` but not
+     * after `shutdown`.
+     *
+     * @param liveHeaders
+     */
+    abstract startListening(liveHeaders: BlockHeader[]): Promise<void>;
+    /**
+     * Causes `startListening` to stop listening for new block headers and return.
+     */
+    abstract stopListening(): void;
+}
+//# sourceMappingURL=LiveIngestorBase.d.ts.map

package/out/src/services/chaintracker/chaintracks/Ingest/LiveIngestorBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveIngestorBase.d.ts","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/Ingest/LiveIngestorBase.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,KAAK,EAAE,KAAK,CAAA;CACb;AAED;;GAEG;AACH,8BAAsB,gBAAiB,YAAW,eAAe;IAC/D,MAAM,CAAC,6BAA6B,CAAC,KAAK,EAAE,KAAK;IAOjD,KAAK,EAAE,KAAK,CAAA;IACZ,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAW;gBAE5B,OAAO,EAAE,uBAAuB;IAI5C;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B,OAAO,CAAC,aAAa,CAAC,CAAuB;IAE7C;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9F;;;OAGG;IACH,OAAO,IAAI,qBAAqB;IAKhC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAExE;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAElE;;OAEG;IACH,QAAQ,CAAC,aAAa,IAAI,IAAI;CAC/B"}

package/out/src/services/chaintracker/chaintracks/Ingest/LiveIngestorBase.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiveIngestorBase = void 0;
+/**
+ *
+ */
+class LiveIngestorBase {
+    static createLiveIngestorBaseOptions(chain) {
+        const options = {
+            chain
+        };
+        return options;
+    }
+    constructor(options) {
+        this.log = () => { };
+        this.chain = options.chain;
+    }
+    /**
+     * Release resources.
+     * Override if required.
+     */
+    async shutdown() { }
+    /**
+     * Allocate resources.
+     * @param storage coordinating storage engine.
+     */
+    async setStorage(storage, log) {
+        this.storageEngine = storage;
+        this.log = log;
+    }
+    /**
+     *
+     * @returns coordinating storage engine.
+     */
+    storage() {
+        if (!this.storageEngine)
+            throw new Error('storageEngine must be set.');
+        return this.storageEngine;
+    }
+}
+exports.LiveIngestorBase = LiveIngestorBase;
+//# sourceMappingURL=LiveIngestorBase.js.map

package/out/src/services/chaintracker/chaintracks/Ingest/LiveIngestorBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveIngestorBase.js","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/Ingest/LiveIngestorBase.ts"],"names":[],"mappings":";;;AAaA;;GAEG;AACH,MAAsB,gBAAgB;IACpC,MAAM,CAAC,6BAA6B,CAAC,KAAY;QAC/C,MAAM,OAAO,GAA4B;YACvC,KAAK;SACN,CAAA;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAKD,YAAY,OAAgC;QAF5C,QAAG,GAA6B,GAAG,EAAE,GAAE,CAAC,CAAA;QAGtC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;IAC5B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,KAAmB,CAAC;IAIlC;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,OAA8B,EAAE,GAA6B;QAC5E,IAAI,CAAC,aAAa,GAAG,OAAO,CAAA;QAC5B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;IAChB,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;QACtE,OAAO,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;CA8BF;AArED,4CAqEC"}

package/out/src/services/chaintracker/chaintracks/Ingest/LiveIngestorWhatsOnChainPoll.d.ts

@@ -0,0 +1,51 @@
+import { BlockHeader, Chain } from '../../../../sdk';
+import { LiveIngestorBase, LiveIngestorBaseOptions } from './LiveIngestorBase';
+import { WhatsOnChainServices, WhatsOnChainServicesOptions } from './WhatsOnChainServices';
+export interface LiveIngestorWhatsOnChainOptions extends LiveIngestorBaseOptions, WhatsOnChainServicesOptions {
+    /**
+     * Maximum msces of "normal" time with no ping received from connected WoC service.
+     */
+    idleWait: number | undefined;
+    /**
+     * Which chain is being tracked: main, test, or stn.
+     */
+    chain: Chain;
+    /**
+     * WhatsOnChain.com API Key
+     * https://docs.taal.com/introduction/get-an-api-key
+     * If unknown or empty, maximum request rate is limited.
+     * https://developers.whatsonchain.com/#rate-limits
+     */
+    apiKey?: string;
+    /**
+     * Request timeout for GETs to https://api.whatsonchain.com/v1/bsv
+     */
+    timeout: number;
+    /**
+     * User-Agent header value for requests to https://api.whatsonchain.com/v1/bsv
+     */
+    userAgent: string;
+    /**
+     * Enable WhatsOnChain client cache option.
+     */
+    enableCache: boolean;
+    /**
+     * How long chainInfo is considered still valid before updating (msecs).
+     */
+    chainInfoMsecs: number;
+}
+/**
+ * Reports new headers by polling periodically.
+ */
+export declare class LiveIngestorWhatsOnChainPoll extends LiveIngestorBase {
+    static createLiveIngestorWhatsOnChainOptions(chain: Chain): LiveIngestorWhatsOnChainOptions;
+    idleWait: number;
+    woc: WhatsOnChainServices;
+    done: boolean;
+    constructor(options: LiveIngestorWhatsOnChainOptions);
+    getHeaderByHash(hash: string): Promise<BlockHeader | undefined>;
+    startListening(liveHeaders: BlockHeader[]): Promise<void>;
+    stopListening(): void;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=LiveIngestorWhatsOnChainPoll.d.ts.map

package/out/src/services/chaintracker/chaintracks/Ingest/LiveIngestorWhatsOnChainPoll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveIngestorWhatsOnChainPoll.d.ts","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/Ingest/LiveIngestorWhatsOnChainPoll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAEpD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAC9E,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAG5B,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,+BAAgC,SAAQ,uBAAuB,EAAE,2BAA2B;IAC3G;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B;;OAEG;IACH,KAAK,EAAE,KAAK,CAAA;IACZ;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAA;IACpB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,gBAAgB;IAChE,MAAM,CAAC,qCAAqC,CAAC,KAAK,EAAE,KAAK,GAAG,+BAA+B;IAS3F,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,oBAAoB,CAAA;IACzB,IAAI,EAAE,OAAO,CAAQ;gBAET,OAAO,EAAE,+BAA+B;IAM9C,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAK/D,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB/D,aAAa,IAAI,IAAI;IAIN,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGzC"}

package/out/src/services/chaintracker/chaintracks/Ingest/LiveIngestorWhatsOnChainPoll.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiveIngestorWhatsOnChainPoll = void 0;
+const utilityHelpers_1 = require("../../../../utility/utilityHelpers");
+const LiveIngestorBase_1 = require("./LiveIngestorBase");
+const WhatsOnChainServices_1 = require("./WhatsOnChainServices");
+/**
+ * Reports new headers by polling periodically.
+ */
+class LiveIngestorWhatsOnChainPoll extends LiveIngestorBase_1.LiveIngestorBase {
+    static createLiveIngestorWhatsOnChainOptions(chain) {
+        const options = {
+            ...WhatsOnChainServices_1.WhatsOnChainServices.createWhatsOnChainServicesOptions(chain),
+            ...LiveIngestorBase_1.LiveIngestorBase.createLiveIngestorBaseOptions(chain),
+            idleWait: 100000
+        };
+        return options;
+    }
+    constructor(options) {
+        super(options);
+        this.done = false;
+        this.idleWait = options.idleWait || 100000;
+        this.woc = new WhatsOnChainServices_1.WhatsOnChainServices(options);
+    }
+    async getHeaderByHash(hash) {
+        const header = await this.woc.getHeaderByHash(hash);
+        return header;
+    }
+    async startListening(liveHeaders) {
+        this.done = false;
+        let lastHeaders = [];
+        for (; !this.done;) {
+            const headers = await this.woc.getHeaders();
+            const newHeaders = headers.filter(h => !lastHeaders.some(lh => lh.hash === h.hash));
+            for (const h of newHeaders) {
+                const bh = (0, WhatsOnChainServices_1.wocGetHeadersHeaderToBlockHeader)(h);
+                liveHeaders.unshift(bh);
+            }
+            lastHeaders = headers;
+            for (let sec = 0; sec < 60 && !this.done; sec++) {
+                // Only wait a second at a time so we notice `done` sooner...
+                await (0, utilityHelpers_1.wait)(1000);
+            }
+        }
+        this.log(`LiveIngestorWhatsOnChainPoll stopped`);
+    }
+    stopListening() {
+        this.done = true;
+    }
+    async shutdown() {
+        this.stopListening();
+    }
+}
+exports.LiveIngestorWhatsOnChainPoll = LiveIngestorWhatsOnChainPoll;
+//# sourceMappingURL=LiveIngestorWhatsOnChainPoll.js.map

package/out/src/services/chaintracker/chaintracks/Ingest/LiveIngestorWhatsOnChainPoll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveIngestorWhatsOnChainPoll.js","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/Ingest/LiveIngestorWhatsOnChainPoll.ts"],"names":[],"mappings":";;;AACA,uEAAyD;AACzD,yDAA8E;AAC9E,iEAK+B;AAoC/B;;GAEG;AACH,MAAa,4BAA6B,SAAQ,mCAAgB;IAChE,MAAM,CAAC,qCAAqC,CAAC,KAAY;QACvD,MAAM,OAAO,GAAoC;YAC/C,GAAG,2CAAoB,CAAC,iCAAiC,CAAC,KAAK,CAAC;YAChE,GAAG,mCAAgB,CAAC,6BAA6B,CAAC,KAAK,CAAC;YACxD,QAAQ,EAAE,MAAM;SACjB,CAAA;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAMD,YAAY,OAAwC;QAClD,KAAK,CAAC,OAAO,CAAC,CAAA;QAHhB,SAAI,GAAY,KAAK,CAAA;QAInB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAA;QAC1C,IAAI,CAAC,GAAG,GAAG,IAAI,2CAAoB,CAAC,OAAO,CAAC,CAAA;IAC9C,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QACnD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,WAA0B;QAC7C,IAAI,CAAC,IAAI,GAAG,KAAK,CAAA;QACjB,IAAI,WAAW,GAA0B,EAAE,CAAA;QAE3C,OAAO,CAAC,IAAI,CAAC,IAAI,GAAI,CAAC;YACpB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAA;YAE3C,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;YAEnF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;gBAC3B,MAAM,EAAE,GAAG,IAAA,uDAAgC,EAAC,CAAC,CAAC,CAAA;gBAC9C,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;YACzB,CAAC;YAED,WAAW,GAAG,OAAO,CAAA;YAErB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;gBAChD,6DAA6D;gBAC7D,MAAM,IAAA,qBAAI,EAAC,IAAI,CAAC,CAAA;YAClB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAA;IAClD,CAAC;IAED,aAAa;QACX,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEQ,KAAK,CAAC,QAAQ;QACrB,IAAI,CAAC,aAAa,EAAE,CAAA;IACtB,CAAC;CACF;AAxDD,oEAwDC"}

package/out/src/services/chaintracker/chaintracks/Ingest/WhatsOnChainIngestorWs.d.ts

@@ -0,0 +1,171 @@
+import { Chain } from '../../../../sdk/types';
+import { BlockHeader } from '../../../../sdk/WalletServices.interfaces';
+export type StopListenerToken = {
+    stop: (() => void) | undefined;
+};
+/**
+ * High speed WebSocket based based old block header listener
+ * @param fromHeight
+ * @param enqueue returns headers received from WebSocket service
+ * @param error notifies of abnormal events, return false to close websocket, true to ignore the error.
+ * @param stop an object with a stop property which gets set to a method to stop listener
+ * @param chain 'test' | 'main'
+ * @param idleWait how many milliseconds to timeout between completion checks.
+ * @returns true on normal completion, false if should restart if no error received.
+ */
+export declare function WocHeadersBulkListener(fromHeight: number, toHeight: number, enqueue: (header: BlockHeader) => void, error: (code: number, message: string) => boolean, stop: StopListenerToken, chain: Chain, logger?: (...args: any[]) => void, idleWait?: number): Promise<boolean>;
+/** v2
+{
+  "message": {
+    "data": {
+      "version": 872415232,
+      "previousblockhash": "00000000000000000ea1f9ba0817a0f922ee227be306fd9097a4e76caf5ff411",
+      "merkleroot": "dcd7efb3c39e8e2d597e4757b9a49c98f52f77a6df39d1d5936ac3abb2559944",
+      "time": 1750182239,
+      "bits": 403926191,
+      "nonce": 1043732575,
+      "hash": "0000000000000000032d09ca772ca5b3bc5b90a79a5bbcc4a05c99fb6d3b23d8",
+      "height": 901658
+    }
+  }
+}
+ */
+export declare function WocHeadersBulkListener_test(): Promise<void>;
+/**
+ * High speed WebSocket based based new block header listener
+ * @param enqueue returns headers received from WebSocket service
+ * @param error notifies of abnormal events, return false to close websocket, true to ignore the error.
+ * @param stop an object with a stop property which gets set to a method to stop listener
+ * @param chain 'test' | 'main'
+ * @param idleWait without any input, after this many milliseconds, assume dead service and exit.
+ * @returns true only if exit caused by `stop`
+ */
+export declare function WocHeadersLiveListener(enqueue: (header: BlockHeader) => void, error: (code: number, message: string) => boolean, stop: StopListenerToken, chain: Chain, logger: (...args: any[]) => void, idleWait?: number): Promise<boolean>;
+export declare function WocHeadersLiveListener_test(): Promise<void>;
+/**
+ * v1 json data format:
+ *
+{
+  "hash": "0000000000000000010cb155a44577ff3541940ec4355c026dc2706fb7e261d6",
+  "confirmations": 4,
+  "size": 1229956,
+  "height": 676421,
+  "version": 541065216,
+  "versionHex": "20400000",
+  "merkleroot": "e2f64e87c0362314b65dc28b4367c41d904c22b891b652951779336ef735386b",
+  "txcount": 654,
+  "time": 1614534798,
+  "mediantime": 1614527058,
+  "nonce": 610133701,
+  "bits": "180d359d",
+  "difficulty": 83235621087.7299,
+  "chainwork": "00000000000000000000000000000000000000000127d3854a414d8ec8f53190",
+  "previousblockhash": "00000000000000000428ca33597675bd85f5a2ef464ba25e4db7b4a74d898d33",
+  "nextblockhash": "00000000000000000cb40c1d850dece5cd3747e08a1e4066ef887251388c4ae6",
+  "coinbaseTx": {
+    "hex": "01000000010000000000000000000000000000000000000000000000000000000000000000ffffffff410345520a2f7461616c2e636f6d2f506c656173652070617920302e3520736174732f627974652c20696e666f407461616c2e636f6d6eead6b0ad91f2ce86be0400ffffffff0176674325000000001976a9148e9170be3f733a9773c907517fb9b786f1c884c688ac00000000",
+    "txid": "13686a10870d23b4c94642bf0b78d6630e2640fc0de83bc30af835d96bb17482",
+    "hash": "13686a10870d23b4c94642bf0b78d6630e2640fc0de83bc30af835d96bb17482",
+    "size": 150,
+    "version": 1,
+    "locktime": 0,
+    "vin": [
+      {
+        "coinbase": "0345520a2f7461616c2e636f6d2f506c656173652070617920302e3520736174732f627974652c20696e666f407461616c2e636f6d6eead6b0ad91f2ce86be0400",
+        "sequence": 4294967295
+      }
+    ],
+    "vout": [
+      {
+        "value": 6.2517439,
+        "n": 0,
+        "scriptPubKey": {
+          "asm": "OP_DUP OP_HASH160 8e9170be3f733a9773c907517fb9b786f1c884c6 OP_EQUALVERIFY OP_CHECKSIG",
+          "hex": "76a9148e9170be3f733a9773c907517fb9b786f1c884c688ac",
+          "reqSigs": 1,
+          "type": "pubkeyhash",
+          "addresses": [
+            "1DzqBck9oyCBzxJbbje2s15deZis6BeATi"
+          ],
+          "isTruncated": false
+        }
+      }
+    ],
+    "blockhash": "0000000000000000010cb155a44577ff3541940ec4355c026dc2706fb7e261d6",
+    "confirmations": 4,
+    "time": 1614534798,
+    "blocktime": 1614534798
+  }
+}
+ */
+/**
+ * v2 json data format:
+{
+  "channel": "woc:blockHeader",
+  "pub": {
+    "data": {
+
+      "hash": "000000000000000007405fd882e9d4bf3d7b2388010081fe443ee1e323d8a668",
+      "confirmations": 1,
+      "size": 368170789,
+      "height": 892466,
+      "version": 939524096,
+      "versionHex": "38000000",
+      "merkleroot": "b0ac43a40a42775d8f533a8eda00bed3257e12a5fca3c8cade47188e6b7aa382",
+      "txcount": 9230,
+      "time": 1744648860,
+      "mediantime": 1744645401,
+      "nonce": 2893086732,
+      "bits": "181246e3",
+      "difficulty": 60157618395.71893,
+      "chainwork": "00000000000000000000000000000000000000000164d487adbc2b84d47d2831",
+      "previousblockhash": "0000000000000000090fa4de4c971b0b3609acc1061b2020d22dc8d8bf72746a",
+      "nextblockhash": "",
+      "coinbaseTx": {
+        "hex": "...",
+        "txid": "1932aa0229b6b44be4b749b9e7279c02136374e2e77b4e890db761f8e74d2111",
+        "hash": "1932aa0229b6b44be4b749b9e7279c02136374e2e77b4e890db761f8e74d2111",
+        "size": 111,
+        "version": 1,
+        "locktime": 0,
+        "vin": [
+          {
+            "n": 0,
+            "coinbase": "03329e0d2f7461616c2e636f6d2fb9df41e723a18d95e09d0200",
+            "sequence": 4294967295
+          }
+        ],
+        "vout": [
+          {
+            "value": 3.13276008,
+            "n": 0,
+            "scriptPubKey": {
+              "asm": "OP_DUP OP_HASH160 522cf9e7626d9bd8729e5a1398ece40dad1b6a2f OP_EQUALVERIFY OP_CHECKSIG",
+              "hex": "...",
+              "reqSigs": 1,
+              "type": "pubkeyhash",
+              "addresses": [
+                "18VWHjMt4ixHddPPbs6righWTs3Sg2QNcn"
+              ],
+              "isTruncated": false
+            },
+            "scripthash": "1981f116576960fab6ac9a71ba3c12e4f98c2d9b34532bdb40f2e8cc03337fa2"
+          }
+        ],
+        "blockhash": "000000000000000007405fd882e9d4bf3d7b2388010081fe443ee1e323d8a668",
+        "confirmations": 1,
+        "time": 1744648860,
+        "blocktime": 1744648860,
+
+        // New properties in v2
+        "blockheight": 892466,
+        "vincount": 1,
+        "voutcount": 1,
+        "voutvalue": 3.13276008
+      },
+      "totalFees": 0.007760080000000169
+    }
+  }
+}
+ */
+//# sourceMappingURL=WhatsOnChainIngestorWs.d.ts.map

package/out/src/services/chaintracker/chaintracks/Ingest/WhatsOnChainIngestorWs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WhatsOnChainIngestorWs.d.ts","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/Ingest/WhatsOnChainIngestorWs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAA;AAEvE,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;CAAE,CAAA;AASlE;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,EACtC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,EACjD,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,KAAK,EACZ,MAAM,GAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAe,EAC3C,QAAQ,SAAO,GACd,OAAO,CAAC,OAAO,CAAC,CA6JlB;AAWD;;;;;;;;;;;;;;;GAeG;AAEH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAmCjE;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,EACtC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,EACjD,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAChC,QAAQ,SAAS,GAChB,OAAO,CAAC,OAAO,CAAC,CAyIlB;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CA0BjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG"}