@bopen-io/wallet-toolbox 1.7.18 → 1.7.19

package/out/src/services/chaintracker/chaintracks/util/blockHeaderUtilities.js

@@ -0,0 +1,520 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sha256HashOfBinaryFile = sha256HashOfBinaryFile;
+exports.validateBulkFileData = validateBulkFileData;
+exports.validateBufferOfHeaders = validateBufferOfHeaders;
+exports.validateGenesisHeader = validateGenesisHeader;
+exports.workBNtoBuffer = workBNtoBuffer;
+exports.isMoreWork = isMoreWork;
+exports.addWork = addWork;
+exports.subWork = subWork;
+exports.convertBitsToTarget = convertBitsToTarget;
+exports.convertBitsToWork = convertBitsToWork;
+exports.deserializeBaseBlockHeaders = deserializeBaseBlockHeaders;
+exports.deserializeBlockHeaders = deserializeBlockHeaders;
+exports.validateHeaderFormat = validateHeaderFormat;
+exports.validateHeaderDifficulty = validateHeaderDifficulty;
+exports.blockHash = blockHash;
+exports.serializeBaseBlockHeader = serializeBaseBlockHeader;
+exports.serializeBaseBlockHeaders = serializeBaseBlockHeaders;
+exports.deserializeBaseBlockHeader = deserializeBaseBlockHeader;
+exports.deserializeBlockHeader = deserializeBlockHeader;
+exports.genesisHeader = genesisHeader;
+exports.genesisBuffer = genesisBuffer;
+exports.swapByteOrder = swapByteOrder;
+exports.convertUint32ToBuffer = convertUint32ToBuffer;
+exports.writeUInt32LE = writeUInt32LE;
+exports.writeUInt32BE = writeUInt32BE;
+exports.readUInt32LE = readUInt32LE;
+exports.readUInt32BE = readUInt32BE;
+exports.convertBufferToUint32 = convertBufferToUint32;
+const dirtyHashes_1 = require("./dirtyHashes");
+const sdk_1 = require("@bsv/sdk");
+const utilityHelpers_noBuffer_1 = require("../../../../utility/utilityHelpers.noBuffer");
+const utilityHelpers_1 = require("../../../../utility/utilityHelpers");
+const ReaderUint8Array_1 = require("../../../../utility/ReaderUint8Array");
+const validBulkHeaderFilesByFileHash_1 = require("./validBulkHeaderFilesByFileHash");
+const WERR_errors_1 = require("../../../../sdk/WERR_errors");
+/**
+ * Computes sha256 hash of file contents read as bytes with no encoding.
+ * @param filepath Full filepath to file.
+ * @param bufferSize Optional read buffer size to use. Defaults to 80,000 bytes. Currently ignored.
+ * @returns `{hash, length}` where `hash` is base64 string form of file hash and `length` is file length in bytes.
+ */
+async function sha256HashOfBinaryFile(fs, filepath, bufferSize = 80000) {
+    const sha256 = new sdk_1.Hash.SHA256();
+    const bytes = await fs.readFile(filepath);
+    const length = bytes.length;
+    sha256.update((0, utilityHelpers_noBuffer_1.asArray)(bytes));
+    return { hash: sdk_1.Utils.toBase64(sha256.digest()), length };
+}
+/**
+ * Validates the contents of a bulk header file.
+ * @param bf BulkHeaderFileInfo containing `data` to validate.
+ * @param prevHash Required previous header hash.
+ * @param prevChainWork Required previous chain work.
+ * @param fetch Optional ChaintracksFetchApi instance for fetching data.
+ * @returns Validated BulkHeaderFileInfo with `validated` set to true.
+ */
+async function validateBulkFileData(bf, prevHash, prevChainWork, fetch) {
+    const vbf = { ...bf };
+    if (!vbf.data && vbf.sourceUrl && fetch) {
+        const url = fetch.pathJoin(vbf.sourceUrl, vbf.fileName);
+        vbf.data = await fetch.download(url);
+    }
+    if (!vbf.data)
+        throw new WERR_errors_1.WERR_INVALID_OPERATION(`bulk file ${vbf.fileName} data is unavailable`);
+    if (vbf.count <= 0)
+        throw new WERR_errors_1.WERR_INVALID_PARAMETER('bf.count', `expected count to be greater than 0, but got ${vbf.count}`);
+    if (vbf.data.length !== vbf.count * 80)
+        throw new WERR_errors_1.WERR_INVALID_PARAMETER('bf.data', `bulk file ${vbf.fileName} data length ${vbf.data.length} does not match expected count ${vbf.count}`);
+    vbf.fileHash = (0, utilityHelpers_noBuffer_1.asString)(sdk_1.Hash.sha256((0, utilityHelpers_noBuffer_1.asArray)(vbf.data)), 'base64');
+    if (bf.fileHash && bf.fileHash !== vbf.fileHash)
+        throw new WERR_errors_1.WERR_INVALID_PARAMETER('bf.fileHash', `expected ${bf.fileHash} but got ${vbf.fileHash}`);
+    if (!(0, validBulkHeaderFilesByFileHash_1.isKnownValidBulkHeaderFile)(vbf)) {
+        const { lastHeaderHash, lastChainWork } = validateBufferOfHeaders(vbf.data, prevHash, 0, undefined, prevChainWork);
+        vbf.lastHash = lastHeaderHash;
+        vbf.lastChainWork = lastChainWork;
+        if (vbf.firstHeight === 0) {
+            validateGenesisHeader(vbf.data, vbf.chain);
+        }
+    }
+    vbf.validated = true;
+    return vbf;
+}
+/**
+ * Validate headers contained in an array of bytes. The headers must be consecutive block headers, 80 bytes long,
+ *  where the hash of each header equals the previousHash of the following header.
+ * @param buffer Buffer of headers to be validated.
+ * @param previousHash Expected previousHash of first header.
+ * @param offset Optional starting offset within `buffer`.
+ * @param count Optional number of headers to validate. Validates to end of buffer if missing.
+ * @returns Header hash of last header validated or previousHash if there where none.
+ */
+function validateBufferOfHeaders(buffer, previousHash, offset = 0, count = -1, previousChainWork) {
+    if (count < 0)
+        count = Math.floor((buffer.length - offset) / 80);
+    count = Math.max(0, count);
+    let lastHeaderHash = previousHash;
+    let lastChainWork = previousChainWork;
+    for (let i = 0; i < count; i++) {
+        const headerStart = offset + i * 80;
+        const headerEnd = headerStart + 80;
+        if (headerEnd > buffer.length) {
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('buffer', `multiple of 80 bytes long. header ${i} missing bytes for header at offset ${headerStart} in buffer of length ${buffer.length}`);
+        }
+        const header = buffer.slice(headerStart, headerEnd);
+        const h = deserializeBaseBlockHeader(header);
+        const hashPrev = (0, utilityHelpers_noBuffer_1.asString)(header.slice(4, 36).reverse());
+        if (lastHeaderHash !== hashPrev)
+            throw { message: `header ${i} invalid previousHash ${lastHeaderHash} vs ${hashPrev}` };
+        lastHeaderHash = (0, utilityHelpers_noBuffer_1.asString)((0, utilityHelpers_1.doubleSha256BE)(header));
+        (0, dirtyHashes_1.validateAgainstDirtyHashes)(lastHeaderHash);
+        if (lastChainWork) {
+            lastChainWork = addWork(lastChainWork, convertBitsToWork(h.bits));
+        }
+    }
+    return { lastHeaderHash, lastChainWork };
+}
+/**
+ * Verifies that buffer begins with valid genesis block header for the specified chain.
+ * @param buffer
+ * @param chain
+ */
+function validateGenesisHeader(buffer, chain) {
+    const header = buffer.slice(0, 80);
+    const h = deserializeBlockHeader(header, 0, 0);
+    const gh = genesisHeader(chain);
+    if (h.bits !== gh.bits ||
+        h.previousHash !== gh.previousHash ||
+        h.merkleRoot !== gh.merkleRoot ||
+        h.time !== gh.time ||
+        h.nonce !== gh.nonce ||
+        h.version !== gh.version ||
+        h.height !== gh.height ||
+        h.hash !== gh.hash) {
+        throw new WERR_errors_1.WERR_INVALID_PARAMETER('buffer', `genesis header for chain ${chain}`);
+    }
+}
+/**
+ * @param work chainWork as a BigNumber
+ * @returns Converted chainWork value from BN to hex string of 32 bytes.
+ */
+function workBNtoBuffer(work) {
+    return work.toString(16).padStart(64, '0');
+}
+/**
+ * Returns true if work1 is more work (greater than) work2
+ */
+function isMoreWork(work1, work2) {
+    return new sdk_1.BigNumber((0, utilityHelpers_noBuffer_1.asArray)(work1), 16).gt(new sdk_1.BigNumber((0, utilityHelpers_noBuffer_1.asArray)(work2), 16));
+}
+/**
+ * Add two Buffer encoded chainwork values
+ * @returns Sum of work1 + work2 as Buffer encoded chainWork value
+ */
+function addWork(work1, work2) {
+    const sum = new sdk_1.BigNumber(work1, 16).add(new sdk_1.BigNumber(work2, 16));
+    return workBNtoBuffer(sum);
+}
+/**
+ * Subtract Buffer encoded chainwork values
+ * @returns work1 - work2 as Buffer encoded chainWork value
+ */
+function subWork(work1, work2) {
+    const sum = new sdk_1.BigNumber(work1, 16).sub(new sdk_1.BigNumber(work2, 16));
+    return workBNtoBuffer(sum);
+}
+/**
+ * Computes "target" value for 4 byte Bitcoin block header "bits" value.
+ * @param bits number or converted from Buffer using `readUint32LE`
+ * @returns 32 byte Buffer with "target" value
+ */
+function convertBitsToTarget(bits) {
+    if (Array.isArray(bits))
+        bits = readUInt32LE(bits, 0);
+    const shift = (bits >> 24) & 0xff;
+    const data = bits & 0x007fffff;
+    const target = new sdk_1.BigNumber(data);
+    if (shift <= 3) {
+        target.iushrn(8 * (3 - shift));
+    }
+    else {
+        target.iushln(8 * (shift - 3));
+    }
+    return target;
+}
+/**
+ * Computes "chainWork" value for 4 byte Bitcoin block header "bits" value.
+ * @param bits number or converted from Buffer using `readUint32LE`
+ * @returns 32 byte Buffer with "chainWork" value
+ */
+function convertBitsToWork(bits) {
+    const target = convertBitsToTarget(bits);
+    // convert target to work
+    const work = target.notn(256).div(target.addn(1)).addn(1);
+    return work.toString(16).padStart(64, '0');
+}
+function deserializeBaseBlockHeaders(buffer, offset = 0, count) {
+    const headers = [];
+    while ((!count || headers.length < count) && offset + 80 <= buffer.length && offset >= 0) {
+        headers.push(deserializeBaseBlockHeader(buffer, offset));
+        offset += 80;
+    }
+    return headers;
+}
+function deserializeBlockHeaders(firstHeight, buffer, offset = 0, count) {
+    const headers = [];
+    let nextHeight = firstHeight;
+    while ((!count || headers.length < count) && offset + 80 <= buffer.length && offset >= 0) {
+        const baseBuffer = buffer.slice(offset, offset + 80);
+        const base = deserializeBaseBlockHeader(baseBuffer);
+        const header = {
+            ...base,
+            height: nextHeight++,
+            hash: (0, utilityHelpers_noBuffer_1.asString)(blockHash(baseBuffer))
+        };
+        headers.push(header);
+        offset += 80;
+    }
+    return headers;
+}
+/**
+ * Given a block header, ensures that its format is correct. This does not
+ * check its difficulty or validity relative to the chain of headers.
+ *
+ * Throws on format errors.
+ *
+ * @param The header to validate
+ *
+ * @returns true if the header is correctly formatted
+ */
+function validateHeaderFormat(header) {
+    const ALLOWED_KEYS = {
+        version: true,
+        previousHash: true,
+        merkleRoot: true,
+        time: true,
+        bits: true,
+        nonce: true,
+        height: true,
+        hash: true
+    };
+    const UINT_MAX = 0xffffffff;
+    /**
+     * Root object checks
+     */
+    if (typeof header === 'undefined') {
+        throw new Error('Missing header.');
+    }
+    if (typeof header !== 'object') {
+        throw new Error('Header must be an object.');
+    }
+    if (!Object.keys(header).every(key => ALLOWED_KEYS[key])) {
+        throw new Error('Header contains extra properties.');
+    }
+    /**
+     * Version
+     */
+    if (typeof header.version !== 'number') {
+        throw new Error('Header version must be a number.');
+    }
+    if (!Number.isInteger(header.version)) {
+        throw new Error('Header version must be an integer.');
+    }
+    if (header.version < 0 || header.version > UINT_MAX) {
+        throw new Error(`Header version must be between 0 and ${UINT_MAX}.`);
+    }
+    /**
+     * Height
+     */
+    if (typeof header.height !== 'number') {
+        throw new Error('Header height must be a number.');
+    }
+    if (!Number.isInteger(header.height)) {
+        throw new Error('Header height must be an integer.');
+    }
+    if (header.height < 0 || header.height > UINT_MAX / 2) {
+        throw new Error(`Header version must be between 0 and ${UINT_MAX / 2}.`);
+    }
+    /**
+     * Previous hash
+     */
+    if (header.previousHash.length !== 64) {
+        throw new Error('Header previousHash must be 32 hex bytes.');
+    }
+    /**
+     * Merkle root
+     */
+    if (header.merkleRoot.length !== 64) {
+        throw new Error('Header merkleRoot must be 32 hex bytes.');
+    }
+    /**
+     * Time
+     */
+    if (typeof header.time !== 'number') {
+        throw new Error('Header time must be a number.');
+    }
+    if (!Number.isInteger(header.time)) {
+        throw new Error('Header time must be an integer.');
+    }
+    if (header.time < 0 || header.time > UINT_MAX) {
+        throw new Error(`Header time must be between 0 and ${UINT_MAX}.`);
+    }
+    /**
+     * Bits
+     */
+    if (typeof header.bits !== 'number') {
+        throw new Error('Header bits must be a number.');
+    }
+    if (!Number.isInteger(header.bits)) {
+        throw new Error('Header bits must be an integer.');
+    }
+    if (header.bits < 0 || header.bits > UINT_MAX) {
+        throw new Error(`Header bits must be between 0 and ${UINT_MAX}.`);
+    }
+    /**
+     * Nonce
+     */
+    if (typeof header.nonce !== 'number') {
+        throw new Error('Header nonce must be a number.');
+    }
+    if (!Number.isInteger(header.nonce)) {
+        throw new Error('Header nonce must be an integer.');
+    }
+    if (header.nonce < 0 || header.nonce > UINT_MAX) {
+        throw new Error(`Header nonce must be between 0 and ${UINT_MAX}.`);
+    }
+    /**
+     * Hash
+     */
+    if (header.hash.length !== 64) {
+        throw new Error('Header hash must be 32 hex bytes.');
+    }
+    if (header.hash !== (0, utilityHelpers_noBuffer_1.asString)(blockHash(header))) {
+        throw new Error('Header hash is invalid.');
+    }
+}
+/**
+ * Ensures that a header has a valid proof-of-work
+ * Requires chain is 'main'
+ *
+ * @param header The header to validate
+ *
+ * @returns true if the header is valid
+ */
+function validateHeaderDifficulty(hash, bits) {
+    const hashBN = new sdk_1.BigNumber((0, utilityHelpers_noBuffer_1.asArray)(hash));
+    const target = convertBitsToTarget(bits);
+    if (hashBN.lte(target))
+        return true;
+    throw new Error('Block hash is not less than specified target.');
+}
+/**
+ * Computes double sha256 hash of bitcoin block header
+ * bytes are reversed to bigendian order
+ *
+ * If header is a Buffer, it is required to 80 bytes long
+ * and in standard block header serialized encoding.
+ *
+ * @returns doule sha256 hash of header bytes reversed
+ * @publicbody
+ */
+function blockHash(header) {
+    const a = !Array.isArray(header) && !(header instanceof Uint8Array) ? serializeBaseBlockHeader(header) : header;
+    if (a.length !== 80)
+        throw new Error('Block header must be 80 bytes long.');
+    return (0, utilityHelpers_noBuffer_1.asString)((0, utilityHelpers_1.doubleSha256BE)(a));
+}
+/**
+ * Serializes a block header as an 80 byte Buffer.
+ * The exact serialized format is defined in the Bitcoin White Paper
+ * such that computing a double sha256 hash of the buffer computes
+ * the block hash for the header.
+ * @returns 80 byte Buffer
+ * @publicbody
+ */
+function serializeBaseBlockHeader(header, buffer, offset) {
+    const writer = new sdk_1.Utils.Writer();
+    writer.writeUInt32LE(header.version);
+    writer.write((0, utilityHelpers_noBuffer_1.asArray)(header.previousHash).reverse());
+    writer.write((0, utilityHelpers_noBuffer_1.asArray)(header.merkleRoot).reverse());
+    writer.writeUInt32LE(header.time);
+    writer.writeUInt32LE(header.bits);
+    writer.writeUInt32LE(header.nonce);
+    const data = writer.toArray();
+    if (buffer) {
+        offset || (offset = 0);
+        for (let i = 0; i < data.length; i++) {
+            if (offset + i >= buffer.length) {
+                throw new Error(`Buffer overflow at offset ${offset + i} for data length ${data.length}`);
+            }
+            buffer[offset + i] = data[i];
+        }
+    }
+    return data;
+}
+function serializeBaseBlockHeaders(headers) {
+    const data = new Uint8Array(headers.length * 80);
+    let i = -1;
+    for (const header of headers) {
+        i++;
+        const d = serializeBaseBlockHeader(header);
+        data.set(d, i * 80);
+    }
+    return data;
+}
+/**
+ * Deserialize a BaseBlockHeader from an 80 byte buffer
+ * @publicbody
+ */
+function deserializeBaseBlockHeader(buffer, offset = 0) {
+    const reader = ReaderUint8Array_1.ReaderUint8Array.makeReader(buffer, offset);
+    const header = {
+        version: reader.readUInt32LE(),
+        previousHash: (0, utilityHelpers_noBuffer_1.asString)(reader.read(32).reverse()),
+        merkleRoot: (0, utilityHelpers_noBuffer_1.asString)(reader.read(32).reverse()),
+        time: reader.readUInt32LE(),
+        bits: reader.readUInt32LE(),
+        nonce: reader.readUInt32LE()
+    };
+    return header;
+}
+function deserializeBlockHeader(buffer, offset = 0, height) {
+    const base = deserializeBaseBlockHeader(buffer, offset);
+    const header = {
+        ...base,
+        height,
+        hash: (0, utilityHelpers_noBuffer_1.asString)((0, utilityHelpers_1.doubleSha256BE)(buffer.slice(offset, offset + 80)))
+    };
+    return header;
+}
+/**
+ * Returns the genesis block for the specified chain.
+ * @publicbody
+ */
+function genesisHeader(chain) {
+    return chain === 'main'
+        ? {
+            version: 1,
+            previousHash: '0000000000000000000000000000000000000000000000000000000000000000',
+            merkleRoot: '4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b',
+            time: 1231006505,
+            bits: 486604799,
+            nonce: 2083236893,
+            height: 0,
+            hash: '000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f'
+        }
+        : {
+            version: 1,
+            previousHash: '0000000000000000000000000000000000000000000000000000000000000000',
+            merkleRoot: '4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b',
+            time: 1296688602,
+            bits: 486604799,
+            nonce: 414098458,
+            height: 0,
+            hash: '000000000933ea01ad0ee984209779baaec3ced90fa3f408719526f8d77f4943'
+        };
+}
+/**
+ * Returns the genesis block for the specified chain.
+ * @publicbody
+ */
+function genesisBuffer(chain) {
+    return serializeBaseBlockHeader(genesisHeader(chain));
+}
+/**
+ * Returns a copy of a Buffer with byte order reversed.
+ * @returns new buffer with byte order reversed.
+ * @publicbody
+ */
+function swapByteOrder(buffer) {
+    return buffer.slice().reverse();
+}
+/**
+ * @param num a number value in the Uint32 value range
+ * @param littleEndian true for little-endian byte order in Buffer
+ * @returns four byte buffer with Uint32 number encoded
+ * @publicbody
+ */
+function convertUint32ToBuffer(n, littleEndian = true) {
+    const a = [
+        n & 0xff, // lowest byte
+        (n >> 8) & 0xff,
+        (n >> 16) & 0xff,
+        (n >> 24) & 0xff // highest byte
+    ];
+    return littleEndian ? a : a.reverse();
+}
+function writeUInt32LE(n, a, offset) {
+    a[offset++] = n & 0xff; // lowest byte
+    a[offset++] = (n >> 8) & 0xff;
+    a[offset++] = (n >> 16) & 0xff;
+    a[offset++] = (n >> 24) & 0xff; // highest byte
+    return offset;
+}
+function writeUInt32BE(n, a, offset) {
+    a[offset++] = (n >> 24) & 0xff; // highest byte
+    a[offset++] = (n >> 16) & 0xff;
+    a[offset++] = (n >> 8) & 0xff;
+    a[offset++] = n & 0xff; // lowest byte
+    return offset;
+}
+function readUInt32LE(a, offset) {
+    return a[offset++] | (a[offset++] << 8) | (a[offset++] << 16) | (a[offset++] << 24);
+}
+function readUInt32BE(a, offset) {
+    return (a[offset++] << 24) | (a[offset++] << 16) | (a[offset++] << 8) | a[offset++];
+}
+/**
+ * @param buffer four byte buffer with Uint32 number encoded
+ * @param littleEndian true for little-endian byte order in Buffer
+ * @returns a number value in the Uint32 value range
+ * @publicbody
+ */
+function convertBufferToUint32(buffer, littleEndian = true) {
+    const a = littleEndian ? buffer : buffer.slice().reverse();
+    const n = a[0] | (a[1] << 8) | (a[2] << 16) | (a[3] << 24);
+    return n;
+}
+//# sourceMappingURL=blockHeaderUtilities.js.map

