@bsv/wallet-toolbox-mobile 1.5.21 → 1.6.2

package/out/src/services/chaintracker/chaintracks/Api/ChaintracksStorageApi.d.ts

@@ -0,0 +1,317 @@
+import { HeightRange } from '../util/HeightRange';
+import { BlockHeader, LiveBlockHeader } from './BlockHeaderApi';
+import { Chain } from '../../../../sdk/types';
+import { BulkHeaderFileInfo } from '../util/BulkHeaderFile';
+import { BulkFileDataManager } from '../util/BulkFileDataManager';
+export interface ChaintracksStorageBaseOptions {
+    /**
+     * Which chain is being tracked: main, test, or stn.
+     */
+    chain: Chain;
+    /**
+     * How much of recent history is required to be kept in "live" block header storage.
+     *
+     * Headers with height less than active chain tip height minus `liveHeightThreshold`
+     * are not required to be kept in "live" storage and may be migrated to "bulk" storage.
+     *
+     * As no forks, orphans, or reorgs can affect "bulk" block header storage, an
+     * aggressively high number is recommended: At least an order of magnitude more than
+     * the deepest actual reorg you can imagine.
+     */
+    liveHeightThreshold: number;
+    /**
+     * How much of recent history must be processed with full validation and reorg support.
+     *
+     * Must be less than or equal to `liveHeightThreshold`.
+     *
+     * Headers with height older than active chain tip height minus `reorgHeightThreshold`
+     * may use batch processing when ingesting headers.
+     */
+    reorgHeightThreshold: number;
+    /**
+     * How many excess "live" headers to accumulate before migrating them as a chunk to the
+     * bulk header storage.
+     */
+    bulkMigrationChunkSize: number;
+    /**
+     * Maximum number of headers per call to batchInsert
+     */
+    batchInsertLimit: number;
+    /**
+     * Controls in memory caching and retrieval of missing bulk header data.
+     */
+    bulkFileDataManager: BulkFileDataManager | undefined;
+}
+export interface ChaintracksStorageQueryApi {
+    /**
+     * Returns the active chain tip header
+     * Throws an error if there is no tip.
+     */
+    findChainTipHeader(): Promise<LiveBlockHeader>;
+    /**
+     * Returns the block hash of the active chain tip.
+     */
+    findChainTipHash(): Promise<string>;
+    /**
+     * Returns the active chain tip header or undefined if there is no tip.
+     */
+    findChainTipHeaderOrUndefined(): Promise<LiveBlockHeader | undefined>;
+    /**
+     * Returns the chainWork value of the active chain tip
+     */
+    findChainTipWork(): Promise<string>;
+    /**
+     * Returns block header for a given block height on active chain.
+     * @param hash block hash
+     */
+    findHeaderForHeight(height: number): Promise<LiveBlockHeader | BlockHeader>;
+    /**
+     * Returns block header for a given block height on active chain.
+     * @param hash block hash
+     */
+    findHeaderForHeightOrUndefined(height: number): Promise<LiveBlockHeader | BlockHeader | undefined>;
+    /**
+     * Given two chain tip headers in a chain reorg scenario,
+     * return their common ancestor header.
+     * @param header1 First header in live part of the chain.
+     * @param header2 Second header in live part of the chain.
+     */
+    findCommonAncestor(header1: LiveBlockHeader, header2: LiveBlockHeader): Promise<LiveBlockHeader>;
+    /**
+     * This is an original API. Proposed deprecation in favor of `findCommonAncestor`
+     * Given two headers that are both chain tips in a reorg scenario, returns
+     * the depth of the reorg (the greater of the heights of the two provided
+     * headers, minus the height of their last common ancestor)
+     */
+    findReorgDepth(header1: LiveBlockHeader, header2: LiveBlockHeader): Promise<number>;
+    /**
+     * Returns true if the given merkleRoot is found in a block header on the active chain.
+     * @param merkleRoot of block header
+     */
+    isMerkleRootActive(merkleRoot: string): Promise<boolean>;
+    /**
+     * Adds headers in 80 byte serialized format to a buffer.
+     * Only adds active headers.
+     * Buffer length divided by 80 is the actual number returned.
+     *
+     * This function supports the ChaintracksClientApi
+     *
+     * @param height of first header, must be >= zero.
+     * @param count of headers, maximum
+     */
+    getHeaders(height: number, count: number): Promise<number[]>;
+    /**
+     * Returns block header for a given block height on active chain.
+     * @param hash block hash
+     */
+    findLiveHeaderForHeight(height: number): Promise<LiveBlockHeader | null>;
+    /**
+       * Returns block header for a given headerId.
+       
+       * Only from the "live" portion of the chain.
+       * @param headerId
+       */
+    findLiveHeaderForHeaderId(headerId: number): Promise<LiveBlockHeader>;
+    /**
+     * Returns block header for a given block hash.
+     * Only from the "live" portion of the chain.
+     * Returns null if not found.
+     * @param hash block hash
+     */
+    findLiveHeaderForBlockHash(hash: string): Promise<LiveBlockHeader | null>;
+    /**
+     * Returns block header for a given merkleRoot.
+     * Only from the "live" portion of the chain.
+     * @param merkleRoot
+     */
+    findLiveHeaderForMerkleRoot(merkleRoot: string): Promise<LiveBlockHeader | null>;
+    /**
+     * Returns the height range of both bulk and live storage.
+     * Verifies that the ranges meet these requirements:
+     * - Both may be empty.
+     * - If bulk is empty, live must be empty or start with height zero.
+     * - If bulk is not empty it must start with height zero.
+     * - If bulk is not empty and live is not empty, live must start with the height after bulk.
+     */
+    getAvailableHeightRanges(): Promise<{
+        bulk: HeightRange;
+        live: HeightRange;
+    }>;
+    /**
+     * @returns The current minimum and maximum height active LiveBlockHeaders in the "live" database.
+     */
+    findLiveHeightRange(): Promise<{
+        minHeight: number;
+        maxHeight: number;
+    }>;
+    /**
+     * @returns The maximum headerId value used by existing records or -1 if there are none.
+     */
+    findMaxHeaderId(): Promise<number>;
+    /**
+     * Which chain is being tracked: "main" or "test".
+     */
+    chain: Chain;
+    /**
+     * How much of recent history is required to be kept in "live" block header storage.
+     *
+     * Headers with height older than active chain tip height minus `liveHeightThreshold`
+     * are not required to be kept in "live" storage and may be migrated to "bulk" storage.
+     */
+    liveHeightThreshold: number;
+    /**
+     * How much of recent history must be processed with full validation and reorg support.
+     *
+     * May be less than `liveHeightThreshold`.
+     *
+     * Headers with height older than active chain tip height minus ``
+     * may use batch processing when ingesting headers.
+     */
+    reorgHeightThreshold: number;
+    /**
+     * How many excess "live" headers to accumulate before migrating them as a chunk to the
+     * bulk header storage.
+     */
+    bulkMigrationChunkSize: number;
+    /**
+     * Maximum number of headers per call to batchInsert
+     */
+    batchInsertLimit: number;
+}
+export type InsertHeaderResult = {
+    /**
+     * true only if the new header was inserted
+     */
+    added: boolean;
+    /**
+     * true only if the header was not inserted because a matching hash already exists in the database.
+     */
+    dupe: boolean;
+    /**
+     * true only if the new header became the active chain tip.
+     */
+    isActiveTip: boolean;
+    /**
+     * zero if the insertion of the new header did not cause a reorg.
+     * If isActiveTip is true, and priorTip is not the new headers previous header,
+     * then the minimum height difference from the common active ancestor to this header (new tip) and priorTip.
+     */
+    reorgDepth: number;
+    /**
+     * If `added` is true, this header was the active chain tip before the insert. It may or may not still be the active chain tip after the insert.
+     */
+    priorTip: LiveBlockHeader | undefined;
+    /**
+     * header's previousHash was not found in database
+     */
+    noPrev: boolean;
+    /**
+     * header matching previousHash does not have height - 1
+     */
+    badPrev: boolean;
+    /**
+     * an active ancestor was not found in live storage or prev header.
+     */
+    noActiveAncestor: boolean;
+    /**
+     * a current chain tip was not found in live storage or prev header.
+     */
+    noTip: boolean;
+};
+export interface ChaintracksStorageBulkFileApi {
+    insertBulkFile(file: BulkHeaderFileInfo): Promise<number>;
+    updateBulkFile(fileId: number, file: BulkHeaderFileInfo): Promise<number>;
+    deleteBulkFile(fileId: number): Promise<number>;
+    getBulkFiles(): Promise<BulkHeaderFileInfo[]>;
+    getBulkFileData(fileId: number, offset?: number, length?: number): Promise<Uint8Array | undefined>;
+}
+export interface ChaintracksStorageIngestApi {
+    /**
+     * Attempts to insert a block header into the chain.
+     *
+     * Returns 'added' false and 'dupe' true if header's hash already exists in the live database
+     * Returns 'added' false and 'dupe' false if header's previousHash wasn't found in the live database, or height doesn't increment previous' height.
+     *
+     * Computes the header's chainWork from its bits and the previous header's chainWork.
+     *
+     * Returns 'added' true if the header was added to the live database.
+     * Returns 'isActiveTip' true if header's chainWork is greater than current active chain tip's chainWork.
+     *
+     * If the addition of this header caused a reorg (did not directly extend old active chain tip):
+     * Returns 'reorgDepth' the minimum height difference of the common ancestor to the two chain tips.
+     * Returns 'priorTip' the old active chain tip.
+     * If not a reorg:
+     * Returns 'reorgDepth' of zero.
+     * Returns 'priorTip' the active chain tip before this insert. May be unchanged.
+     *
+     * Implementation must call `pruneLiveBlockHeaders` after adding new header.
+     *
+     * @param header to insert
+     * @param prev if not undefined, the last bulk storage header with total bulk chainWork
+     */
+    insertHeader(header: BlockHeader, prev?: LiveBlockHeader): Promise<InsertHeaderResult>;
+    /**
+     * Must be called after the addition of new LiveBlockHeaders.
+     *
+     * Checks the `StorageEngine` configuration options to see
+     * if BulkStorage is configured and if there is at least one
+     * `bulkMigrationChunkSize` woth of headers in excess of
+     * `liveHeightThreshold` available.
+     *
+     * If yes, then calls `migrateLiveToBulk` one or more times.
+     * @param activeTipHeight height of active tip after adds
+     */
+    pruneLiveBlockHeaders(activeTipHeight: number): Promise<void>;
+    /**
+     * Migrates the oldest `count` LiveBlockHeaders to BulkStorage.
+     * BulkStorage must be configured.
+     * `count` must not exceed `bulkMigrationChunkSize`.
+     * `count` must leave at least `liveHeightThreshold` LiveBlockHeaders.
+     *
+     * @param count
+     *
+     * Steps:
+     * - Copy count oldest active LiveBlockHeaders from live database to buffer.
+     * - Append the buffer of headers to BulkStorage
+     * - Add the buffer's BlockHash, Height pairs to corresponding index table.
+     * - Add the buffer's MerkleRoot, Height pairs to corresponding index table.
+     * - Delete the records from the live database.
+     */
+    migrateLiveToBulk(count: number): Promise<void>;
+    /**
+     * Delete live headers with height less or equal to `maxHeight`
+     * after they have been migrated to bulk storage.
+     *
+     * @param maxHeight delete all records with less or equal `height`
+     */
+    deleteOlderLiveBlockHeaders(maxHeight: number): Promise<number>;
+    /**
+     * Async initialization method.
+     *
+     * May be called prior to other async methods to control when initialization occurs.
+     */
+    makeAvailable(): Promise<void>;
+    /**
+     * Migrate storage schema to latest schema changes.
+     *
+     * Typically invoked automatically by `makeAvailable`.
+     */
+    migrateLatest(): Promise<void>;
+    dropAllData(): Promise<void>;
+    /**
+     * Release all resources. Makes the instance unusable.
+     */
+    destroy(): Promise<void>;
+    /**
+     * @returns min, max height range in live database or empty (0, -1)
+     */
+    getLiveHeightRange(): Promise<HeightRange>;
+}
+export interface ChaintracksStorageApi extends ChaintracksStorageQueryApi, ChaintracksStorageIngestApi {
+    bulkManager: BulkFileDataManager;
+    /**
+     * Close and release all resources.
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=ChaintracksStorageApi.d.ts.map

package/out/src/services/chaintracker/chaintracks/Api/ChaintracksStorageApi.d.ts.map

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

package/out/src/services/chaintracker/chaintracks/Api/ChaintracksStorageApi.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ChaintracksStorageApi.js.map

package/out/src/services/chaintracker/chaintracks/Api/ChaintracksStorageApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChaintracksStorageApi.js","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/Api/ChaintracksStorageApi.ts"],"names":[],"mappings":""}

package/out/src/services/chaintracker/chaintracks/Api/LiveIngestorApi.d.ts

@@ -0,0 +1,19 @@
+import { BlockHeader } from './BlockHeaderApi';
+import { ChaintracksStorageApi } from './ChaintracksStorageApi';
+export interface LiveIngestorApi {
+    /**
+     * Close and release all resources.
+     */
+    shutdown(): Promise<void>;
+    getHeaderByHash(hash: string): Promise<BlockHeader | undefined>;
+    /**
+     * Called before first Synchronize with reference to storage.
+     * Components requiring asynchronous setup can override base class implementation.
+     * @param storage
+     */
+    setStorage(storage: ChaintracksStorageApi): Promise<void>;
+    storage(): ChaintracksStorageApi;
+    startListening(liveHeaders: BlockHeader[]): Promise<void>;
+    stopListening(): void;
+}
+//# sourceMappingURL=LiveIngestorApi.d.ts.map

