@bsv/wallet-toolbox-client 1.7.14 → 1.7.15

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

@@ -1,159 +0,0 @@
-import { BigNumber } from '@bsv/sdk';
-import { Chain } from '../../../../sdk/types';
-import { ChaintracksFsApi } from '../Api/ChaintracksFsApi';
-import { BulkHeaderFileInfo } from './BulkHeaderFile';
-import { ChaintracksFetchApi } from '../Api/ChaintracksFetchApi';
-import { BaseBlockHeader, BlockHeader } from '../../../../sdk/WalletServices.interfaces';
-/**
- * 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.
- */
-export declare function sha256HashOfBinaryFile(fs: ChaintracksFsApi, filepath: string, bufferSize?: number): Promise<{
-    hash: string;
-    length: number;
-}>;
-/**
- * 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.
- */
-export declare function validateBulkFileData(bf: BulkHeaderFileInfo, prevHash: string, prevChainWork: string, fetch?: ChaintracksFetchApi): Promise<BulkHeaderFileInfo>;
-/**
- * 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.
- */
-export declare function validateBufferOfHeaders(buffer: Uint8Array, previousHash: string, offset?: number, count?: number, previousChainWork?: string): {
-    lastHeaderHash: string;
-    lastChainWork: string | undefined;
-};
-/**
- * Verifies that buffer begins with valid genesis block header for the specified chain.
- * @param buffer
- * @param chain
- */
-export declare function validateGenesisHeader(buffer: Uint8Array, chain: Chain): void;
-/**
- * @param work chainWork as a BigNumber
- * @returns Converted chainWork value from BN to hex string of 32 bytes.
- */
-export declare function workBNtoBuffer(work: BigNumber): string;
-/**
- * Returns true if work1 is more work (greater than) work2
- */
-export declare function isMoreWork(work1: string, work2: string): boolean;
-/**
- * Add two Buffer encoded chainwork values
- * @returns Sum of work1 + work2 as Buffer encoded chainWork value
- */
-export declare function addWork(work1: string, work2: string): string;
-/**
- * Subtract Buffer encoded chainwork values
- * @returns work1 - work2 as Buffer encoded chainWork value
- */
-export declare function subWork(work1: string, work2: string): string;
-/**
- * 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
- */
-export declare function convertBitsToTarget(bits: number | number[]): BigNumber;
-/**
- * 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
- */
-export declare function convertBitsToWork(bits: number | number[]): string;
-export declare function deserializeBaseBlockHeaders(buffer: number[] | Uint8Array, offset?: number, count?: number | undefined): BaseBlockHeader[];
-export declare function deserializeBlockHeaders(firstHeight: number, buffer: number[] | Uint8Array, offset?: number, count?: number | undefined): BlockHeader[];
-/**
- * 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
- */
-export declare function validateHeaderFormat(header: BlockHeader): void;
-/**
- * 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
- */
-export declare function validateHeaderDifficulty(hash: Buffer, bits: number): boolean;
-/**
- * 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
- */
-export declare function blockHash(header: BaseBlockHeader | number[] | Uint8Array): string;
-/**
- * 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
- */
-export declare function serializeBaseBlockHeader(header: BaseBlockHeader, buffer?: number[], offset?: number): number[];
-export declare function serializeBaseBlockHeaders(headers: BlockHeader[]): Uint8Array;
-/**
- * Deserialize a BaseBlockHeader from an 80 byte buffer
- * @publicbody
- */
-export declare function deserializeBaseBlockHeader(buffer: number[] | Uint8Array, offset?: number): BaseBlockHeader;
-export declare function deserializeBlockHeader(buffer: number[] | Uint8Array, offset: number | undefined, height: number): BlockHeader;
-/**
- * Returns the genesis block for the specified chain.
- * @publicbody
- */
-export declare function genesisHeader(chain: Chain): BlockHeader;
-/**
- * Returns the genesis block for the specified chain.
- * @publicbody
- */
-export declare function genesisBuffer(chain: Chain): number[];
-/**
- * Returns a copy of a Buffer with byte order reversed.
- * @returns new buffer with byte order reversed.
- * @publicbody
- */
-export declare function swapByteOrder(buffer: number[]): number[];
-/**
- * @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
- */
-export declare function convertUint32ToBuffer(n: number, littleEndian?: boolean): number[];
-export declare function writeUInt32LE(n: number, a: number[] | Uint8Array, offset: number): number;
-export declare function writeUInt32BE(n: number, a: number[] | Uint8Array, offset: number): number;
-export declare function readUInt32LE(a: number[] | Uint8Array, offset: number): number;
-export declare function readUInt32BE(a: number[] | Uint8Array, offset: number): number;
-/**
- * @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
- */
-export declare function convertBufferToUint32(buffer: number[] | Uint8Array, littleEndian?: boolean): number;
-//# sourceMappingURL=blockHeaderUtilities.d.ts.map

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

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

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

@@ -1,520 +0,0 @@
-"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