@feelyourprotocol/block 8141.0.0

package/dist/esm/block/constructors.js

@@ -0,0 +1,286 @@
+import { MerklePatriciaTrie } from '@feelyourprotocol/mpt';
+import { RLP } from '@feelyourprotocol/rlp';
+import { createTx, createTxFromBlockBodyData, createTxFromRLP, normalizeTxParams, } from '@feelyourprotocol/tx';
+import { EthereumJSErrorWithoutCode, bigIntToHex, bytesToHex, createWithdrawal, equalsBytes, fetchFromProvider, getProvider, hexToBytes, intToHex, isHexString, } from '@feelyourprotocol/util';
+import { generateCliqueBlockExtraData } from "../consensus/clique.js";
+import { genTransactionsTrieRoot, genWithdrawalsTrieRoot } from "../helpers.js";
+import { Block, createBlockHeader, createBlockHeaderFromBytesArray, createBlockHeaderFromRPC, executionPayloadFromBeaconPayload, } from "../index.js";
+/**
+ * Static constructor to create a block from a block data dictionary
+ *
+ * @param blockData
+ * @param opts
+ * @returns a new {@link Block} object
+ */
+export function createBlock(blockData = {}, opts) {
+    const { header: headerData, transactions: txsData, uncleHeaders: uhsData, withdrawals: withdrawalsData, } = blockData;
+    const header = createBlockHeader(headerData, opts);
+    // parse transactions
+    const transactions = [];
+    for (const txData of txsData ?? []) {
+        const tx = createTx(txData, {
+            ...opts,
+            // Use header common in case of setHardfork being activated
+            common: header.common,
+        });
+        transactions.push(tx);
+    }
+    // parse uncle headers
+    const uncleHeaders = [];
+    const uncleOpts = {
+        ...opts,
+        // Use header common in case of setHardfork being activated
+        common: header.common,
+        // Disable this option here (all other options carried over), since this overwrites the provided Difficulty to an incorrect value
+        calcDifficultyFromHeader: undefined,
+    };
+    // Uncles are obsolete post-merge, any hardfork by option implies setHardfork
+    if (opts?.setHardfork !== undefined) {
+        uncleOpts.setHardfork = true;
+    }
+    for (const uhData of uhsData ?? []) {
+        const uh = createBlockHeader(uhData, uncleOpts);
+        uncleHeaders.push(uh);
+    }
+    const withdrawals = withdrawalsData?.map(createWithdrawal);
+    return new Block(header, transactions, uncleHeaders, withdrawals, opts);
+}
+/**
+ * Simple static constructor if only an empty block is needed
+ * (tree shaking advantages since it does not draw all the tx constructors in)
+ *
+ * @param headerData
+ * @param opts
+ * @returns a new {@link Block} object
+ */
+export function createEmptyBlock(headerData, opts) {
+    const header = createBlockHeader(headerData, opts);
+    return new Block(header);
+}
+/**
+ * Static constructor to create a block from an array of Bytes values
+ *
+ * @param values
+ * @param opts
+ * @returns a new {@link Block} object
+ */
+export function createBlockFromBytesArray(values, opts) {
+    if (values.length > 5) {
+        throw EthereumJSErrorWithoutCode(`invalid  More values=${values.length} than expected were received (at most 5)`);
+    }
+    // First try to load header so that we can use its common (in case of setHardfork being activated)
+    // to correctly make checks on the hardforks
+    const [headerData, txsData, uhsData, ...valuesTail] = values;
+    const header = createBlockHeaderFromBytesArray(headerData, opts);
+    // conditional assignment of rest of values and splicing them out from the valuesTail
+    const withdrawalBytes = header.common.isActivatedEIP(4895)
+        ? valuesTail.splice(0, 1)[0]
+        : undefined;
+    if (header.common.isActivatedEIP(4895) &&
+        (withdrawalBytes === undefined || !Array.isArray(withdrawalBytes))) {
+        throw EthereumJSErrorWithoutCode('Invalid serialized block input: EIP-4895 is active, and no withdrawals were provided as array');
+    }
+    // parse transactions
+    const transactions = [];
+    for (const txData of txsData ?? []) {
+        transactions.push(createTxFromBlockBodyData(txData, {
+            ...opts,
+            // Use header common in case of setHardfork being activated
+            common: header.common,
+        }));
+    }
+    // parse uncle headers
+    const uncleHeaders = [];
+    const uncleOpts = {
+        ...opts,
+        // Use header common in case of setHardfork being activated
+        common: header.common,
+        // Disable this option here (all other options carried over), since this overwrites the provided Difficulty to an incorrect value
+        calcDifficultyFromHeader: undefined,
+    };
+    // Uncles are obsolete post-merge, any hardfork by option implies setHardfork
+    if (opts?.setHardfork !== undefined) {
+        uncleOpts.setHardfork = true;
+    }
+    for (const uncleHeaderData of uhsData ?? []) {
+        uncleHeaders.push(createBlockHeaderFromBytesArray(uncleHeaderData, uncleOpts));
+    }
+    const withdrawals = withdrawalBytes
+        ?.map(([index, validatorIndex, address, amount]) => ({
+        index,
+        validatorIndex,
+        address,
+        amount,
+    }))
+        ?.map(createWithdrawal);
+    return new Block(header, transactions, uncleHeaders, withdrawals, opts);
+}
+/**
+ * Static constructor to create a block from a RLP-serialized block
+ *
+ * @param serialized
+ * @param opts
+ * @returns a new {@link Block} object
+ */
+export function createBlockFromRLP(serialized, opts) {
+    if (opts?.common?.isActivatedEIP(7934) === true) {
+        const maxRlpBlockSize = opts.common.param('maxRlpBlockSize');
+        if (serialized.length > maxRlpBlockSize) {
+            throw EthereumJSErrorWithoutCode(`Block size exceeds limit: ${serialized.length} > ${maxRlpBlockSize}`);
+        }
+    }
+    const values = RLP.decode(Uint8Array.from(serialized));
+    if (!Array.isArray(values)) {
+        throw EthereumJSErrorWithoutCode('Invalid serialized block input. Must be array');
+    }
+    return createBlockFromBytesArray(values, opts);
+}
+/**
+ * Creates a new block object from Ethereum JSON RPC.
+ *
+ * @param blockParams - Ethereum JSON RPC of block (eth_getBlockByNumber)
+ * @param uncles - Optional list of Ethereum JSON RPC of uncles (eth_getUncleByBlockHashAndIndex)
+ * @param opts - An object describing the blockchain
+ * @returns a new {@link Block} object
+ */
+export function createBlockFromRPC(blockParams, uncles = [], options) {
+    const header = createBlockHeaderFromRPC(blockParams, options);
+    const transactions = [];
+    const opts = { common: header.common };
+    for (const _txParams of blockParams.transactions ?? []) {
+        const txParams = normalizeTxParams(_txParams);
+        const tx = createTx(txParams, opts);
+        transactions.push(tx);
+    }
+    const uncleHeaders = uncles.map((uh) => createBlockHeaderFromRPC(uh, options));
+    return createBlock({ header, transactions, uncleHeaders, withdrawals: blockParams.withdrawals }, options);
+}
+/**
+ *  Method to retrieve a block from a JSON-RPC provider and format as a {@link Block}
+ * @param provider either a url for a remote provider or an Ethers JSONRPCProvider object
+ * @param blockTag block hash or block number to be run
+ * @param opts {@link BlockOptions}
+ * @returns a new {@link Block} object specified by `blockTag`
+ */
+export const createBlockFromJSONRPCProvider = async (provider, blockTag, opts) => {
+    let blockData;
+    const providerUrl = getProvider(provider);
+    if (typeof blockTag === 'string' && blockTag.length === 66) {
+        blockData = await fetchFromProvider(providerUrl, {
+            method: 'eth_getBlockByHash',
+            params: [blockTag, true],
+        });
+    }
+    else if (typeof blockTag === 'bigint') {
+        blockData = await fetchFromProvider(providerUrl, {
+            method: 'eth_getBlockByNumber',
+            params: [bigIntToHex(blockTag), true],
+        });
+    }
+    else if (isHexString(blockTag) ||
+        blockTag === 'latest' ||
+        blockTag === 'earliest' ||
+        blockTag === 'pending' ||
+        blockTag === 'finalized' ||
+        blockTag === 'safe') {
+        blockData = await fetchFromProvider(providerUrl, {
+            method: 'eth_getBlockByNumber',
+            params: [blockTag, true],
+        });
+    }
+    else {
+        throw EthereumJSErrorWithoutCode(`expected blockTag to be block hash, bigint, hex prefixed string, or earliest/latest/pending; got ${blockTag}`);
+    }
+    if (blockData === null) {
+        throw EthereumJSErrorWithoutCode('No block data returned from provider');
+    }
+    const uncleHeaders = [];
+    if (blockData.uncles.length > 0) {
+        for (let x = 0; x < blockData.uncles.length; x++) {
+            const headerData = await fetchFromProvider(providerUrl, {
+                method: 'eth_getUncleByBlockHashAndIndex',
+                params: [blockData.hash, intToHex(x)],
+            });
+            uncleHeaders.push(headerData);
+        }
+    }
+    return createBlockFromRPC(blockData, uncleHeaders, opts);
+};
+/**
+ *  Method to retrieve a block from an execution payload
+ * @param payload Execution payload constructed from beacon payload data
+ * @param opts {@link BlockOptions}
+ * @returns The constructed {@link Block} object
+ */
+export async function createBlockFromExecutionPayload(payload, opts) {
+    const { blockNumber: number, receiptsRoot: receiptTrie, prevRandao: mixHash, feeRecipient: coinbase, transactions, withdrawals: withdrawalsData, } = payload;
+    const txs = [];
+    for (const [index, serializedTx] of transactions.entries()) {
+        try {
+            const tx = createTxFromRLP(hexToBytes(serializedTx), {
+                common: opts?.common,
+            });
+            txs.push(tx);
+        }
+        catch (error) {
+            const validationError = `Invalid tx at index ${index}: ${error}`;
+            throw validationError;
+        }
+    }
+    const transactionsTrie = await genTransactionsTrieRoot(txs, new MerklePatriciaTrie({ common: opts?.common }));
+    const withdrawals = withdrawalsData?.map((wData) => createWithdrawal(wData));
+    const withdrawalsRoot = withdrawals
+        ? await genWithdrawalsTrieRoot(withdrawals, new MerklePatriciaTrie({ common: opts?.common }))
+        : undefined;
+    const header = {
+        ...payload,
+        number,
+        receiptTrie,
+        transactionsTrie,
+        withdrawalsRoot,
+        mixHash,
+        coinbase,
+    };
+    // we are not setting setHardfork as common is already set to the correct hf
+    const block = createBlock({ header, transactions: txs, withdrawals }, opts);
+    // Verify blockHash matches payload
+    if (!equalsBytes(block.hash(), hexToBytes(payload.blockHash))) {
+        const validationError = `Invalid blockHash, expected: ${payload.blockHash}, received: ${bytesToHex(block.hash())}`;
+        throw Error(validationError);
+    }
+    return block;
+}
+/**
+ *  Method to retrieve a block from a beacon payload JSON
+ * @param payload JSON of a beacon block fetched from beacon APIs
+ * @param opts {@link BlockOptions}
+ * @returns The constructed {@link Block} object
+ */
+export async function createBlockFromBeaconPayloadJSON(payload, opts) {
+    const executionPayload = executionPayloadFromBeaconPayload(payload);
+    return createBlockFromExecutionPayload(executionPayload, opts);
+}
+/**
+ * Creates a block for Clique networks with the seal applied during instantiation.
+ * @param blockData Block fields used to build the block
+ * @param cliqueSigner Private key bytes used to sign the header
+ * @param opts {@link BlockOptions}
+ * @returns A sealed Clique {@link Block} object
+ */
+export function createSealedCliqueBlock(blockData = {}, cliqueSigner, opts = {}) {
+    const sealedCliqueBlock = createBlock(blockData, {
+        ...opts,
+        ...{ freeze: false, skipConsensusFormatValidation: true },
+    });
+    sealedCliqueBlock.header.extraData = generateCliqueBlockExtraData(sealedCliqueBlock.header, cliqueSigner);
+    if (opts?.freeze === true) {
+        // We have to freeze here since we can't freeze the block when constructing it since we are overwriting `extraData`
+        Object.freeze(sealedCliqueBlock);
+    }
+    if (opts?.skipConsensusFormatValidation === false) {
+        // We need to validate the consensus format here since we skipped it when constructing the block
+        sealedCliqueBlock.header['_consensusFormatValidation']();
+    }
+    return sealedCliqueBlock;
+}
+//# sourceMappingURL=constructors.js.map

