@feelyourprotocol/block 8141.0.0

package/dist/cjs/from-beacon-payload.d.ts

@@ -0,0 +1,36 @@
+import type { NumericString, PrefixedHexString } from '@feelyourprotocol/util';
+import type { ExecutionPayload } from './types.ts';
+type BeaconWithdrawal = {
+    index: PrefixedHexString;
+    validator_index: PrefixedHexString;
+    address: PrefixedHexString;
+    amount: PrefixedHexString;
+};
+export type BeaconPayloadJSON = {
+    parent_hash: PrefixedHexString;
+    fee_recipient: PrefixedHexString;
+    state_root: PrefixedHexString;
+    receipts_root: PrefixedHexString;
+    logs_bloom: PrefixedHexString;
+    prev_randao: PrefixedHexString;
+    block_number: NumericString;
+    gas_limit: NumericString;
+    gas_used: NumericString;
+    timestamp: NumericString;
+    extra_data: PrefixedHexString;
+    base_fee_per_gas: NumericString;
+    block_hash: PrefixedHexString;
+    transactions: PrefixedHexString[];
+    withdrawals?: BeaconWithdrawal[];
+    blob_gas_used?: NumericString;
+    excess_blob_gas?: NumericString;
+    parent_beacon_block_root?: PrefixedHexString;
+    requests_hash?: PrefixedHexString;
+};
+/**
+ * Converts a beacon block execution payload JSON object {@link BeaconPayloadJSON} to the {@link ExecutionPayload} data needed to construct a {@link Block}.
+ * The JSON data can be retrieved from a consensus layer (CL) client on this Beacon API `/eth/v2/beacon/blocks/[block number]`
+ */
+export declare function executionPayloadFromBeaconPayload(payload: BeaconPayloadJSON): ExecutionPayload;
+export {};
+//# sourceMappingURL=from-beacon-payload.d.ts.map

package/dist/cjs/from-beacon-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-beacon-payload.d.ts","sourceRoot":"","sources":["../../src/from-beacon-payload.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,KAAK,gBAAgB,GAAG;IACtB,KAAK,EAAE,iBAAiB,CAAA;IACxB,eAAe,EAAE,iBAAiB,CAAA;IAClC,OAAO,EAAE,iBAAiB,CAAA;IAC1B,MAAM,EAAE,iBAAiB,CAAA;CAC1B,CAAA;AAID,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,iBAAiB,CAAA;IAC9B,aAAa,EAAE,iBAAiB,CAAA;IAChC,UAAU,EAAE,iBAAiB,CAAA;IAC7B,aAAa,EAAE,iBAAiB,CAAA;IAChC,UAAU,EAAE,iBAAiB,CAAA;IAC7B,WAAW,EAAE,iBAAiB,CAAA;IAC9B,YAAY,EAAE,aAAa,CAAA;IAC3B,SAAS,EAAE,aAAa,CAAA;IACxB,QAAQ,EAAE,aAAa,CAAA;IACvB,SAAS,EAAE,aAAa,CAAA;IACxB,UAAU,EAAE,iBAAiB,CAAA;IAC7B,gBAAgB,EAAE,aAAa,CAAA;IAC/B,UAAU,EAAE,iBAAiB,CAAA;IAC7B,YAAY,EAAE,iBAAiB,EAAE,CAAA;IACjC,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAChC,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,eAAe,CAAC,EAAE,aAAa,CAAA;IAC/B,wBAAwB,CAAC,EAAE,iBAAiB,CAAA;IAC5C,aAAa,CAAC,EAAE,iBAAiB,CAAA;CAClC,CAAA;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAyC9F"}