package/out/src/services/chaintracker/chaintracks/util/blockHeaderUtilities.js.map

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

package/out/src/services/chaintracker/chaintracks/util/dirtyHashes.d.ts

@@ -0,0 +1,20 @@
+/**
+ * These hashes are for blocks that are to known to have violated the Bitcoin
+ * protocol. Regardless of the amount of proof-of-work that chains built on top
+ * of them may have accumulated, they cannot be considered valid Bitcoin blocks.
+ *
+ * In the first instance, segregating witness data from transactions is not
+ * part of the design of Bitcoin.
+ *
+ * In the second instance, adding new opcodes to be used when evaluating
+ * scripts is also not allowed.
+ */
+export declare const dirtyHashes: {
+    '00000000000000000019f112ec0a9982926f1258cdcc558dd7c3b7e5dc7fa148': string;
+    '0000000000000000004626ff6e3b936941d341c5932ece4357eeccac44e6d56c': string;
+};
+/**
+ * Throws Error if blockHash is in the dirtyHashes list.
+ */
+export declare function validateAgainstDirtyHashes(blockHash: string): void;
+//# sourceMappingURL=dirtyHashes.d.ts.map

package/out/src/services/chaintracker/chaintracks/util/dirtyHashes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirtyHashes.d.ts","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/util/dirtyHashes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW;;;CAQvB,CAAA;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAIlE"}