package/dist/esm/block/constructors.js.map

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

package/dist/esm/block/index.d.ts

@@ -0,0 +1,3 @@
+export * from './block.ts';
+export * from './constructors.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/block/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/block/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA"}

package/dist/esm/block/index.js

@@ -0,0 +1,3 @@
+export * from "./block.js";
+export * from "./constructors.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/block/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/block/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA"}

package/dist/esm/consensus/clique.d.ts

@@ -0,0 +1,52 @@
+import { Address } from '@feelyourprotocol/util';
+import type { BlockHeader } from '../index.ts';
+export declare const CLIQUE_EXTRA_VANITY = 32;
+export declare const CLIQUE_EXTRA_SEAL = 65;
+export declare function requireClique(header: BlockHeader, name: string): void;
+/**
+ * PoA clique signature hash without the seal.
+ */
+export declare function cliqueSigHash(header: BlockHeader): Uint8Array<ArrayBufferLike>;
+/**
+ * Checks if the block header is an epoch transition
+ * header (only clique PoA, throws otherwise)
+ */
+export declare function cliqueIsEpochTransition(header: BlockHeader): boolean;
+/**
+ * Returns extra vanity data
+ * (only clique PoA, throws otherwise)
+ */
+export declare function cliqueExtraVanity(header: BlockHeader): Uint8Array;
+/**
+ * Returns extra seal data
+ * (only clique PoA, throws otherwise)
+ */
+export declare function cliqueExtraSeal(header: BlockHeader): Uint8Array;
+/**
+ * Returns a list of signers
+ * (only clique PoA, throws otherwise)
+ *
+ * This function throws if not called on an epoch
+ * transition block and should therefore be used
+ * in conjunction with {@link cliqueIsEpochTransition}
+ */
+export declare function cliqueEpochTransitionSigners(header: BlockHeader): Address[];
+/**
+ * Returns the signer address
+ */
+export declare function cliqueSigner(header: BlockHeader): Address;
+/**
+ * Verifies the signature of the block (last 65 bytes of extraData field)
+ * (only clique PoA, throws otherwise)
+ *
+ *  Method throws if signature is invalid
+ */
+export declare function cliqueVerifySignature(header: BlockHeader, signerList: Address[]): boolean;
+/**
+ * Generates the extraData from a sealed block header
+ * @param header block header from which to retrieve extraData
+ * @param cliqueSigner clique signer key used for creating sealed block
+ * @returns clique seal (i.e. extradata) for the block
+ */
+export declare function generateCliqueBlockExtraData(header: BlockHeader, cliqueSigner: Uint8Array): Uint8Array;
+//# sourceMappingURL=clique.d.ts.map