package/dist/cjs/from-beacon-payload.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executionPayloadFromBeaconPayload = executionPayloadFromBeaconPayload;
+const util_1 = require("@feelyourprotocol/util");
+/**
+ * Converts a beacon block execution payload JSON object {@link BeaconPayloadJSON} to the {@link ExecutionPayload} data needed to construct a {@link Block}.
+ * The JSON data can be retrieved from a consensus layer (CL) client on this Beacon API `/eth/v2/beacon/blocks/[block number]`
+ */
+function executionPayloadFromBeaconPayload(payload) {
+    const executionPayload = {
+        parentHash: payload.parent_hash,
+        feeRecipient: payload.fee_recipient,
+        stateRoot: payload.state_root,
+        receiptsRoot: payload.receipts_root,
+        logsBloom: payload.logs_bloom,
+        prevRandao: payload.prev_randao,
+        blockNumber: (0, util_1.bigIntToHex)(BigInt(payload.block_number)),
+        gasLimit: (0, util_1.bigIntToHex)(BigInt(payload.gas_limit)),
+        gasUsed: (0, util_1.bigIntToHex)(BigInt(payload.gas_used)),
+        timestamp: (0, util_1.bigIntToHex)(BigInt(payload.timestamp)),
+        extraData: payload.extra_data,
+        baseFeePerGas: (0, util_1.bigIntToHex)(BigInt(payload.base_fee_per_gas)),
+        blockHash: payload.block_hash,
+        transactions: payload.transactions,
+    };
+    if (payload.withdrawals !== undefined && payload.withdrawals !== null) {
+        executionPayload.withdrawals = payload.withdrawals.map((wd) => ({
+            index: (0, util_1.bigIntToHex)(BigInt(wd.index)),
+            validatorIndex: (0, util_1.bigIntToHex)(BigInt(wd.validator_index)),
+            address: wd.address,
+            amount: (0, util_1.bigIntToHex)(BigInt(wd.amount)),
+        }));
+    }
+    if (payload.blob_gas_used !== undefined && payload.blob_gas_used !== null) {
+        executionPayload.blobGasUsed = (0, util_1.bigIntToHex)(BigInt(payload.blob_gas_used));
+    }
+    if (payload.excess_blob_gas !== undefined && payload.excess_blob_gas !== null) {
+        executionPayload.excessBlobGas = (0, util_1.bigIntToHex)(BigInt(payload.excess_blob_gas));
+    }
+    if (payload.parent_beacon_block_root !== undefined && payload.parent_beacon_block_root !== null) {
+        executionPayload.parentBeaconBlockRoot = payload.parent_beacon_block_root;
+    }
+    if (payload.requests_hash !== undefined && payload.requests_hash !== null) {
+        executionPayload.requestsHash = payload.requests_hash;
+    }
+    return executionPayload;
+}
+//# sourceMappingURL=from-beacon-payload.js.map

package/dist/cjs/from-beacon-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-beacon-payload.js","sourceRoot":"","sources":["../../src/from-beacon-payload.ts"],"names":[],"mappings":";;AAwCA,8EAyCC;AAjFD,2CAA8C;AAoC9C;;;GAGG;AACH,SAAgB,iCAAiC,CAAC,OAA0B;IAC1E,MAAM,gBAAgB,GAAqB;QACzC,UAAU,EAAE,OAAO,CAAC,WAAW;QAC/B,YAAY,EAAE,OAAO,CAAC,aAAa;QACnC,SAAS,EAAE,OAAO,CAAC,UAAU;QAC7B,YAAY,EAAE,OAAO,CAAC,aAAa;QACnC,SAAS,EAAE,OAAO,CAAC,UAAU;QAC7B,UAAU,EAAE,OAAO,CAAC,WAAW;QAC/B,WAAW,EAAE,IAAA,kBAAW,EAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACtD,QAAQ,EAAE,IAAA,kBAAW,EAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChD,OAAO,EAAE,IAAA,kBAAW,EAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9C,SAAS,EAAE,IAAA,kBAAW,EAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACjD,SAAS,EAAE,OAAO,CAAC,UAAU;QAC7B,aAAa,EAAE,IAAA,kBAAW,EAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC5D,SAAS,EAAE,OAAO,CAAC,UAAU;QAC7B,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAA;IAED,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACtE,gBAAgB,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC9D,KAAK,EAAE,IAAA,kBAAW,EAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YACpC,cAAc,EAAE,IAAA,kBAAW,EAAC,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC;YACvD,OAAO,EAAE,EAAE,CAAC,OAAO;YACnB,MAAM,EAAE,IAAA,kBAAW,EAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;SACvC,CAAC,CAAC,CAAA;IACL,CAAC;IAED,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QAC1E,gBAAgB,CAAC,WAAW,GAAG,IAAA,kBAAW,EAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAA;IAC3E,CAAC;IACD,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;QAC9E,gBAAgB,CAAC,aAAa,GAAG,IAAA,kBAAW,EAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAA;IAC/E,CAAC;IACD,IAAI,OAAO,CAAC,wBAAwB,KAAK,SAAS,IAAI,OAAO,CAAC,wBAAwB,KAAK,IAAI,EAAE,CAAC;QAChG,gBAAgB,CAAC,qBAAqB,GAAG,OAAO,CAAC,wBAAwB,CAAA;IAC3E,CAAC;IACD,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QAC1E,gBAAgB,CAAC,YAAY,GAAG,OAAO,CAAC,aAAa,CAAA;IACvD,CAAC;IAED,OAAO,gBAAgB,CAAA;AACzB,CAAC"}