package/out/src/services/chaintracker/chaintracks/util/dirtyHashes.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dirtyHashes = void 0;
+exports.validateAgainstDirtyHashes = validateAgainstDirtyHashes;
+/**
+ * These hashes are for blocks that are to known to have violated the Bitcoin
+ * protocol. Regardless of the amount of proof-of-work that chains built on top
+ * of them may have accumulated, they cannot be considered valid Bitcoin blocks.
+ *
+ * In the first instance, segregating witness data from transactions is not
+ * part of the design of Bitcoin.
+ *
+ * In the second instance, adding new opcodes to be used when evaluating
+ * scripts is also not allowed.
+ */
+exports.dirtyHashes = {
+    // Block 478,558 with hash of 0000000000000000011865af4122fe3b144e2cbeea86142e8ff2fb4107352d43 was the last block shared by BSV, BCH and BTC
+    // Block 478,559 with hash of 00000000000000000019f112ec0a9982926f1258cdcc558dd7c3b7e5dc7fa148 was the first block of the BTC Segwit chain.
+    // Block 478,559 with hash of 000000000000000000651ef99cb9fcbe0dadde1d424bd9f15ff20136191a5eec was the valid Bitcoin block shared by BSV and BCH.
+    '00000000000000000019f112ec0a9982926f1258cdcc558dd7c3b7e5dc7fa148': 'This is the first header of the invalid SegWit chain.',
+    '0000000000000000004626ff6e3b936941d341c5932ece4357eeccac44e6d56c': 'This is the first header of the invalid ABC chain.'
+};
+/**
+ * Throws Error if blockHash is in the dirtyHashes list.
+ */
+function validateAgainstDirtyHashes(blockHash) {
+    if (exports.dirtyHashes[blockHash]) {
+        throw new Error(`Not adding a header with a dirty hash: ${exports.dirtyHashes[blockHash]}`);
+    }
+}
+//# sourceMappingURL=dirtyHashes.js.map