package/dist/esm/consensus/clique.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clique.d.ts","sourceRoot":"","sources":["../../../src/consensus/clique.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,OAAO,EAUR,MAAM,kBAAkB,CAAA;AAIzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAG9C,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAGnC,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,QAO9D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,+BAKhD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAMpE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAGjE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAG/D;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,EAAE,CAiB3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAYzD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAOzF;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,UAAU,GACvB,UAAU,CA4BZ"}

package/dist/esm/consensus/clique.js

@@ -0,0 +1,132 @@
+import { ConsensusAlgorithm } from '@feelyourprotocol/common';
+import { RLP } from '@feelyourprotocol/rlp';
+import { Address, BIGINT_0, BIGINT_27, EthereumJSErrorWithoutCode, bytesToBigInt, concatBytes, createAddressFromPublicKey, createZeroAddress, ecrecover, equalsBytes, } from '@feelyourprotocol/util';
+import { secp256k1 } from '@noble/curves/secp256k1.js';
+// Fixed number of extra-data prefix bytes reserved for signer vanity
+export const CLIQUE_EXTRA_VANITY = 32;
+// Fixed number of extra-data suffix bytes reserved for signer seal
+export const CLIQUE_EXTRA_SEAL = 65;
+// This function is not exported in the index file to keep it internal
+export function requireClique(header, name) {
+    if (header.common.consensusAlgorithm() !== ConsensusAlgorithm.Clique) {
+        const msg = header['_errorMsg'](`BlockHeader.${name}() call only supported for clique PoA networks`);
+        throw EthereumJSErrorWithoutCode(msg);
+    }
+}
+/**
+ * PoA clique signature hash without the seal.
+ */
+export function cliqueSigHash(header) {
+    requireClique(header, 'cliqueSigHash');
+    const raw = header.raw();
+    raw[12] = header.extraData.subarray(0, header.extraData.length - CLIQUE_EXTRA_SEAL);
+    return header['keccakFunction'](RLP.encode(raw));
+}
+/**
+ * Checks if the block header is an epoch transition
+ * header (only clique PoA, throws otherwise)
+ */
+export function cliqueIsEpochTransition(header) {
+    requireClique(header, 'cliqueIsEpochTransition');
+    const epoch = BigInt(header.common.consensusConfig().epoch);
+    // Epoch transition block if the block number has no
+    // remainder on the division by the epoch length
+    return header.number % epoch === BIGINT_0;
+}
+/**
+ * Returns extra vanity data
+ * (only clique PoA, throws otherwise)
+ */
+export function cliqueExtraVanity(header) {
+    requireClique(header, 'cliqueExtraVanity');
+    return header.extraData.subarray(0, CLIQUE_EXTRA_VANITY);
+}
+/**
+ * Returns extra seal data
+ * (only clique PoA, throws otherwise)
+ */
+export function cliqueExtraSeal(header) {
+    requireClique(header, 'cliqueExtraSeal');
+    return header.extraData.subarray(-CLIQUE_EXTRA_SEAL);
+}
+/**
+ * Returns a list of signers
+ * (only clique PoA, throws otherwise)
+ *
+ * This function throws if not called on an epoch
+ * transition block and should therefore be used
+ * in conjunction with {@link cliqueIsEpochTransition}
+ */
+export function cliqueEpochTransitionSigners(header) {
+    requireClique(header, 'cliqueEpochTransitionSigners');
+    if (!cliqueIsEpochTransition(header)) {
+        const msg = header['_errorMsg']('Signers are only included in epoch transition blocks (clique)');
+        throw EthereumJSErrorWithoutCode(msg);
+    }
+    const start = CLIQUE_EXTRA_VANITY;
+    const end = header.extraData.length - CLIQUE_EXTRA_SEAL;
+    const signerBytes = header.extraData.subarray(start, end);
+    const signerList = [];
+    const signerLength = 20;
+    for (let start = 0; start <= signerBytes.length - signerLength; start += signerLength) {
+        signerList.push(signerBytes.subarray(start, start + signerLength));
+    }
+    return signerList.map((buf) => new Address(buf));
+}
+/**
+ * Returns the signer address
+ */
+export function cliqueSigner(header) {
+    requireClique(header, 'cliqueSigner');
+    const extraSeal = cliqueExtraSeal(header);
+    // Reasonable default for default blocks
+    if (extraSeal.length === 0 || equalsBytes(extraSeal, new Uint8Array(65))) {
+        return createZeroAddress();
+    }
+    const r = extraSeal.subarray(0, 32);
+    const s = extraSeal.subarray(32, 64);
+    const v = bytesToBigInt(extraSeal.subarray(64, 65)) + BIGINT_27;
+    const pubKey = ecrecover(cliqueSigHash(header), v, r, s);
+    return createAddressFromPublicKey(pubKey);
+}
+/**
+ * Verifies the signature of the block (last 65 bytes of extraData field)
+ * (only clique PoA, throws otherwise)
+ *
+ *  Method throws if signature is invalid
+ */
+export function cliqueVerifySignature(header, signerList) {
+    requireClique(header, 'cliqueVerifySignature');
+    const signerAddress = cliqueSigner(header);
+    const signerFound = signerList.find((signer) => {
+        return signer.equals(signerAddress);
+    });
+    return !!signerFound;
+}
+/**
+ * Generates the extraData from a sealed block header
+ * @param header block header from which to retrieve extraData
+ * @param cliqueSigner clique signer key used for creating sealed block
+ * @returns clique seal (i.e. extradata) for the block
+ */
+export function generateCliqueBlockExtraData(header, cliqueSigner) {
+    // Ensure extraData is at least length CLIQUE_EXTRA_VANITY + CLIQUE_EXTRA_SEAL
+    const minExtraDataLength = CLIQUE_EXTRA_VANITY + CLIQUE_EXTRA_SEAL;
+    if (header.extraData.length < minExtraDataLength) {
+        const remainingLength = minExtraDataLength - header.extraData.length;
+        header.extraData = concatBytes(header.extraData, new Uint8Array(remainingLength));
+    }
+    requireClique(header, 'generateCliqueBlockExtraData');
+    const msgHash = cliqueSigHash(header);
+    // Use custom ecsign if provided, otherwise use secp256k1.sign
+    const ecSignFunction = header.common.customCrypto?.ecsign ?? secp256k1.sign;
+    // Use noble/curves secp256k1.sign with recovered format (returns 65-byte Uint8Array)
+    // sigBytes format: [recovery (1 byte) | r (32 bytes) | s (32 bytes)]
+    const sigBytes = ecSignFunction(msgHash, cliqueSigner, { prehash: false, format: 'recovered' });
+    // clique format: [r (32 bytes) | s (32 bytes) | recovery (1 byte)]
+    const cliqueSignature = concatBytes(sigBytes.subarray(1), sigBytes.subarray(0, 1));
+    const extraDataWithoutSeal = header.extraData.subarray(0, header.extraData.length - CLIQUE_EXTRA_SEAL);
+    const extraData = concatBytes(extraDataWithoutSeal, cliqueSignature);
+    return extraData;
+}
+//# sourceMappingURL=clique.js.map