package/dist/cjs/header/constructors.d.ts

@@ -0,0 +1,39 @@
+import { BlockHeader } from '../index.ts';
+import type { BlockHeaderBytes, BlockOptions, HeaderData, JSONRPCBlock } from '../types.ts';
+/**
+ * Static constructor to create a block header from a header data dictionary
+ *
+ * @param headerData
+ * @param opts
+ */
+export declare function createBlockHeader(headerData?: HeaderData, opts?: BlockOptions): BlockHeader;
+/**
+ * Static constructor to create a block header from an array of bytes values
+ *
+ * @param values
+ * @param opts
+ */
+export declare function createBlockHeaderFromBytesArray(values: BlockHeaderBytes, opts?: BlockOptions): BlockHeader;
+/**
+ * Static constructor to create a block header from a RLP-serialized header
+ *
+ * @param serializedHeaderData
+ * @param opts
+ */
+export declare function createBlockHeaderFromRLP(serializedHeaderData: Uint8Array, opts?: BlockOptions): BlockHeader;
+/**
+ * Creates a Clique block header with the seal applied during instantiation.
+ * @param headerData Header fields for the Clique block
+ * @param cliqueSigner Private key bytes used to sign the header
+ * @param opts {@link BlockOptions}
+ * @returns A sealed {@link BlockHeader}
+ */
+export declare function createSealedCliqueBlockHeader(headerData: HeaderData | undefined, cliqueSigner: Uint8Array, opts?: BlockOptions): BlockHeader;
+/**
+ * Creates a new block header object from Ethereum JSON RPC.
+ *
+ * @param blockParams - Ethereum JSON RPC of block (eth_getBlockByNumber)
+ * @param options - An object describing the blockchain
+ */
+export declare function createBlockHeaderFromRPC(blockParams: JSONRPCBlock, options?: BlockOptions): BlockHeader;
+//# sourceMappingURL=constructors.d.ts.map

package/dist/cjs/header/constructors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructors.d.ts","sourceRoot":"","sources":["../../../src/header/constructors.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE3F;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,GAAE,UAAe,EAAE,IAAI,GAAE,YAAiB,eAErF;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,GAAE,YAAiB,eAmChG;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,oBAAoB,EAAE,UAAU,EAChC,IAAI,GAAE,YAAiB,eAOxB;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,UAAU,YAAK,EAC3B,YAAY,EAAE,UAAU,EACxB,IAAI,GAAE,YAAiB,GACtB,WAAW,CAab;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,YAAY,eAyDzF"}

