@feelyourprotocol/vm 8141.0.0

package/dist/cjs/bloom/index.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Bloom = void 0;
+const util_1 = require("@feelyourprotocol/util");
+const sha3_js_1 = require("@noble/hashes/sha3.js");
+const BYTE_SIZE = 256;
+class Bloom {
+    /**
+     * Represents a Bloom filter.
+     */
+    constructor(bitvector, common) {
+        if (common?.customCrypto.keccak256 !== undefined) {
+            this.keccakFunction = common.customCrypto.keccak256;
+        }
+        else {
+            this.keccakFunction = sha3_js_1.keccak_256;
+        }
+        if (!bitvector) {
+            this.bitvector = new Uint8Array(BYTE_SIZE);
+        }
+        else {
+            if (bitvector.length !== BYTE_SIZE)
+                throw (0, util_1.EthereumJSErrorWithoutCode)('bitvectors must be 2048 bits long');
+            this.bitvector = bitvector;
+        }
+    }
+    /**
+     * Adds an element to a bit vector of a 64 byte bloom filter.
+     * @param e - The element to add
+     */
+    add(e) {
+        e = this.keccakFunction(e);
+        const mask = 2047; // binary 11111111111
+        for (let i = 0; i < 3; i++) {
+            const first2bytes = new DataView(e.buffer).getUint16(i * 2);
+            const loc = mask & first2bytes;
+            const byteLoc = loc >> 3;
+            const bitLoc = 1 << (loc % 8);
+            this.bitvector[BYTE_SIZE - byteLoc - 1] |= bitLoc;
+        }
+    }
+    /**
+     * Checks if an element is in the bloom.
+     * @param e - The element to check
+     */
+    check(e) {
+        e = this.keccakFunction(e);
+        const mask = 2047; // binary 11111111111
+        let match = true;
+        for (let i = 0; i < 3 && match; i++) {
+            const first2bytes = new DataView(e.buffer).getUint16(i * 2);
+            const loc = mask & first2bytes;
+            const byteLoc = loc >> 3;
+            const bitLoc = 1 << (loc % 8);
+            match = (this.bitvector[BYTE_SIZE - byteLoc - 1] & bitLoc) !== 0;
+        }
+        return Boolean(match);
+    }
+    /**
+     * Checks if multiple topics are in a bloom.
+     * @returns `true` if every topic is in the bloom
+     */
+    multiCheck(topics) {
+        return topics.every((t) => this.check(t));
+    }
+    /**
+     * Bitwise or blooms together.
+     */
+    or(bloom) {
+        for (let i = 0; i <= BYTE_SIZE; i++) {
+            this.bitvector[i] = this.bitvector[i] | bloom.bitvector[i];
+        }
+    }
+}
+exports.Bloom = Bloom;
+//# sourceMappingURL=index.js.map

package/dist/cjs/bloom/index.js.map

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

package/dist/cjs/buildBlock.d.ts