package/dist/esm/consensus/clique.js.map

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

package/dist/esm/consensus/ethash.d.ts

@@ -0,0 +1,9 @@
+import type { Block } from '../index.ts';
+/**
+ * Returns the canonical difficulty for this block.
+ *
+ * @param block - the block whose difficulty should be calculated
+ * @param parentBlock - the parent of this `Block`
+ */
+export declare function ethashCanonicalDifficulty(block: Block, parentBlock: Block): bigint;
+//# sourceMappingURL=ethash.d.ts.map

package/dist/esm/consensus/ethash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethash.d.ts","sourceRoot":"","sources":["../../../src/consensus/ethash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,GAAG,MAAM,CAElF"}

package/dist/esm/consensus/ethash.js

@@ -0,0 +1,10 @@
+/**
+ * Returns the canonical difficulty for this block.
+ *
+ * @param block - the block whose difficulty should be calculated
+ * @param parentBlock - the parent of this `Block`
+ */
+export function ethashCanonicalDifficulty(block, parentBlock) {
+    return block.header.ethashCanonicalDifficulty(parentBlock.header);
+}
+//# sourceMappingURL=ethash.js.map

package/dist/esm/consensus/ethash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethash.js","sourceRoot":"","sources":["../../../src/consensus/ethash.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAY,EAAE,WAAkB;IACxE,OAAO,KAAK,CAAC,MAAM,CAAC,yBAAyB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;AACnE,CAAC"}