package/dist/cjs/header/constructors.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBlockHeader = createBlockHeader;
+exports.createBlockHeaderFromBytesArray = createBlockHeaderFromBytesArray;
+exports.createBlockHeaderFromRLP = createBlockHeaderFromRLP;
+exports.createSealedCliqueBlockHeader = createSealedCliqueBlockHeader;
+exports.createBlockHeaderFromRPC = createBlockHeaderFromRPC;
+const rlp_1 = require("@feelyourprotocol/rlp");
+const util_1 = require("@feelyourprotocol/util");
+const clique_ts_1 = require("../consensus/clique.js");
+const helpers_ts_1 = require("../helpers.js");
+const index_ts_1 = require("../index.js");
+/**
+ * Static constructor to create a block header from a header data dictionary
+ *
+ * @param headerData
+ * @param opts
+ */
+function createBlockHeader(headerData = {}, opts = {}) {
+    return new index_ts_1.BlockHeader(headerData, opts);
+}
+/**
+ * Static constructor to create a block header from an array of bytes values
+ *
+ * @param values
+ * @param opts
+ */
+function createBlockHeaderFromBytesArray(values, opts = {}) {
+    const headerData = (0, helpers_ts_1.valuesArrayToHeaderData)(values);
+    const { number, baseFeePerGas, excessBlobGas, blobGasUsed, parentBeaconBlockRoot, requestsHash } = headerData;
+    const header = createBlockHeader(headerData, opts);
+    if (header.common.isActivatedEIP(1559) && baseFeePerGas === undefined) {
+        const eip1559ActivationBlock = (0, util_1.bigIntToBytes)(header.common.eipBlock(1559));
+        if (eip1559ActivationBlock !== undefined &&
+            (0, util_1.equalsBytes)(eip1559ActivationBlock, number)) {
+            throw (0, util_1.EthereumJSErrorWithoutCode)('invalid header. baseFeePerGas should be provided');
+        }
+    }
+    if (header.common.isActivatedEIP(4844)) {
+        if (excessBlobGas === undefined) {
+            throw (0, util_1.EthereumJSErrorWithoutCode)('invalid header. excessBlobGas should be provided');
+        }
+        else if (blobGasUsed === undefined) {
+            throw (0, util_1.EthereumJSErrorWithoutCode)('invalid header. blobGasUsed should be provided');
+        }
+    }
+    if (header.common.isActivatedEIP(4788) && parentBeaconBlockRoot === undefined) {
+        throw (0, util_1.EthereumJSErrorWithoutCode)('invalid header. parentBeaconBlockRoot should be provided');
+    }
+    if (header.common.isActivatedEIP(7685) && requestsHash === undefined) {
+        throw (0, util_1.EthereumJSErrorWithoutCode)('invalid header. requestsHash should be provided');
+    }
+    if (header.common.isActivatedEIP(7928) && header.blockAccessListHash === undefined) {
+        throw (0, util_1.EthereumJSErrorWithoutCode)('invalid header. blockAccessListHash should be provided');
+    }
+    if (header.common.isActivatedEIP(7843) && header.slotNumber === undefined) {
+        throw (0, util_1.EthereumJSErrorWithoutCode)('invalid header. slotNumber should be provided');
+    }
+    return header;
+}
+/**
+ * Static constructor to create a block header from a RLP-serialized header
+ *
+ * @param serializedHeaderData
+ * @param opts
+ */
+function createBlockHeaderFromRLP(serializedHeaderData, opts = {}) {
+    const values = rlp_1.RLP.decode(serializedHeaderData);
+    if (!Array.isArray(values)) {
+        throw (0, util_1.EthereumJSErrorWithoutCode)('Invalid serialized header input. Must be array');
+    }
+    return createBlockHeaderFromBytesArray(values, opts);
+}
+/**
+ * Creates a Clique block header with the seal applied during instantiation.
+ * @param headerData Header fields for the Clique block
+ * @param cliqueSigner Private key bytes used to sign the header
+ * @param opts {@link BlockOptions}
+ * @returns A sealed {@link BlockHeader}
+ */
+function createSealedCliqueBlockHeader(headerData = {}, cliqueSigner, opts = {}) {
+    const sealedCliqueBlockHeader = new index_ts_1.BlockHeader(headerData, {
+        ...opts,
+        ...{ skipConsensusFormatValidation: true },
+    });
+    sealedCliqueBlockHeader.extraData = (0, clique_ts_1.generateCliqueBlockExtraData)(sealedCliqueBlockHeader, cliqueSigner);
+    if (opts.skipConsensusFormatValidation === false)
+        // We need to validate the consensus format here since we skipped it when constructing the block header
+        sealedCliqueBlockHeader['_consensusFormatValidation']();
+    return sealedCliqueBlockHeader;
+}
+/**
+ * Creates a new block header object from Ethereum JSON RPC.
+ *
+ * @param blockParams - Ethereum JSON RPC of block (eth_getBlockByNumber)
+ * @param options - An object describing the blockchain
+ */
+function createBlockHeaderFromRPC(blockParams, options) {
+    const { parentHash, sha3Uncles, miner, stateRoot, transactionsRoot, receiptsRoot, logsBloom, difficulty, number, gasLimit, gasUsed, timestamp, extraData, mixHash, nonce, baseFeePerGas, withdrawalsRoot, blobGasUsed, excessBlobGas, parentBeaconBlockRoot, requestsHash, blockAccessListHash, slotNumber, } = blockParams;
+    const blockHeader = new index_ts_1.BlockHeader({
+        parentHash,
+        uncleHash: sha3Uncles,
+        coinbase: miner,
+        stateRoot,
+        transactionsTrie: transactionsRoot,
+        receiptTrie: receiptsRoot,
+        logsBloom,
+        difficulty: (0, helpers_ts_1.numberToHex)(difficulty),
+        number,
+        gasLimit,
+        gasUsed,
+        timestamp,
+        extraData,
+        mixHash,
+        nonce,
+        baseFeePerGas,
+        withdrawalsRoot,
+        blobGasUsed,
+        excessBlobGas,
+        parentBeaconBlockRoot,
+        requestsHash,
+        blockAccessListHash,
+        slotNumber,
+    }, options);
+    return blockHeader;
+}
+//# sourceMappingURL=constructors.js.map