@@ -0,0 +1,118 @@
+import type { Block } from '@feelyourprotocol/block';
+import type { TypedTransaction } from '@feelyourprotocol/tx';
+import type { BuildBlockOpts, RunTxResult, SealBlockOpts } from './types.ts';
+import type { VM } from './vm.ts';
+export type BuildStatus = (typeof BuildStatus)[keyof typeof BuildStatus];
+export declare const BuildStatus: {
+    readonly Reverted: "reverted";
+    readonly Build: "build";
+    readonly Pending: "pending";
+};
+type BlockStatus = {
+    status: typeof BuildStatus.Pending | typeof BuildStatus.Reverted;
+} | {
+    status: typeof BuildStatus.Build;
+    block: Block;
+};
+export declare class BlockBuilder {
+    /**
+     * The cumulative gas used by the transactions added to the block.
+     */
+    gasUsed: bigint;
+    /**
+     *  The cumulative blob gas used by the blobs in a block
+     */
+    blobGasUsed: bigint;
+    /**
+     * Value of the block, represented by the final transaction fees
+     * accruing to the miner.
+     */
+    private _minerValue;
+    private readonly vm;
+    private blockOpts;
+    private headerData;
+    private transactions;
+    private transactionResults;
+    private withdrawals?;
+    private checkpointed;
+    private blockStatus;
+    get transactionReceipts(): import("./types.ts").TxReceipt[];
+    get minerValue(): bigint;
+    constructor(vm: VM, opts: BuildBlockOpts);
+    /**
+     * Throws if the block has already been built or reverted.
+     */
+    private checkStatus;
+    getStatus(): BlockStatus;
+    /**
+     * Calculates and returns the transactionsTrie for the block.
+     */
+    transactionsTrie(): Promise<Uint8Array<ArrayBufferLike>>;
+    /**
+     * Calculates and returns the logs bloom for the block.
+     */
+    logsBloom(): Uint8Array<ArrayBufferLike>;
+    /**
+     * Calculates and returns the receiptTrie for the block.
+     */
+    receiptTrie(): Promise<Uint8Array<ArrayBufferLike>>;
+    /**
+     * Adds the block miner reward to the coinbase account.
+     */
+    private rewardMiner;
+    /**
+     * Adds the withdrawal amount to the withdrawal address
+     */
+    private processWithdrawals;
+    /**
+     * Run and add a transaction to the block being built.
+     * Please note that this modifies the state of the VM.
+     * Throws if the transaction's gasLimit is greater than
+     * the remaining gas in the block.
+     */
+    addTransaction(tx: TypedTransaction, { skipHardForkValidation, allowNoBlobs, }?: {
+        skipHardForkValidation?: boolean;
+        allowNoBlobs?: boolean;
+    }): Promise<RunTxResult>;
+    /**
+     * Reverts the checkpoint on the StateManager to reset the state from any transactions that have been run.
+     */
+    revert(): Promise<void>;
+    /**
+     * This method constructs the finalized block, including withdrawals and any CLRequests.
+     * It also:
+     *  - Assigns the reward for miner (PoW)
+     *  - Commits the checkpoint on the StateManager
+     *  - Sets the tip of the VM's blockchain to this block
+     * For PoW, optionally seals the block with params `nonce` and `mixHash`,
+     * which is validated along with the block number and difficulty by ethash.
+     * For PoA, please pass `blockOption.cliqueSigner` into the buildBlock constructor,
+     * as the signer will be awarded the txs amount spent on gas as they are added.
+     *
+     * Note: we add CLRequests here because they can be generated at any time during the
+     * lifecycle of a pending block so need to be provided only when the block is finalized.
+     */
+    build(sealOpts?: SealBlockOpts): Promise<{
+        block: Block;
+        requests: import("@feelyourprotocol/util").CLRequest<import("@feelyourprotocol/util").CLRequestType>[] | undefined;
+    }>;
+    initState(): Promise<void>;
+}
+/**
+ * Build a block on top of the current state
+ * by adding one transaction at a time.
+ *
+ * Creates a checkpoint on the StateManager and modifies the state
+ * as transactions are run. The checkpoint is committed on {@link BlockBuilder.build}
+ * or discarded with {@link BlockBuilder.revert}.
+ *
+ * @param {VM} vm
+ * @param {BuildBlockOpts} opts
+ * @returns An instance of {@link BlockBuilder} with methods:
+ * - {@link BlockBuilder.addTransaction}
+ * - {@link BlockBuilder.build}
+ * - {@link BlockBuilder.revert}
+ */
+export declare function buildBlock(vm: VM, opts: BuildBlockOpts): Promise<BlockBuilder>;
+export {};
+//# sourceMappingURL=buildBlock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildBlock.d.ts","sourceRoot":"","sources":["../../src/buildBlock.ts"],"names":[],"mappings":"AA0CA,OAAO,KAAK,EAAE,KAAK,EAAc,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAe,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACzF,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAEjC,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAA;AACxE,eAAO,MAAM,WAAW;;;;CAId,CAAA;AAEV,KAAK,WAAW,GACZ;IAAE,MAAM,EAAE,OAAO,WAAW,CAAC,OAAO,GAAG,OAAO,WAAW,CAAC,QAAQ,CAAA;CAAE,GACpE;IAAE,MAAM,EAAE,OAAO,WAAW,CAAC,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA;AAEtD,qBAAa,YAAY;IACvB;;OAEG;IACH,OAAO,SAAW;IAClB;;OAEG;IACH,WAAW,SAAW;IACtB;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAW;IAE9B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAI;IACvB,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,kBAAkB,CAAoB;IAC9C,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,WAAW,CAA+C;IAElE,IAAI,mBAAmB,qCAEtB;IAED,IAAI,UAAU,WAEb;gBAEW,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc;IAwCxC;;OAEG;IACH,OAAO,CAAC,WAAW;IASZ,SAAS,IAAI,WAAW;IAI/B;;OAEG;IACU,gBAAgB;IAO7B;;OAEG;IACI,SAAS;IAShB;;OAEG;IACU,WAAW;IAaxB;;OAEG;YACW,WAAW;IAUzB;;OAEG;YACW,kBAAkB;IAchC;;;;;OAKG;IACG,cAAc,CAClB,EAAE,EAAE,gBAAgB,EACpB,EACE,sBAAsB,EACtB,YAAY,GACb,GAAE;QAAE,sBAAsB,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAO;IAoFtE;;OAEG;IACG,MAAM;IAQZ;;;;;;;;;;;;;OAaG;IACG,KAAK,CAAC,QAAQ,CAAC,EAAE,aAAa;;;;IAoF9B,SAAS;CA6BhB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAIpF"}