package/dist/esm/consensus/index.d.ts

@@ -0,0 +1,3 @@
+export { CLIQUE_EXTRA_SEAL, CLIQUE_EXTRA_VANITY, cliqueEpochTransitionSigners, cliqueExtraSeal, cliqueExtraVanity, cliqueIsEpochTransition, cliqueSigHash, cliqueSigner, cliqueVerifySignature, } from './clique.ts';
+export * from './ethash.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/consensus/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/consensus/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,EAC5B,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,YAAY,EACZ,qBAAqB,GACtB,MAAM,aAAa,CAAA;AACpB,cAAc,aAAa,CAAA"}

package/dist/esm/consensus/index.js

@@ -0,0 +1,3 @@
+export { CLIQUE_EXTRA_SEAL, CLIQUE_EXTRA_VANITY, cliqueEpochTransitionSigners, cliqueExtraSeal, cliqueExtraVanity, cliqueIsEpochTransition, cliqueSigHash, cliqueSigner, cliqueVerifySignature, } from "./clique.js";
+export * from "./ethash.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/consensus/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/consensus/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,EAC5B,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,YAAY,EACZ,qBAAqB,GACtB,MAAM,aAAa,CAAA;AACpB,cAAc,aAAa,CAAA"}

package/dist/esm/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/esm/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/esm/from-beacon-payload.js

@@ -0,0 +1,45 @@
+import { bigIntToHex } from '@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]`
+ */
+export 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: bigIntToHex(BigInt(payload.block_number)),
+        gasLimit: bigIntToHex(BigInt(payload.gas_limit)),
+        gasUsed: bigIntToHex(BigInt(payload.gas_used)),
+        timestamp: bigIntToHex(BigInt(payload.timestamp)),
+        extraData: payload.extra_data,
+        baseFeePerGas: 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: bigIntToHex(BigInt(wd.index)),
+            validatorIndex: bigIntToHex(BigInt(wd.validator_index)),
+            address: wd.address,
+            amount: bigIntToHex(BigInt(wd.amount)),
+        }));
+    }
+    if (payload.blob_gas_used !== undefined && payload.blob_gas_used !== null) {
+        executionPayload.blobGasUsed = bigIntToHex(BigInt(payload.blob_gas_used));
+    }
+    if (payload.excess_blob_gas !== undefined && payload.excess_blob_gas !== null) {
+        executionPayload.excessBlobGas = 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