package/dist/cjs/header/constructors.js.map

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

package/dist/cjs/header/header.d.ts

@@ -0,0 +1,134 @@
+import { Common } from '@feelyourprotocol/common';
+import { Address } from '@feelyourprotocol/util';
+import type { BlockHeaderBytes, BlockOptions, HeaderData, JSONHeader } from '../types.ts';
+interface HeaderCache {
+    hash: Uint8Array | undefined;
+}
+/**
+ * An object that represents the block header.
+ */
+export declare class BlockHeader {
+    readonly parentHash: Uint8Array;
+    readonly uncleHash: Uint8Array;
+    readonly coinbase: Address;
+    readonly stateRoot: Uint8Array;
+    readonly transactionsTrie: Uint8Array;
+    readonly receiptTrie: Uint8Array;
+    readonly logsBloom: Uint8Array;
+    readonly difficulty: bigint;
+    readonly number: bigint;
+    readonly gasLimit: bigint;
+    readonly gasUsed: bigint;
+    readonly timestamp: bigint;
+    readonly extraData: Uint8Array;
+    readonly mixHash: Uint8Array;
+    readonly nonce: Uint8Array;
+    readonly baseFeePerGas?: bigint;
+    readonly withdrawalsRoot?: Uint8Array;
+    readonly blobGasUsed?: bigint;
+    readonly excessBlobGas?: bigint;
+    readonly parentBeaconBlockRoot?: Uint8Array;
+    readonly requestsHash?: Uint8Array;
+    readonly blockAccessListHash?: Uint8Array;
+    readonly slotNumber?: bigint;
+    readonly common: Common;
+    protected keccakFunction: (msg: Uint8Array) => Uint8Array;
+    protected cache: HeaderCache;
+    /**
+     * EIP-4399: After merge to PoS, `mixHash` supplanted as `prevRandao`
+     */
+    get prevRandao(): Uint8Array<ArrayBufferLike>;
+    /**
+     * This constructor takes the values, validates them, assigns them and freezes the object.
+     *
+     * @deprecated Use the public static factory methods to assist in creating a Header object from
+     * varying data types. For a default empty header, use {@link createBlockHeader}.
+     *
+     */
+    constructor(headerData: HeaderData, opts?: BlockOptions);
+    /**
+     * Validates correct buffer lengths, throws if invalid.
+     */
+    protected _genericFormatValidation(): void;
+    /**
+     * Checks static parameters related to consensus algorithm
+     * @throws if any check fails
+     */
+    protected _consensusFormatValidation(): void;
+    /**
+     * Validates if the block gasLimit remains in the boundaries set by the protocol.
+     * Throws if out of bounds.
+     *
+     * @param parentBlockHeader - the header from the parent `Block` of this header
+     */
+    validateGasLimit(parentBlockHeader: BlockHeader): void;
+    /**
+     * Calculates the base fee for a potential next block
+     */
+    calcNextBaseFee(): bigint;
+    /**
+     * Returns the price per unit of blob gas for a blob transaction in the current/pending block
+     * @returns the price in gwei per unit of blob gas spent
+     */
+    getBlobGasPrice(): bigint;
+    /**
+     * Returns the total fee for blob gas spent for including blobs in block.
+     *
+     * @param numBlobs number of blobs in the transaction/block
+     * @returns the total blob gas fee for numBlobs blobs
+     */
+    calcDataFee(numBlobs: number): bigint;
+    /**
+     * Calculates the excess blob gas for next (hopefully) post EIP 4844 block.
+     */
+    calcNextExcessBlobGas(childCommon: Common): bigint;
+    /**
+     * Calculate the blob gas price of the block built on top of this one
+     * @returns The blob gas price
+     */
+    calcNextBlobGasPrice(childCommon: Common): bigint;
+    /**
+     * Returns a Uint8Array Array of the raw Bytes in this header, in order.
+     */
+    raw(): BlockHeaderBytes;
+    /**
+     * Returns the hash of the block header.
+     */
+    hash(): Uint8Array;
+    /**
+     * Checks if the block header is a genesis header.
+     */
+    isGenesis(): boolean;
+    /**
+     * Returns the canonical difficulty for this block.
+     *
+     * @param parentBlockHeader - the header from the parent `Block` of this header
+     */
+    ethashCanonicalDifficulty(parentBlockHeader: BlockHeader): bigint;
+    /**
+     * Returns the rlp encoding of the block header.
+     */
+    serialize(): Uint8Array;
+    /**
+     * Returns the block header in JSON format.
+     */
+    toJSON(): JSONHeader;
+    /**
+     * Validates extra data is DAO_ExtraData for DAO_ForceExtraDataRange blocks after DAO
+     * activation block (see: https://blog.slock.it/hard-fork-specification-24b889e70703)
+     */
+    protected _validateDAOExtraData(): void;
+    /**
+     * Return a compact error string representation of the object
+     */
+    errorStr(): string;
+    /**
+     * Helper function to create an annotated error message
+     *
+     * @param msg Base error message
+     * @hidden
+     */
+    protected _errorMsg(msg: string): string;
+}
+export {};
+//# sourceMappingURL=header.d.ts.map

