@feelyourprotocol/vm 8141.0.0

package/dist/esm/buildBlock.js

@@ -0,0 +1,358 @@
+import { createBlock, createSealedCliqueBlock, genRequestsRoot, genTransactionsTrieRoot, genWithdrawalsTrieRoot, } from '@feelyourprotocol/block';
+import { ConsensusType, Hardfork } from '@feelyourprotocol/common';
+import { MerklePatriciaTrie } from '@feelyourprotocol/mpt';
+import { RLP } from '@feelyourprotocol/rlp';
+import { Blob4844Tx, NetworkWrapperType, createMinimal4844TxFromNetworkWrapper, } from '@feelyourprotocol/tx';
+import { Address, BIGINT_0, BIGINT_1, BIGINT_2, EthereumJSErrorWithoutCode, GWEI_TO_WEI, KECCAK256_RLP, TypeOutput, createWithdrawal, createZeroAddress, toBytes, toType, } from '@feelyourprotocol/util';
+import { sha256 } from '@noble/hashes/sha2.js';
+import { Bloom } from "./bloom/index.js";
+import { runTx } from "./index.js";
+import { accumulateRequests } from "./requests.js";
+import { accumulateParentBeaconBlockRoot, accumulateParentBlockHash, calculateMinerReward, encodeReceipt, rewardAccount, } from "./runBlock.js";
+export const BuildStatus = {
+    Reverted: 'reverted',
+    Build: 'build',
+    Pending: 'pending',
+};
+export 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 = BIGINT_0;
+        /**
+         *  The cumulative blob gas used by the blobs in a block
+         */
+        this.blobGasUsed = BIGINT_0;
+        /**
+         * Value of the block, represented by the final transaction fees
+         * accruing to the miner.
+         */
+        this._minerValue = BIGINT_0;
+        this.transactions = [];
+        this.transactionResults = [];
+        this.checkpointed = false;
+        this.blockStatus = { status: 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 + BIGINT_1,
+            gasLimit: opts.headerData?.gasLimit ?? opts.parentBlock.header.gasLimit,
+            timestamp: opts.headerData?.timestamp ?? Math.round(Date.now() / 1000),
+        };
+        this.withdrawals = opts.withdrawals?.map(createWithdrawal);
+        if (this.vm.common.isActivatedEIP(1559) &&
+            typeof this.headerData.baseFeePerGas === 'undefined') {
+            if (this.headerData.number === vm.common.hardforkBlock(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(Hardfork.London)) {
+                this.headerData.gasLimit = opts.parentBlock.header.gasLimit * 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 === BuildStatus.Build) {
+            throw EthereumJSErrorWithoutCode('Block has already been built');
+        }
+        if (this.blockStatus.status === BuildStatus.Reverted) {
+            throw EthereumJSErrorWithoutCode('State has already been reverted');
+        }
+    }
+    getStatus() {
+        return this.blockStatus;
+    }
+    /**
+     * Calculates and returns the transactionsTrie for the block.
+     */
+    async transactionsTrie() {
+        return genTransactionsTrieRoot(this.transactions, new MerklePatriciaTrie({ common: this.vm.common }));
+    }
+    /**
+     * Calculates and returns the logs bloom for the block.
+     */
+    logsBloom() {
+        const bloom = new 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 KECCAK256_RLP;
+        }
+        const receiptTrie = new MerklePatriciaTrie({ common: this.vm.common });
+        for (const [i, txResult] of this.transactionResults.entries()) {
+            const tx = this.transactions[i];
+            const encodedReceipt = encodeReceipt(txResult.receipt, tx.type);
+            await receiptTrie.put(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 = calculateMinerReward(minerReward, 0);
+        const coinbase = this.headerData.coinbase !== undefined
+            ? new Address(toBytes(this.headerData.coinbase))
+            : createZeroAddress();
+        await 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 === BIGINT_0)
+                continue;
+            // Withdrawal amount is represented in Gwei so needs to be
+            // converted to wei
+            await rewardAccount(this.vm.evm, address, amount * 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 = toType(this.headerData.gasLimit, TypeOutput.BigInt);
+        const blobGasPerBlob = this.vm.common.param('blobGasPerBlob');
+        const blockGasRemaining = blockGasLimit - this.gasUsed;
+        if (tx.gasLimit > blockGasRemaining) {
+            throw EthereumJSErrorWithoutCode('tx has a higher gas limit than the remaining gas in the block');
+        }
+        let blobGasUsed = undefined;
+        if (tx instanceof Blob4844Tx) {
+            const { maxBlobGasPerBlock: blobGasLimit } = this.vm.common.getBlobGasSchedule();
+            if (tx.networkWrapperVersion === NetworkWrapperType.EIP4844 &&
+                this.vm.common.isActivatedEIP(7594)) {
+                throw Error('eip4844 blob transaction for eip7594 activated fork');
+            }
+            else if (tx.networkWrapperVersion === 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 EthereumJSErrorWithoutCode('blobs missing for 4844 transaction');
+                }
+            }
+            if (this.blobGasUsed + BigInt(blobTx.numBlobs()) * blobGasPerBlob > blobGasLimit) {
+                throw 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 = createBlock(blockData, this.blockOpts);
+        const result = await 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 Blob4844Tx) {
+            const txData = tx;
+            this.blobGasUsed += BigInt(txData.blobVersionedHashes.length) * blobGasPerBlob;
+            tx = 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: 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 === ConsensusType.ProofOfWork) {
+            await this.rewardMiner();
+        }
+        await this.processWithdrawals();
+        const transactionsTrie = await this.transactionsTrie();
+        const withdrawalsRoot = this.withdrawals
+            ? await genWithdrawalsTrieRoot(this.withdrawals, new 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 ?? 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 ?? sha256;
+            requests = await accumulateRequests(this.vm, this.transactionResults);
+            requestsHash = 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 === 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 = createSealedCliqueBlock(blockData, cs, this.blockOpts);
+        }
+        else {
+            block = createBlock(blockData, blockOpts);
+        }
+        if (this.blockOpts.putBlockIntoBlockchain === true) {
+            await this.vm.blockchain.putBlock(block);
+        }
+        this.blockStatus = { status: 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 = toType(timestamp ?? 0, TypeOutput.BigInt);
+            const parentBeaconBlockRootBuf = toType(parentBeaconBlockRoot, TypeOutput.Uint8Array) ?? new Uint8Array(32);
+            await 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 = toType(number ?? 0, TypeOutput.BigInt);
+            const parentHashSanitized = toType(parentHash, TypeOutput.Uint8Array) ?? new Uint8Array(32);
+            await accumulateParentBlockHash(this.vm, numberBigInt, parentHashSanitized);
+        }
+    }
+}
+/**
+ * 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 async function buildBlock(vm, opts) {
+    const blockBuilder = new BlockBuilder(vm, opts);
+    await blockBuilder.initState();
+    return blockBuilder;
+}
+//# sourceMappingURL=buildBlock.js.map

package/dist/esm/buildBlock.js.map

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

package/dist/esm/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/esm/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"}

package/dist/esm/constructors.js

@@ -0,0 +1,72 @@
+import { Common, Mainnet } from '@feelyourprotocol/common';
+import { EVMMockBlockchain, createEVM, getActivePrecompiles } from '@feelyourprotocol/evm';
+import { MerkleStateManager } from '@feelyourprotocol/statemanager';
+import { Account, Address, EthereumJSErrorWithoutCode, createAccount, unprefixedHexToBytes, } from '@feelyourprotocol/util';
+import { VM } from "./vm.js";
+/**
+ * VM async constructor. Creates engine instance and initializes it.
+ *
+ * @param opts VM engine constructor options
+ */
+export async function createVM(opts = {}) {
+    // Save if a `StateManager` was passed (for activatePrecompiles)
+    const didPassStateManager = opts.stateManager !== undefined;
+    // Add common, SM, blockchain, EVM here
+    if (opts.common === undefined) {
+        opts.common = new Common({ chain: Mainnet });
+    }
+    if (opts.stateManager === undefined) {
+        opts.stateManager = new MerkleStateManager({
+            common: opts.common,
+        });
+    }
+    if (opts.blockchain === undefined) {
+        opts.blockchain = new EVMMockBlockchain();
+    }
+    if (opts.profilerOpts !== undefined) {
+        const profilerOpts = opts.profilerOpts;
+        if (profilerOpts.reportAfterBlock === true && profilerOpts.reportAfterTx === true) {
+            throw EthereumJSErrorWithoutCode('Cannot have `reportProfilerAfterBlock` and `reportProfilerAfterTx` set to `true` at the same time');
+        }
+    }
+    if (opts.evm !== undefined && opts.evmOpts !== undefined) {
+        throw EthereumJSErrorWithoutCode('the evm and evmOpts options cannot be used in conjunction');
+    }
+    if (opts.evm === undefined) {
+        let enableProfiler = false;
+        if (opts.profilerOpts?.reportAfterBlock === true || opts.profilerOpts?.reportAfterTx === true) {
+            enableProfiler = true;
+        }
+        const evmOpts = opts.evmOpts ?? {};
+        opts.evm = await createEVM({
+            common: opts.common,
+            stateManager: opts.stateManager,
+            blockchain: opts.blockchain,
+            profiler: {
+                enabled: enableProfiler,
+            },
+            ...evmOpts,
+        });
+    }
+    if (opts.activatePrecompiles === true && !didPassStateManager) {
+        await opts.evm.journal.checkpoint();
+        // put 1 wei in each of the precompiles in order to make the accounts non-empty and thus not have them deduct `callNewAccount` gas.
+        for (const [addressStr] of getActivePrecompiles(opts.common)) {
+            const address = new Address(unprefixedHexToBytes(addressStr));
+            let account = await opts.evm.stateManager.getAccount(address);
+            // Only do this if it is not overridden in genesis
+            // Note: in the case that custom genesis has storage fields, this is preserved
+            if (account === undefined) {
+                account = new Account();
+                const newAccount = createAccount({
+                    balance: 1,
+                    storageRoot: account.storageRoot,
+                });
+                await opts.evm.stateManager.putAccount(address, newAccount);
+            }
+        }
+        await opts.evm.journal.commit();
+    }
+    return new VM(opts);
+}
+//# sourceMappingURL=constructors.js.map

package/dist/esm/constructors.js.map

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

package/dist/esm/emitEVMProfile.d.ts

@@ -0,0 +1,9 @@
+import type { EVMPerformanceLogOutput } from '@feelyourprotocol/evm';
+/**
+ * Emit EVM profile logs
+ * @param logs
+ * @param profileTitle
+ * @hidden
+ */
+export declare function emitEVMProfile(logs: EVMPerformanceLogOutput[], profileTitle: string): void;
+//# sourceMappingURL=emitEVMProfile.d.ts.map

package/dist/esm/emitEVMProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitEVMProfile.d.ts","sourceRoot":"","sources":["../../src/emitEVMProfile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAE9D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,uBAAuB,EAAE,EAAE,YAAY,EAAE,MAAM,QA8InF"}

package/dist/esm/emitEVMProfile.js

@@ -0,0 +1,127 @@
+/**
+ * Emit EVM profile logs
+ * @param logs
+ * @param profileTitle
+ * @hidden
+ */
+export function emitEVMProfile(logs, profileTitle) {
+    if (logs.length === 0) {
+        return;
+    }
+    // Track total calls / time (ms) / gas
+    let calls = 0;
+    let totalMs = 0;
+    let totalGas = 0;
+    // Order of columns to report (see `EVMPerformanceLogOutput` type)
+    const colOrder = [
+        'tag',
+        'calls',
+        'avgTimePerCall',
+        'totalTime',
+        'staticGasUsed',
+        'dynamicGasUsed',
+        'gasUsed',
+        'staticGas',
+        'millionGasPerSecond',
+        'blocksPerSlot',
+    ];
+    // The name of this column to report (saves space)
+    const colNames = [
+        'tag',
+        'calls',
+        'ms/call',
+        'total (ms)',
+        'sgas',
+        'dgas',
+        'total (s+d)',
+        'static fee',
+        'Mgas/s',
+        'BpS',
+    ];
+    // Special padStr method which inserts whitespace left and right
+    // This ensures that there is at least one whitespace between the columns (denoted by pipe `|` chars)
+    function padStr(str, leftpad) {
+        return ' ' + str.toString().padStart(leftpad, ' ') + ' ';
+    }
+    // Returns the string length of this column. Used to calculate how big the header / footer should be
+    function strLen(str) {
+        return padStr(str, 0).length - 2;
+    }
+    // Step one: calculate the length of each column
+    const colLength = [];
+    for (const entry of logs) {
+        let ins = 0;
+        colLength[ins] = Math.max(colLength[ins] ?? 0, strLen(colNames[ins]));
+        for (const key of colOrder) {
+            if (entry[key] !== undefined) {
+                // If entry is available, max out the current column length (this will be the longest string of this column)
+                colLength[ins] = Math.max(colLength[ins] ?? 0, strLen(entry[key]));
+                ins++;
+                // In this switch statement update the total calls / time / gas used
+                switch (key) {
+                    case 'calls':
+                        calls += entry[key];
+                        break;
+                    case 'totalTime':
+                        totalMs += entry[key];
+                        break;
+                    case 'gasUsed':
+                        totalGas += entry[key];
+                        break;
+                }
+            }
+        }
+    }
+    // Ensure that the column names also fit on the column length
+    for (const i in colLength) {
+        colLength[i] = Math.max(colLength[i] ?? 0, strLen(colNames[i]));
+    }
+    // Calculate the total header length
+    // This is done by summing all columns together, plus adding three extra chars per column (two whitespace, one pipe)
+    // Remove the final pipe character since this is included in the header string (so subtract one)
+    const headerLength = colLength.reduce((pv, cv) => pv + cv, 0) + colLength.length * 3 - 1;
+    const blockGasLimit = 30000000; // Block gas limit
+    const slotTime = 12000; // Time in milliseconds (!) per slot
+    // Normalize constant to check if execution time is above one block per slot (>=1) or not (<1)
+    const bpsNormalizer = blockGasLimit / slotTime;
+    const avgGas = totalGas / totalMs; // Gas per millisecond
+    const mGasSAvg = Math.round(avgGas) / 1e3;
+    const bpSAvg = Math.round((avgGas / bpsNormalizer) * 1e3) / 1e3;
+    // Write the profile title
+    // eslint-disable-next-line
+    console.log('+== ' + profileTitle + ' ==+');
+    // Write the summary of this profile
+    // eslint-disable-next-line
+    console.log(`+== Calls: ${calls}, Total time: ${Math.round(totalMs * 1e3) / 1e3}ms, Total gas: ${totalGas}, MGas/s: ${mGasSAvg}, Blocks per Slot (BpS): ${bpSAvg} ==+`);
+    // Generate and write the header
+    const header = '|' + '-'.repeat(headerLength) + '|';
+    // eslint-disable-next-line
+    console.log(header);
+    // Write the columns
+    let str = '';
+    for (const i in colLength) {
+        str += '|' + padStr(colNames[i], colLength[i]);
+    }
+    str += '|';
+    // eslint-disable-next-line
+    console.log(str);
+    // Write each profile entry
+    for (const entry of logs) {
+        let str = '';
+        let i = 0;
+        for (const key of colOrder) {
+            if (entry[key] !== undefined) {
+                str += '|' + padStr(entry[key], colLength[i]);
+                i++;
+            }
+        }
+        str += '|';
+        // eslint-disable-next-line
+        console.log(str);
+    }
+    // Finally, write the footer
+    const footer = '+' + '-'.repeat(headerLength) + '+';
+    // eslint-disable-next-line
+    console.log(footer);
+}
+//# sourceMappingURL=emitEVMProfile.js.map

package/dist/esm/emitEVMProfile.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,11 @@
+export { Bloom } from './bloom/index.ts';
+export { BlockBuilder, BuildStatus } from './buildBlock.ts';
+export { buildBlock } from './buildBlock.ts';
+export * from './constructors.ts';
+export * from './params.ts';
+export { encodeReceipt } from './runBlock.ts';
+export { runBlock } from './runBlock.ts';
+export { runTx } from './runTx.ts';
+export * from './types.ts';
+export { VM } from './vm.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,11 @@
+export { Bloom } from "./bloom/index.js";
+export { BlockBuilder, BuildStatus } from "./buildBlock.js";
+export { buildBlock } from "./buildBlock.js";
+export * from "./constructors.js";
+export * from "./params.js";
+export { encodeReceipt } from "./runBlock.js";
+export { runBlock } from "./runBlock.js";
+export { runTx } from "./runTx.js";
+export * from "./types.js";
+export { VM } from "./vm.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA"}