package/out/src/services/chaintracker/chaintracks/Api/LiveIngestorApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveIngestorApi.d.ts","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/Api/LiveIngestorApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAG/D,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAA;IAE/D;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzD,OAAO,IAAI,qBAAqB,CAAA;IAEhC,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzD,aAAa,IAAI,IAAI,CAAA;CACtB"}

package/out/src/services/chaintracker/chaintracks/Api/LiveIngestorApi.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=LiveIngestorApi.js.map

package/out/src/services/chaintracker/chaintracks/Api/LiveIngestorApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveIngestorApi.js","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/Api/LiveIngestorApi.ts"],"names":[],"mappings":""}

package/out/src/services/chaintracker/chaintracks/Chaintracks.d.ts

@@ -0,0 +1,100 @@
+import { ChaintracksOptions, ChaintracksManagementApi } from './Api/ChaintracksApi';
+import { Chain } from '../../../sdk/types';
+import { ChaintracksInfoApi, HeaderListener, ReorgListener } from './Api/ChaintracksClientApi';
+import { BaseBlockHeader, BlockHeader, LiveBlockHeader } from './Api/BlockHeaderApi';
+import { ChaintracksFsApi } from './Api/ChaintracksFsApi';
+export declare class Chaintracks implements ChaintracksManagementApi {
+    options: ChaintracksOptions;
+    static createOptions(chain: Chain): ChaintracksOptions;
+    log: (...args: any[]) => void;
+    readonly chain: Chain;
+    readonly readonly: boolean;
+    private promises;
+    private callbacks;
+    private storage;
+    private bulkIngestors;
+    private liveIngestors;
+    private baseHeaders;
+    private liveHeaders;
+    private addLiveRecursionLimit;
+    private available;
+    private subscriberCallbacksEnabled;
+    private stopMainThread;
+    private lastPresentHeight;
+    private lastPresentHeightMsecs;
+    private lastPresentHeightMaxAge;
+    private lock;
+    constructor(options: ChaintracksOptions);
+    getChain(): Promise<Chain>;
+    /**
+     * Caches and returns most recently sourced value if less than one minute old.
+     * @returns the current externally available chain height (via bulk ingestors).
+     */
+    getPresentHeight(): Promise<number>;
+    currentHeight(): Promise<number>;
+    subscribeHeaders(listener: HeaderListener): Promise<string>;
+    subscribeReorgs(listener: ReorgListener): Promise<string>;
+    unsubscribe(subscriptionId: string): Promise<boolean>;
+    /**
+     * Queues a potentially new, unknown header for consideration as an addition to the chain.
+     * When the header is considered, if the prior header is unknown, recursive calls to the
+     * bulk ingestors will be attempted to resolve the linkage up to a depth of `addLiveRecursionLimit`.
+     *
+     * Headers are considered in the order they were added.
+     *
+     * @param header
+     */
+    addHeader(header: BaseBlockHeader): Promise<void>;
+    /**
+     * If not already available, takes a writer lock to queue calls until available.
+     * Becoming available starts by initializing ingestors and main thread,
+     * and ends when main thread sets `available`.
+     * Note that the main thread continues running and takes additional write locks
+     * itself when already available.
+     *
+     * @returns when available for client requests
+     */
+    makeAvailable(): Promise<void>;
+    startPromises(): Promise<void>;
+    destroy(): Promise<void>;
+    listening(): Promise<void>;
+    isListening(): Promise<boolean>;
+    isSynchronized(): Promise<boolean>;
+    findHeaderForHeight(height: number): Promise<BlockHeader | undefined>;
+    private findHeaderForHeightNoLock;
+    findHeaderForBlockHash(hash: string): Promise<BlockHeader | undefined>;
+    findHeaderForBlockHashNoLock(hash: string): Promise<BlockHeader | undefined>;
+    isValidRootForHeight(root: string, height: number): Promise<boolean>;
+    getInfo(): Promise<ChaintracksInfoApi>;
+    private getInfoNoLock;
+    getHeaders(height: number, count: number): Promise<string>;
+    findChainTipHeader(): Promise<BlockHeader>;
+    findChainTipHash(): Promise<string>;
+    findLiveHeaderForBlockHash(hash: string): Promise<LiveBlockHeader | undefined>;
+    findChainWorkForBlockHash(hash: string): Promise<string | undefined>;
+    /**
+     * @returns true iff all headers from height zero through current chainTipHeader height can be retreived and form a valid chain.
+     */
+    validate(): Promise<boolean>;
+    exportBulkHeaders(toFolder: string, toFs: ChaintracksFsApi, sourceUrl?: string, toHeadersPerFile?: number, maxHeight?: number): Promise<void>;
+    startListening(): Promise<void>;
+    private syncBulkStorage;
+    private syncBulkStorageNoLock;
+    private getMissingBlockHeader;
+    private invalidInsertHeaderResult;
+    private addLiveHeader;
+    /**
+     * Long running method terminated by setting `stopMainThread` false.
+     *
+     * The promise returned by this method is held in the `promises` array.
+     *
+     * When synchronized (bulk and live storage is valid up to most recent presentHeight),
+     * this method will process headers from `baseHeaders` and `liveHeaders` arrays to extend the chain of headers.
+     *
+     * If a significant gap is detected between bulk+live and presentHeight, `syncBulkStorage` is called to re-establish sync.
+     *
+     * Periodically CDN bulk ingestor is invoked to check if incremental headers can be migrated to CDN backed files.
+     */
+    private mainThreadShiftLiveHeaders;
+}
+//# sourceMappingURL=Chaintracks.d.ts.map

package/out/src/services/chaintracker/chaintracks/Chaintracks.d.ts.map

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