package/dist/cjs/header/header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../../src/header/header.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAwD,MAAM,oBAAoB,CAAA;AAEjG,OAAO,EACL,OAAO,EAkBR,MAAM,kBAAkB,CAAA;AAWzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEzF,UAAU,WAAW;IACnB,IAAI,EAAE,UAAU,GAAG,SAAS,CAAA;CAC7B;AAID;;GAEG;AACH,qBAAa,WAAW;IACtB,SAAgB,UAAU,EAAE,UAAU,CAAA;IACtC,SAAgB,SAAS,EAAE,UAAU,CAAA;IACrC,SAAgB,QAAQ,EAAE,OAAO,CAAA;IACjC,SAAgB,SAAS,EAAE,UAAU,CAAA;IACrC,SAAgB,gBAAgB,EAAE,UAAU,CAAA;IAC5C,SAAgB,WAAW,EAAE,UAAU,CAAA;IACvC,SAAgB,SAAS,EAAE,UAAU,CAAA;IACrC,SAAgB,UAAU,EAAE,MAAM,CAAA;IAClC,SAAgB,MAAM,EAAE,MAAM,CAAA;IAC9B,SAAgB,QAAQ,EAAE,MAAM,CAAA;IAChC,SAAgB,OAAO,EAAE,MAAM,CAAA;IAC/B,SAAgB,SAAS,EAAE,MAAM,CAAA;IACjC,SAAgB,SAAS,EAAE,UAAU,CAAA;IACrC,SAAgB,OAAO,EAAE,UAAU,CAAA;IACnC,SAAgB,KAAK,EAAE,UAAU,CAAA;IACjC,SAAgB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtC,SAAgB,eAAe,CAAC,EAAE,UAAU,CAAA;IAC5C,SAAgB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpC,SAAgB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtC,SAAgB,qBAAqB,CAAC,EAAE,UAAU,CAAA;IAClD,SAAgB,YAAY,CAAC,EAAE,UAAU,CAAA;IACzC,SAAgB,mBAAmB,CAAC,EAAE,UAAU,CAAA;IAChD,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnC,SAAgB,MAAM,EAAE,MAAM,CAAA;IAE9B,SAAS,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,UAAU,CAAA;IAEzD,SAAS,CAAC,KAAK,EAAE,WAAW,CAE3B;IAED;;OAEG;IACH,IAAI,UAAU,gCAQb;IAED;;;;;;OAMG;gBACS,UAAU,EAAE,UAAU,EAAE,IAAI,GAAE,YAAiB;IA4L3D;;OAEG;IACH,SAAS,CAAC,wBAAwB;IAqHlC;;;OAGG;IACH,SAAS,CAAC,0BAA0B;IAgFpC;;;;;OAKG;IACH,gBAAgB,CAAC,iBAAiB,EAAE,WAAW;IA2C/C;;OAEG;IACI,eAAe,IAAI,MAAM;IAkChC;;;OAGG;IACH,eAAe,IAAI,MAAM;IAOzB;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQrC;;OAEG;IACI,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IA6BzD;;;OAGG;IACI,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAIxD;;OAEG;IACH,GAAG,IAAI,gBAAgB;IA+CvB;;OAEG;IACH,IAAI,IAAI,UAAU;IAQlB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACH,yBAAyB,CAAC,iBAAiB,EAAE,WAAW,GAAG,MAAM;IAoEjE;;OAEG;IACH,SAAS,IAAI,UAAU;IAIvB;;OAEG;IACH,MAAM,IAAI,UAAU;IA4CpB;;;OAGG;IACH,SAAS,CAAC,qBAAqB;IAqB/B;;OAEG;IACI,QAAQ;IAkBf;;;;;OAKG;IACH,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM;CAGhC"}