package/dist/cjs/buildBlock.js

@@ -0,0 +1,363 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockBuilder = exports.BuildStatus = void 0;
+exports.buildBlock = buildBlock;
+const block_1 = require("@feelyourprotocol/block");
+const common_1 = require("@feelyourprotocol/common");
+const mpt_1 = require("@feelyourprotocol/mpt");
+const rlp_1 = require("@feelyourprotocol/rlp");
+const tx_1 = require("@feelyourprotocol/tx");
+const util_1 = require("@feelyourprotocol/util");
+const sha2_js_1 = require("@noble/hashes/sha2.js");
+const index_ts_1 = require("./bloom/index.js");
+const index_ts_2 = require("./index.js");
+const requests_ts_1 = require("./requests.js");
+const runBlock_ts_1 = require("./runBlock.js");
+exports.BuildStatus = {
+    Reverted: 'reverted',
+    Build: 'build',
+    Pending: 'pending',
+};
+class BlockBuilder {
+    get transactionReceipts() {
+        return this.transactionResults.map((result) => result.receipt);
+    }
+    get minerValue() {
+        return this._minerValue;
+    }
+    constructor(vm, opts) {
+        /**
+         * The cumulative gas used by the transactions added to the block.
+         */
+        this.gasUsed = util_1.BIGINT_0;
+        /**
+         *  The cumulative blob gas used by the blobs in a block
+         */
+        this.blobGasUsed = util_1.BIGINT_0;
+        /**
+         * Value of the block, represented by the final transaction fees
+         * accruing to the miner.
+         */
+        this._minerValue = util_1.BIGINT_0;
+        this.transactions = [];
+        this.transactionResults = [];
+        this.checkpointed = false;
+        this.blockStatus = { status: exports.BuildStatus.Pending };
+        this.vm = vm;
+        this.blockOpts = { putBlockIntoBlockchain: true, ...opts.blockOpts, common: this.vm.common };
+        this.headerData = {
+            ...opts.headerData,
+            parentHash: opts.headerData?.parentHash ?? opts.parentBlock.hash(),
+            number: opts.headerData?.number ?? opts.parentBlock.header.number + util_1.BIGINT_1,
+            gasLimit: opts.headerData?.gasLimit ?? opts.parentBlock.header.gasLimit,
+            timestamp: opts.headerData?.timestamp ?? Math.round(Date.now() / 1000),
+        };
+        this.withdrawals = opts.withdrawals?.map(util_1.createWithdrawal);
+        if (this.vm.common.isActivatedEIP(1559) &&
+            typeof this.headerData.baseFeePerGas === 'undefined') {
+            if (this.headerData.number === vm.common.hardforkBlock(common_1.Hardfork.London)) {
+                this.headerData.baseFeePerGas = vm.common.param('initialBaseFee');
+            }
+            else {
+                this.headerData.baseFeePerGas = opts.parentBlock.header.calcNextBaseFee();
+            }
+        }
+        if (typeof this.headerData.gasLimit === 'undefined') {
+            if (this.headerData.number === vm.common.hardforkBlock(common_1.Hardfork.London)) {
+                this.headerData.gasLimit = opts.parentBlock.header.gasLimit * util_1.BIGINT_2;
+            }
+            else {
+                this.headerData.gasLimit = opts.parentBlock.header.gasLimit;
+            }
+        }
+        if (this.vm.common.isActivatedEIP(4844) &&
+            typeof this.headerData.excessBlobGas === 'undefined') {
+            this.headerData.excessBlobGas = opts.parentBlock.header.calcNextExcessBlobGas(this.vm.common);
+        }
+    }
+    /**
+     * Throws if the block has already been built or reverted.
+     */
+    checkStatus() {
+        if (this.blockStatus.status === exports.BuildStatus.Build) {
+            throw (0, util_1.EthereumJSErrorWithoutCode)('Block has already been built');
+        }
+        if (this.blockStatus.status === exports.BuildStatus.Reverted) {
+            throw (0, util_1.EthereumJSErrorWithoutCode)('State has already been reverted');
+        }
+    }
+    getStatus() {
+        return this.blockStatus;
+    }
+    /**
+     * Calculates and returns the transactionsTrie for the block.
+     */
+    async transactionsTrie() {
+        return (0, block_1.genTransactionsTrieRoot)(this.transactions, new mpt_1.MerklePatriciaTrie({ common: this.vm.common }));
+    }
+    /**
+     * Calculates and returns the logs bloom for the block.
+     */
+    logsBloom() {
+        const bloom = new index_ts_1.Bloom(undefined, this.vm.common);
+        for (const txResult of this.transactionResults) {
+            // Combine blooms via bitwise OR
+            bloom.or(txResult.bloom);
+        }
+        return bloom.bitvector;
+    }
+    /**
+     * Calculates and returns the receiptTrie for the block.
+     */
+    async receiptTrie() {
+        if (this.transactionResults.length === 0) {
+            return util_1.KECCAK256_RLP;
+        }
+        const receiptTrie = new mpt_1.MerklePatriciaTrie({ common: this.vm.common });
+        for (const [i, txResult] of this.transactionResults.entries()) {
+            const tx = this.transactions[i];
+            const encodedReceipt = (0, runBlock_ts_1.encodeReceipt)(txResult.receipt, tx.type);
+            await receiptTrie.put(rlp_1.RLP.encode(i), encodedReceipt);
+        }
+        return receiptTrie.root();
+    }
+    /**
+     * Adds the block miner reward to the coinbase account.
+     */
+    async rewardMiner() {
+        const minerReward = this.vm.common.param('minerReward');
+        const reward = (0, runBlock_ts_1.calculateMinerReward)(minerReward, 0);
+        const coinbase = this.headerData.coinbase !== undefined
+            ? new util_1.Address((0, util_1.toBytes)(this.headerData.coinbase))
+            : (0, util_1.createZeroAddress)();
+        await (0, runBlock_ts_1.rewardAccount)(this.vm.evm, coinbase, reward, this.vm.common);
+    }
+    /**
+     * Adds the withdrawal amount to the withdrawal address
+     */
+    async processWithdrawals() {
+        for (const withdrawal of this.withdrawals ?? []) {
+            const { address, amount } = withdrawal;
+            // If there is no amount to add, skip touching the account
+            // as per the implementation of other clients geth/nethermind
+            // although this should never happen as no withdrawals with 0
+            // amount should ever land up here.
+            if (amount === util_1.BIGINT_0)
+                continue;
+            // Withdrawal amount is represented in Gwei so needs to be
+            // converted to wei
+            await (0, runBlock_ts_1.rewardAccount)(this.vm.evm, address, amount * util_1.GWEI_TO_WEI, this.vm.common);
+        }
+    }
+    /**
+     * Run and add a transaction to the block being built.
+     * Please note that this modifies the state of the VM.
+     * Throws if the transaction's gasLimit is greater than
+     * the remaining gas in the block.
+     */
+    async addTransaction(tx, { skipHardForkValidation, allowNoBlobs, } = {}) {
+        this.checkStatus();
+        if (!this.checkpointed) {
+            await this.vm.evm.journal.checkpoint();
+            this.checkpointed = true;
+        }
+        // According to the Yellow Paper, a transaction's gas limit
+        // cannot be greater than the remaining gas in the block
+        const blockGasLimit = (0, util_1.toType)(this.headerData.gasLimit, util_1.TypeOutput.BigInt);
+        const blobGasPerBlob = this.vm.common.param('blobGasPerBlob');
+        const blockGasRemaining = blockGasLimit - this.gasUsed;
+        if (tx.gasLimit > blockGasRemaining) {
+            throw (0, util_1.EthereumJSErrorWithoutCode)('tx has a higher gas limit than the remaining gas in the block');
+        }
+        let blobGasUsed = undefined;
+        if (tx instanceof tx_1.Blob4844Tx) {
+            const { maxBlobGasPerBlock: blobGasLimit } = this.vm.common.getBlobGasSchedule();
+            if (tx.networkWrapperVersion === tx_1.NetworkWrapperType.EIP4844 &&
+                this.vm.common.isActivatedEIP(7594)) {
+                throw Error('eip4844 blob transaction for eip7594 activated fork');
+            }
+            else if (tx.networkWrapperVersion === tx_1.NetworkWrapperType.EIP7594 &&
+                !this.vm.common.isActivatedEIP(7594)) {
+                throw Error('eip7594 blob transaction but eip not yet activated');
+            }
+            if (this.blockOpts.common?.isActivatedEIP(4844) === false) {
+                throw Error('eip4844 not activated yet for adding a blob transaction');
+            }
+            const blobTx = tx;
+            // Guard against the case if a tx came into the pool without blobs i.e. network wrapper payload
+            if (blobTx.blobs === undefined) {
+                // TODO: verify if we want this, do we want to allow the block builder to accept blob txs without the actual blobs?
+                // (these must have at least one `blobVersionedHashes`, this is verified at tx-level)
+                if (allowNoBlobs !== true) {
+                    throw (0, util_1.EthereumJSErrorWithoutCode)('blobs missing for 4844 transaction');
+                }
+            }
+            if (this.blobGasUsed + BigInt(blobTx.numBlobs()) * blobGasPerBlob > blobGasLimit) {
+                throw (0, util_1.EthereumJSErrorWithoutCode)('block blob gas limit reached');
+            }
+            blobGasUsed = this.blobGasUsed;
+        }
+        const header = {
+            ...this.headerData,
+            gasUsed: this.gasUsed,
+            // correct excessBlobGas should already part of headerData used above
+            blobGasUsed,
+        };
+        const blockData = { header, transactions: this.transactions };
+        const block = (0, block_1.createBlock)(blockData, this.blockOpts);
+        const result = await (0, index_ts_2.runTx)(this.vm, { tx, block, skipHardForkValidation });
+        // If tx is a blob transaction, remove blobs/kzg commitments before adding to block per EIP-4844
+        if (tx instanceof tx_1.Blob4844Tx) {
+            const txData = tx;
+            this.blobGasUsed += BigInt(txData.blobVersionedHashes.length) * blobGasPerBlob;
+            tx = (0, tx_1.createMinimal4844TxFromNetworkWrapper)(txData, {
+                common: this.blockOpts.common,
+            });
+        }
+        this.transactions.push(tx);
+        this.transactionResults.push(result);
+        this.gasUsed += result.totalGasSpent;
+        this._minerValue += result.minerValue;
+        return result;
+    }
+    /**
+     * Reverts the checkpoint on the StateManager to reset the state from any transactions that have been run.
+     */
+    async revert() {
+        if (this.checkpointed) {
+            await this.vm.evm.journal.revert();
+            this.checkpointed = false;
+        }
+        this.blockStatus = { status: exports.BuildStatus.Reverted };
+    }
+    /**
+     * This method constructs the finalized block, including withdrawals and any CLRequests.
+     * It also:
+     *  - Assigns the reward for miner (PoW)
+     *  - Commits the checkpoint on the StateManager
+     *  - Sets the tip of the VM's blockchain to this block
+     * For PoW, optionally seals the block with params `nonce` and `mixHash`,
+     * which is validated along with the block number and difficulty by ethash.
+     * For PoA, please pass `blockOption.cliqueSigner` into the buildBlock constructor,
+     * as the signer will be awarded the txs amount spent on gas as they are added.
+     *
+     * Note: we add CLRequests here because they can be generated at any time during the
+     * lifecycle of a pending block so need to be provided only when the block is finalized.
+     */
+    async build(sealOpts) {
+        this.checkStatus();
+        const blockOpts = this.blockOpts;
+        const consensusType = this.vm.common.consensusType();
+        if (consensusType === common_1.ConsensusType.ProofOfWork) {
+            await this.rewardMiner();
+        }
+        await this.processWithdrawals();
+        const transactionsTrie = await this.transactionsTrie();
+        const withdrawalsRoot = this.withdrawals
+            ? await (0, block_1.genWithdrawalsTrieRoot)(this.withdrawals, new mpt_1.MerklePatriciaTrie({ common: this.vm.common }))
+            : undefined;
+        const receiptTrie = await this.receiptTrie();
+        const logsBloom = this.logsBloom();
+        const gasUsed = this.gasUsed;
+        // timestamp should already be set in constructor
+        const timestamp = this.headerData.timestamp ?? util_1.BIGINT_0;
+        let blobGasUsed = undefined;
+        if (this.vm.common.isActivatedEIP(4844)) {
+            blobGasUsed = this.blobGasUsed;
+        }
+        let requests;
+        let requestsHash;
+        if (this.vm.common.isActivatedEIP(7685)) {
+            const sha256Function = this.vm.common.customCrypto.sha256 ?? sha2_js_1.sha256;
+            requests = await (0, requests_ts_1.accumulateRequests)(this.vm, this.transactionResults);
+            requestsHash = (0, block_1.genRequestsRoot)(requests, sha256Function);
+        }
+        // get stateRoot after all the accumulateRequests etc have been done
+        const stateRoot = await this.vm.stateManager.getStateRoot();
+        const headerData = {
+            ...this.headerData,
+            stateRoot,
+            transactionsTrie,
+            withdrawalsRoot,
+            receiptTrie,
+            logsBloom,
+            gasUsed,
+            timestamp,
+            // correct excessBlobGas should already be part of headerData used above
+            blobGasUsed,
+            requestsHash,
+        };
+        if (consensusType === common_1.ConsensusType.ProofOfWork) {
+            headerData.nonce = sealOpts?.nonce ?? headerData.nonce;
+            headerData.mixHash = sealOpts?.mixHash ?? headerData.mixHash;
+        }
+        const blockData = {
+            header: headerData,
+            transactions: this.transactions,
+            withdrawals: this.withdrawals,
+        };
+        let block;
+        const cs = this.blockOpts.cliqueSigner;
+        if (cs !== undefined) {
+            block = (0, block_1.createSealedCliqueBlock)(blockData, cs, this.blockOpts);
+        }
+        else {
+            block = (0, block_1.createBlock)(blockData, blockOpts);
+        }
+        if (this.blockOpts.putBlockIntoBlockchain === true) {
+            await this.vm.blockchain.putBlock(block);
+        }
+        this.blockStatus = { status: exports.BuildStatus.Build, block };
+        if (this.checkpointed) {
+            await this.vm.evm.journal.commit();
+            this.checkpointed = false;
+        }
+        return { block, requests };
+    }
+    async initState() {
+        if (this.vm.common.isActivatedEIP(4788)) {
+            if (!this.checkpointed) {
+                await this.vm.evm.journal.checkpoint();
+                this.checkpointed = true;
+            }
+            const { parentBeaconBlockRoot, timestamp } = this.headerData;
+            // timestamp should already be set in constructor
+            const timestampBigInt = (0, util_1.toType)(timestamp ?? 0, util_1.TypeOutput.BigInt);
+            const parentBeaconBlockRootBuf = (0, util_1.toType)(parentBeaconBlockRoot, util_1.TypeOutput.Uint8Array) ?? new Uint8Array(32);
+            await (0, runBlock_ts_1.accumulateParentBeaconBlockRoot)(this.vm, parentBeaconBlockRootBuf, timestampBigInt);
+        }
+        if (this.vm.common.isActivatedEIP(2935)) {
+            if (!this.checkpointed) {
+                await this.vm.evm.journal.checkpoint();
+                this.checkpointed = true;
+            }
+            const { parentHash, number } = this.headerData;
+            // timestamp should already be set in constructor
+            const numberBigInt = (0, util_1.toType)(number ?? 0, util_1.TypeOutput.BigInt);
+            const parentHashSanitized = (0, util_1.toType)(parentHash, util_1.TypeOutput.Uint8Array) ?? new Uint8Array(32);
+            await (0, runBlock_ts_1.accumulateParentBlockHash)(this.vm, numberBigInt, parentHashSanitized);
+        }
+    }
+}
+exports.BlockBuilder = BlockBuilder;
+/**
+ * Build a block on top of the current state
+ * by adding one transaction at a time.
+ *
+ * Creates a checkpoint on the StateManager and modifies the state
+ * as transactions are run. The checkpoint is committed on {@link BlockBuilder.build}
+ * or discarded with {@link BlockBuilder.revert}.
+ *
+ * @param {VM} vm
+ * @param {BuildBlockOpts} opts
+ * @returns An instance of {@link BlockBuilder} with methods:
+ * - {@link BlockBuilder.addTransaction}
+ * - {@link BlockBuilder.build}
+ * - {@link BlockBuilder.revert}
+ */
+async function buildBlock(vm, opts) {
+    const blockBuilder = new BlockBuilder(vm, opts);
+    await blockBuilder.initState();
+    return blockBuilder;
+}
+//# sourceMappingURL=buildBlock.js.map

package/dist/cjs/buildBlock.js.map

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

package/dist/cjs/constructors.d.ts

@@ -0,0 +1,9 @@
+import { VM } from './vm.ts';
+import type { VMOpts } from './types.ts';
+/**
+ * VM async constructor. Creates engine instance and initializes it.
+ *
+ * @param opts VM engine constructor options
+ */
+export declare function createVM(opts?: VMOpts): Promise<VM>;
+//# sourceMappingURL=constructors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constructors.d.ts","sourceRoot":"","sources":["../../src/constructors.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAE5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,GAAE,MAAW,GAAG,OAAO,CAAC,EAAE,CAAC,CAsE7D"}