package/out/src/services/chaintracker/chaintracks/util/dirtyHashes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirtyHashes.js","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/util/dirtyHashes.ts"],"names":[],"mappings":";;;AAwBA,gEAIC;AA5BD;;;;;;;;;;GAUG;AACU,QAAA,WAAW,GAAG;IACzB,4IAA4I;IAC5I,2IAA2I;IAC3I,iJAAiJ;IACjJ,kEAAkE,EAChE,uDAAuD;IACzD,kEAAkE,EAChE,oDAAoD;CACvD,CAAA;AAED;;GAEG;AACH,SAAgB,0BAA0B,CAAC,SAAiB;IAC1D,IAAI,mBAAW,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,0CAA0C,mBAAW,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;IACrF,CAAC;AACH,CAAC"}

package/out/src/services/chaintracker/chaintracks/util/validBulkHeaderFilesByFileHash.d.ts

@@ -0,0 +1,37 @@
+import { BulkHeaderFileInfo } from './BulkHeaderFile';
+/**
+ * Compares meta data received for a bulk header file `vbf` to known
+ * valid bulk header files based on their `fileHash`.
+ *
+ * Short circuits both the retreival and validation of individual headers,
+ * only a single SHA256 hash of the aggregate data needs to be compared.
+ *
+ * The standard file size for historic block headers is 100,000 per file
+ * which results in a many orders of magnitude initialization speedup.
+ *
+ * The following properties must match:
+ * - `firstHeight`
+ * - `count`
+ * - `prevChainWork`
+ * - `prevHash`
+ * - `lastChainWork`
+ * - `lastHash`
+ * - `chain`
+ *
+ * @param vbf
+ * @returns true iff bulk file meta data (excluding its source) matches a known file.
+ *
+ * @publicbody
+ */
+export declare function isKnownValidBulkHeaderFile(vbf: BulkHeaderFileInfo): boolean;
+/**
+ * Hash map of known valid bulk header files by their `fileHash`.
+ * @returns object where keys are file hashes of known bulk header files.
+ */
+export declare function validBulkHeaderFilesByFileHash(): Record<string, BulkHeaderFileInfo>;
+/**
+ * Static array of known valid bulk header files.
+ * `sourceUrl` is included only as a reference to the original certifying authority.
+ */
+export declare const validBulkHeaderFiles: BulkHeaderFileInfo[];
+//# sourceMappingURL=validBulkHeaderFilesByFileHash.d.ts.map

package/out/src/services/chaintracker/chaintracks/util/validBulkHeaderFilesByFileHash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validBulkHeaderFilesByFileHash.d.ts","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/util/validBulkHeaderFilesByFileHash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAgB3E;AAID;;;GAGG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAUnF;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,EA6WpD,CAAA"}