hardhat 2.22.2 → 2.23.0-dev.0

package/internal/hardhat-network/provider/BlockchainData.d.ts

@@ -0,0 +1,58 @@
+/// <reference types="node" />
+import { Block } from "@nomicfoundation/ethereumjs-block";
+import { Common } from "@nomicfoundation/ethereumjs-common";
+import { TypedTransaction } from "@nomicfoundation/ethereumjs-tx";
+import { FilterParams } from "./node-types";
+import { RpcLogOutput, RpcReceiptOutput } from "./output";
+interface Reservation {
+    first: bigint;
+    last: bigint;
+    interval: bigint;
+    previousBlockStateRoot: Buffer;
+    previousBlockTotalDifficulty: bigint;
+    previousBlockBaseFeePerGas: bigint | undefined;
+}
+export declare class BlockchainData {
+    private _common;
+    private _blocksByNumber;
+    private _blocksByHash;
+    private _blocksByTransactions;
+    private _transactions;
+    private _transactionReceipts;
+    private _totalDifficulty;
+    private _blockReservations;
+    constructor(_common: Common);
+    reserveBlocks(first: bigint, count: bigint, interval: bigint, previousBlockStateRoot: Buffer, previousBlockTotalDifficulty: bigint, previousBlockBaseFeePerGas: bigint | undefined): void;
+    getBlockByNumber(blockNumber: bigint): Block | undefined;
+    getBlockByHash(blockHash: Buffer): Block | undefined;
+    getBlockByTransactionHash(transactionHash: Buffer): Block | undefined;
+    getTransaction(transactionHash: Buffer): TypedTransaction | undefined;
+    getTransactionReceipt(transactionHash: Buffer): RpcReceiptOutput | undefined;
+    getTotalDifficulty(blockHash: Buffer): bigint | undefined;
+    getLogs(filterParams: FilterParams): RpcLogOutput[];
+    addBlock(block: Block, totalDifficulty: bigint): void;
+    /**
+     * WARNING: this method can leave the blockchain in an invalid state where
+     * there are gaps between blocks. Ideally we should have a method that removes
+     * the given block and all the following blocks.
+     */
+    removeBlock(block: Block): void;
+    addTransaction(transaction: TypedTransaction): void;
+    addTransactionReceipt(receipt: RpcReceiptOutput): void;
+    isReservedBlock(blockNumber: bigint): boolean;
+    private _findBlockReservation;
+    /**
+     * WARNING: this method only removes the given reservation and can result in
+     * gaps in the reservations array. Ideally we should have a method that
+     * removes the given reservation and all the following reservations.
+     */
+    private _removeReservation;
+    /**
+     * Cancel and return the reservation that has block `blockNumber`
+     */
+    cancelReservationWithBlock(blockNumber: bigint): Reservation;
+    fulfillBlockReservation(blockNumber: bigint): void;
+    private _calculateTimestampForReservedBlock;
+}
+export {};
+//# sourceMappingURL=BlockchainData.d.ts.map

package/internal/hardhat-network/provider/BlockchainData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockchainData.d.ts","sourceRoot":"","sources":["../../../src/internal/hardhat-network/provider/BlockchainData.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAMlE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE1D,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4BAA4B,EAAE,MAAM,CAAC;IACrC,0BAA0B,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD;AAED,qBAAa,cAAc;IASb,OAAO,CAAC,OAAO;IAR3B,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,qBAAqB,CAAiC;IAC9D,OAAO,CAAC,aAAa,CAA4C;IACjE,OAAO,CAAC,oBAAoB,CAA4C;IACxE,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,kBAAkB,CAA8B;gBAEpC,OAAO,EAAE,MAAM;IAE5B,aAAa,CAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,sBAAsB,EAAE,MAAM,EAC9B,4BAA4B,EAAE,MAAM,EACpC,0BAA0B,EAAE,MAAM,GAAG,SAAS;IAazC,gBAAgB,CAAC,WAAW,EAAE,MAAM;IAIpC,cAAc,CAAC,SAAS,EAAE,MAAM;IAIhC,yBAAyB,CAAC,eAAe,EAAE,MAAM;IAIjD,cAAc,CAAC,eAAe,EAAE,MAAM;IAItC,qBAAqB,CAAC,eAAe,EAAE,MAAM;IAI7C,kBAAkB,CAAC,SAAS,EAAE,MAAM;IAIpC,OAAO,CAAC,YAAY,EAAE,YAAY;IA+BlC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM;IAcrD;;;;OAIG;IACI,WAAW,CAAC,KAAK,EAAE,KAAK;IAexB,cAAc,CAAC,WAAW,EAAE,gBAAgB;IAI5C,qBAAqB,CAAC,OAAO,EAAE,gBAAgB;IAI/C,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIpD,OAAO,CAAC,qBAAqB;IAO7B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACI,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW;IAI5D,uBAAuB,CAAC,WAAW,EAAE,MAAM;IAiDlD,OAAO,CAAC,mCAAmC;CA6B5C"}

package/internal/hardhat-network/provider/BlockchainData.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockchainData = void 0;
+const ethereumjs_block_1 = require("@nomicfoundation/ethereumjs-block");
+const ethereumjs_util_1 = require("@nomicfoundation/ethereumjs-util");
+const ethereumjs_vm_1 = require("@nomicfoundation/ethereumjs-vm");
+const errors_1 = require("../../core/errors");
+const filter_1 = require("./filter");
+class BlockchainData {
+    constructor(_common) {
+        this._common = _common;
+        this._blocksByNumber = new Map();
+        this._blocksByHash = new Map();
+        this._blocksByTransactions = new Map();
+        this._transactions = new Map();
+        this._transactionReceipts = new Map();
+        this._totalDifficulty = new Map();
+        this._blockReservations = new Array();
+    }
+    reserveBlocks(first, count, interval, previousBlockStateRoot, previousBlockTotalDifficulty, previousBlockBaseFeePerGas) {
+        const reservation = {
+            first,
+            last: first + count - 1n,
+            interval,
+            previousBlockStateRoot,
+            previousBlockTotalDifficulty,
+            previousBlockBaseFeePerGas,
+        };
+        this._blockReservations.push(reservation);
+    }
+    getBlockByNumber(blockNumber) {
+        return this._blocksByNumber.get(blockNumber);
+    }
+    getBlockByHash(blockHash) {
+        return this._blocksByHash.get((0, ethereumjs_util_1.bufferToHex)(blockHash));
+    }
+    getBlockByTransactionHash(transactionHash) {
+        return this._blocksByTransactions.get((0, ethereumjs_util_1.bufferToHex)(transactionHash));
+    }
+    getTransaction(transactionHash) {
+        return this._transactions.get((0, ethereumjs_util_1.bufferToHex)(transactionHash));
+    }
+    getTransactionReceipt(transactionHash) {
+        return this._transactionReceipts.get((0, ethereumjs_util_1.bufferToHex)(transactionHash));
+    }
+    getTotalDifficulty(blockHash) {
+        return this._totalDifficulty.get((0, ethereumjs_util_1.bufferToHex)(blockHash));
+    }
+    getLogs(filterParams) {
+        const logs = [];
+        for (let i = filterParams.fromBlock; i <= filterParams.toBlock; i++) {
+            const block = this.getBlockByNumber(i);
+            if (block === undefined ||
+                !(0, filter_1.bloomFilter)(new ethereumjs_vm_1.Bloom(block.header.logsBloom), filterParams.addresses, filterParams.normalizedTopics)) {
+                continue;
+            }
+            for (const transaction of block.transactions) {
+                const receipt = this.getTransactionReceipt(transaction.hash());
+                if (receipt !== undefined) {
+                    logs.push(...(0, filter_1.filterLogs)(receipt.logs, {
+                        fromBlock: filterParams.fromBlock,
+                        toBlock: filterParams.toBlock,
+                        addresses: filterParams.addresses,
+                        normalizedTopics: filterParams.normalizedTopics,
+                    }));
+                }
+            }
+        }
+        return logs;
+    }
+    addBlock(block, totalDifficulty) {
+        const blockHash = (0, ethereumjs_util_1.bufferToHex)(block.hash());
+        const blockNumber = block.header.number;
+        this._blocksByNumber.set(blockNumber, block);
+        this._blocksByHash.set(blockHash, block);
+        this._totalDifficulty.set(blockHash, totalDifficulty);
+        for (const transaction of block.transactions) {
+            const transactionHash = (0, ethereumjs_util_1.bufferToHex)(transaction.hash());
+            this._transactions.set(transactionHash, transaction);
+            this._blocksByTransactions.set(transactionHash, block);
+        }
+    }
+    /**
+     * WARNING: this method can leave the blockchain in an invalid state where
+     * there are gaps between blocks. Ideally we should have a method that removes
+     * the given block and all the following blocks.
+     */
+    removeBlock(block) {
+        const blockHash = (0, ethereumjs_util_1.bufferToHex)(block.hash());
+        const blockNumber = block.header.number;
+        this._blocksByNumber.delete(blockNumber);
+        this._blocksByHash.delete(blockHash);
+        this._totalDifficulty.delete(blockHash);
+        for (const transaction of block.transactions) {
+            const transactionHash = (0, ethereumjs_util_1.bufferToHex)(transaction.hash());
+            this._transactions.delete(transactionHash);
+            this._transactionReceipts.delete(transactionHash);
+            this._blocksByTransactions.delete(transactionHash);
+        }
+    }
+    addTransaction(transaction) {
+        this._transactions.set((0, ethereumjs_util_1.bufferToHex)(transaction.hash()), transaction);
+    }
+    addTransactionReceipt(receipt) {
+        this._transactionReceipts.set(receipt.transactionHash, receipt);
+    }
+    isReservedBlock(blockNumber) {
+        return this._findBlockReservation(blockNumber) !== -1;
+    }
+    _findBlockReservation(blockNumber) {
+        return this._blockReservations.findIndex((reservation) => reservation.first <= blockNumber && blockNumber <= reservation.last);
+    }
+    /**
+     * WARNING: this method only removes the given reservation and can result in
+     * gaps in the reservations array. Ideally we should have a method that
+     * removes the given reservation and all the following reservations.
+     */
+    _removeReservation(index) {
+        (0, errors_1.assertHardhatInvariant)(index in this._blockReservations, `Reservation ${index} does not exist`);
+        const reservation = this._blockReservations[index];
+        this._blockReservations.splice(index, 1);
+        return reservation;
+    }
+    /**
+     * Cancel and return the reservation that has block `blockNumber`
+     */
+    cancelReservationWithBlock(blockNumber) {
+        return this._removeReservation(this._findBlockReservation(blockNumber));
+    }
+    fulfillBlockReservation(blockNumber) {
+        // in addition to adding the given block, the reservation needs to be split
+        // in two in order to accomodate access to the given block.
+        const reservationIndex = this._findBlockReservation(blockNumber);
+        (0, errors_1.assertHardhatInvariant)(reservationIndex !== -1, `No reservation to fill for block number ${blockNumber.toString()}`);
+        // capture the timestamp before removing the reservation:
+        const timestamp = this._calculateTimestampForReservedBlock(blockNumber);
+        // split the block reservation:
+        const oldReservation = this._removeReservation(reservationIndex);
+        if (blockNumber !== oldReservation.first) {
+            this._blockReservations.push({
+                ...oldReservation,
+                last: blockNumber - 1n,
+            });
+        }
+        if (blockNumber !== oldReservation.last) {
+            this._blockReservations.push({
+                ...oldReservation,
+                first: blockNumber + 1n,
+            });
+        }
+        this.addBlock(ethereumjs_block_1.Block.fromBlockData({
+            header: {
+                number: blockNumber,
+                stateRoot: oldReservation.previousBlockStateRoot,
+                baseFeePerGas: oldReservation.previousBlockBaseFeePerGas,
+                timestamp,
+            },
+        }, {
+            common: this._common,
+            skipConsensusFormatValidation: true,
+        }), oldReservation.previousBlockTotalDifficulty);
+    }
+    _calculateTimestampForReservedBlock(blockNumber) {
+        const reservationIndex = this._findBlockReservation(blockNumber);
+        (0, errors_1.assertHardhatInvariant)(reservationIndex !== -1, `Block ${blockNumber.toString()} does not lie within any of the reservations.`);
+        const reservation = this._blockReservations[reservationIndex];
+        const blockNumberBeforeReservation = reservation.first - 1n;
+        const blockBeforeReservation = this.getBlockByNumber(blockNumberBeforeReservation);
+        (0, errors_1.assertHardhatInvariant)(blockBeforeReservation !== undefined, `Reservation after block ${blockNumberBeforeReservation.toString()} cannot be created because that block does not exist`);
+        const previousTimestamp = this.isReservedBlock(blockNumberBeforeReservation)
+            ? this._calculateTimestampForReservedBlock(blockNumberBeforeReservation)
+            : blockBeforeReservation.header.timestamp;
+        return (previousTimestamp +
+            reservation.interval * (blockNumber - reservation.first + 1n));
+    }
+}
+exports.BlockchainData = BlockchainData;
+//# sourceMappingURL=BlockchainData.js.map

package/internal/hardhat-network/provider/BlockchainData.js.map

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

package/internal/hardhat-network/provider/HardhatBlockchain.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="node" />
+import { Block } from "@nomicfoundation/ethereumjs-block";
+import { Common } from "@nomicfoundation/ethereumjs-common";
+import { TypedTransaction } from "@nomicfoundation/ethereumjs-tx";
+import { BlockchainBase } from "./BlockchainBase";
+import { FilterParams } from "./node-types";
+import { RpcLogOutput } from "./output";
+import { HardhatBlockchainInterface } from "./types/HardhatBlockchainInterface";
+export declare class HardhatBlockchain extends BlockchainBase implements HardhatBlockchainInterface {
+    private _length;
+    constructor(common: Common);
+    getLatestBlockNumber(): bigint;
+    addBlock(block: Block): Promise<Block>;
+    reserveBlocks(count: bigint, interval: bigint, previousBlockStateRoot: Buffer, previousBlockTotalDifficulty: bigint, previousBlockBaseFeePerGas: bigint | undefined): void;
+    deleteLaterBlocks(block: Block): void;
+    getTotalDifficulty(blockHash: Buffer): Promise<bigint>;
+    getTransaction(transactionHash: Buffer): Promise<TypedTransaction | undefined>;
+    getBlockByTransactionHash(transactionHash: Buffer): Promise<Block | null>;
+    getTransactionReceipt(transactionHash: Buffer): Promise<import("./output").RpcReceiptOutput | null>;
+    getLogs(filterParams: FilterParams): Promise<RpcLogOutput[]>;
+    private _validateBlock;
+    protected _delBlock(blockNumber: bigint): void;
+}
+//# sourceMappingURL=HardhatBlockchain.d.ts.map

package/internal/hardhat-network/provider/HardhatBlockchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HardhatBlockchain.d.ts","sourceRoot":"","sources":["../../../src/internal/hardhat-network/provider/HardhatBlockchain.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGlE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAIhF,qBAAa,iBACX,SAAQ,cACR,YAAW,0BAA0B;IAErC,OAAO,CAAC,OAAO,CAAM;gBAET,MAAM,EAAE,MAAM;IAInB,oBAAoB,IAAI,MAAM;IAIxB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAQ5C,aAAa,CAClB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,sBAAsB,EAAE,MAAM,EAC9B,4BAA4B,EAAE,MAAM,EACpC,0BAA0B,EAAE,MAAM,GAAG,SAAS;IAYzC,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAS/B,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQtD,cAAc,CACzB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAI3B,yBAAyB,CACpC,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAKX,qBAAqB,CAAC,eAAe,EAAE,MAAM;IAI7C,OAAO,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIzE,OAAO,CAAC,cAAc;IAqBtB,SAAS,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;CAI/C"}

package/internal/hardhat-network/provider/HardhatBlockchain.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HardhatBlockchain = void 0;
+const ethereumjs_util_1 = require("@nomicfoundation/ethereumjs-util");
+const BlockchainBase_1 = require("./BlockchainBase");
+/* eslint-disable @nomicfoundation/hardhat-internal-rules/only-hardhat-error */
+class HardhatBlockchain extends BlockchainBase_1.BlockchainBase {
+    constructor(common) {
+        super(common);
+        this._length = 0n;
+    }
+    getLatestBlockNumber() {
+        return BigInt(this._length - 1n);
+    }
+    async addBlock(block) {
+        this._validateBlock(block);
+        const totalDifficulty = await this._computeTotalDifficulty(block);
+        this._data.addBlock(block, totalDifficulty);
+        this._length += 1n;
+        return block;
+    }
+    reserveBlocks(count, interval, previousBlockStateRoot, previousBlockTotalDifficulty, previousBlockBaseFeePerGas) {
+        super.reserveBlocks(count, interval, previousBlockStateRoot, previousBlockTotalDifficulty, previousBlockBaseFeePerGas);
+        this._length += count;
+    }
+    deleteLaterBlocks(block) {
+        const actual = this._data.getBlockByHash(block.hash());
+        if (actual === undefined) {
+            throw new Error("Invalid block");
+        }
+        this._delBlock(actual.header.number + 1n);
+    }
+    async getTotalDifficulty(blockHash) {
+        const totalDifficulty = this._data.getTotalDifficulty(blockHash);
+        if (totalDifficulty === undefined) {
+            throw new Error("Block not found");
+        }
+        return totalDifficulty;
+    }
+    async getTransaction(transactionHash) {
+        return this.getLocalTransaction(transactionHash);
+    }
+    async getBlockByTransactionHash(transactionHash) {
+        const block = this._data.getBlockByTransactionHash(transactionHash);
+        return block ?? null;
+    }
+    async getTransactionReceipt(transactionHash) {
+        return this._data.getTransactionReceipt(transactionHash) ?? null;
+    }
+    async getLogs(filterParams) {
+        return this._data.getLogs(filterParams);
+    }
+    _validateBlock(block) {
+        const blockNumber = block.header.number;
+        const parentHash = block.header.parentHash;
+        const parent = this._data.getBlockByNumber(BigInt(blockNumber - 1n));
+        if (BigInt(this._length) !== blockNumber) {
+            throw new Error(`Invalid block number ${blockNumber}. Expected ${this._length}.`);
+        }
+        if ((blockNumber === 0n && !parentHash.equals((0, ethereumjs_util_1.zeros)(32))) ||
+            (blockNumber > 0 &&
+                parent !== undefined &&
+                !parentHash.equals(parent.hash()))) {
+            throw new Error("Invalid parent hash");
+        }
+    }
+    _delBlock(blockNumber) {
+        super._delBlock(blockNumber);
+        this._length = blockNumber;
+    }
+}
+exports.HardhatBlockchain = HardhatBlockchain;
+//# sourceMappingURL=HardhatBlockchain.js.map

package/internal/hardhat-network/provider/HardhatBlockchain.js.map

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

package/internal/hardhat-network/provider/PoolState.d.ts

@@ -0,0 +1,26 @@
+import { TypedTransaction } from "@nomicfoundation/ethereumjs-tx";
+import { List as ImmutableList, Map as ImmutableMap, Record as ImmutableRecord } from "immutable";
+export interface OrderedTransaction {
+    orderId: number;
+    data: TypedTransaction;
+}
+interface ImmutableOrderedTransaction {
+    orderId: number;
+    fakeFrom: string | undefined;
+    data: string;
+    txType: number;
+}
+export declare const makeSerializedTransaction: ImmutableRecord.Factory<ImmutableOrderedTransaction>;
+export type SerializedTransaction = ImmutableRecord<ImmutableOrderedTransaction>;
+export type SenderTransactions = ImmutableList<SerializedTransaction>;
+export type AddressToTransactions = ImmutableMap<string, SenderTransactions>;
+export type HashToTransaction = ImmutableMap<string, SerializedTransaction>;
+export interface PoolState {
+    pendingTransactions: AddressToTransactions;
+    queuedTransactions: AddressToTransactions;
+    hashToTransaction: HashToTransaction;
+    blockGasLimit: string;
+}
+export declare const makePoolState: ImmutableRecord.Factory<PoolState>;
+export {};
+//# sourceMappingURL=PoolState.d.ts.map

package/internal/hardhat-network/provider/PoolState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoolState.d.ts","sourceRoot":"","sources":["../../../src/internal/hardhat-network/provider/PoolState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EACL,IAAI,IAAI,aAAa,EACrB,GAAG,IAAI,YAAY,EACnB,MAAM,IAAI,eAAe,EAC1B,MAAM,WAAW,CAAC;AAInB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,UAAU,2BAA2B;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,yBAAyB,sDAMlC,CAAC;AAEL,MAAM,MAAM,qBAAqB,GAC/B,eAAe,CAAC,2BAA2B,CAAC,CAAC;AAC/C,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAC;AACtE,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAC7E,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;AAE5E,MAAM,WAAW,SAAS;IACxB,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,kBAAkB,EAAE,qBAAqB,CAAC;IAC1C,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,aAAa,oCAKxB,CAAC"}

package/internal/hardhat-network/provider/PoolState.js

@@ -0,0 +1,41 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makePoolState = exports.makeSerializedTransaction = void 0;
+const immutable_1 = require("immutable");
+const BigIntUtils = __importStar(require("../../util/bigint"));
+exports.makeSerializedTransaction = (0, immutable_1.Record)({
+    orderId: 0,
+    fakeFrom: undefined,
+    data: "",
+    txType: 0,
+});
+exports.makePoolState = (0, immutable_1.Record)({
+    pendingTransactions: (0, immutable_1.Map)(),
+    queuedTransactions: (0, immutable_1.Map)(),
+    hashToTransaction: (0, immutable_1.Map)(),
+    blockGasLimit: BigIntUtils.toHex(9500000),
+});
+//# sourceMappingURL=PoolState.js.map

package/internal/hardhat-network/provider/PoolState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoolState.js","sourceRoot":"","sources":["../../../src/internal/hardhat-network/provider/PoolState.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,yCAImB;AAEnB,+DAAiD;AAcpC,QAAA,yBAAyB,GACpC,IAAA,kBAAe,EAA8B;IAC3C,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,EAAE;IACR,MAAM,EAAE,CAAC;CACV,CAAC,CAAC;AAeQ,QAAA,aAAa,GAAG,IAAA,kBAAe,EAAY;IACtD,mBAAmB,EAAE,IAAA,eAAY,GAA8B;IAC/D,kBAAkB,EAAE,IAAA,eAAY,GAA8B;IAC9D,iBAAiB,EAAE,IAAA,eAAY,GAAiC;IAChE,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC;CAC1C,CAAC,CAAC"}

package/internal/hardhat-network/provider/TransactionQueue.d.ts

@@ -0,0 +1,32 @@
+import { TypedTransaction } from "@nomicfoundation/ethereumjs-tx";
+import { MempoolOrder } from "./node-types";
+import { OrderedTransaction } from "./PoolState";
+/**
+ * A queue of transactions in the order that they could be mined in the next
+ * block.
+ *
+ * A transaction being part of this queue doesn't mean that it will be mined in
+ * the next block, as it may not meet the required criteria to be included or
+ * may not fit within the block.
+ *
+ * If after getting the next transaction in the queue you decided not to mine
+ * it, the other transactions that belong to that sender MUST be removed from
+ * the queue by calling the #removeLastSenderTransactions() method.
+ **/
+export declare class TransactionQueue {
+    private readonly _queuedTransactions;
+    private readonly _heap;
+    private _lastTransactionSender?;
+    /**
+     * Creates a TransactionQueue.
+     *
+     * @param pendingTransactions A map of sender to a list of their transactions,
+     *  sorted by nonce and without nonce gaps.
+     * @param baseFee The base fee of the next block, if it's going to use EIP-1559
+     */
+    constructor(pendingTransactions: Map<string, OrderedTransaction[]>, mempoolOrder: MempoolOrder, baseFee?: bigint);
+    getNextTransaction(): TypedTransaction | undefined;
+    removeLastSenderTransactions(): void;
+    private _moveFirstEnqueuedTransactionToHeap;
+}
+//# sourceMappingURL=TransactionQueue.d.ts.map

package/internal/hardhat-network/provider/TransactionQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionQueue.d.ts","sourceRoot":"","sources":["../../../src/internal/hardhat-network/provider/TransactionQueue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAKlE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAmEjD;;;;;;;;;;;IAWI;AACJ,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CACxB;IAEZ,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IAEjD,OAAO,CAAC,sBAAsB,CAAC,CAAS;IAExC;;;;;;OAMG;gBAED,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,EACtD,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE,MAAM;IAkBX,kBAAkB,IAAI,gBAAgB,GAAG,SAAS;IAclD,4BAA4B;IAYnC,OAAO,CAAC,mCAAmC;CAU5C"}

package/internal/hardhat-network/provider/TransactionQueue.js

@@ -0,0 +1,130 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionQueue = void 0;
+const heap_1 = __importDefault(require("mnemonist/heap"));
+const errors_1 = require("../../core/providers/errors");
+const BigIntUtils = __importStar(require("../../util/bigint"));
+function getEffectiveMinerFee(tx, baseFee) {
+    // This mimics the EIP-1559 normalize_transaction function
+    const maxFeePerGas = "gasPrice" in tx.data ? tx.data.gasPrice : tx.data.maxFeePerGas;
+    const maxPriorityFeePerGas = "gasPrice" in tx.data ? tx.data.gasPrice : tx.data.maxPriorityFeePerGas;
+    if (baseFee === undefined) {
+        return maxFeePerGas;
+    }
+    return BigIntUtils.min(maxPriorityFeePerGas, maxFeePerGas - baseFee);
+}
+function decreasingOrderEffectiveMinerFeeComparator(left, right, baseFee) {
+    const leftEffectiveMinerFee = getEffectiveMinerFee(left, baseFee);
+    const rightEffectiveMinerFee = getEffectiveMinerFee(right, baseFee);
+    const cmp = BigIntUtils.cmp(rightEffectiveMinerFee, leftEffectiveMinerFee);
+    if (cmp !== 0) {
+        return cmp;
+    }
+    // If two txs have the same effective miner fee we want to sort them
+    // in increasing order by orderId.
+    return left.orderId - right.orderId;
+}
+function decreasingOrderComparator(left, right) {
+    return left.orderId - right.orderId;
+}
+function getOrderedTransactionHeap(mempoolOrder, baseFee) {
+    switch (mempoolOrder) {
+        case "priority":
+            return new heap_1.default((a, b) => decreasingOrderEffectiveMinerFeeComparator(a, b, baseFee));
+        case "fifo":
+            return new heap_1.default((a, b) => decreasingOrderComparator(a, b));
+        default:
+            // eslint-disable-next-line @nomicfoundation/hardhat-internal-rules/only-hardhat-error
+            throw new errors_1.InvalidInputError(`Invalid mempool order: ${mempoolOrder}`);
+    }
+}
+/**
+ * A queue of transactions in the order that they could be mined in the next
+ * block.
+ *
+ * A transaction being part of this queue doesn't mean that it will be mined in
+ * the next block, as it may not meet the required criteria to be included or
+ * may not fit within the block.
+ *
+ * If after getting the next transaction in the queue you decided not to mine
+ * it, the other transactions that belong to that sender MUST be removed from
+ * the queue by calling the #removeLastSenderTransactions() method.
+ **/
+class TransactionQueue {
+    /**
+     * Creates a TransactionQueue.
+     *
+     * @param pendingTransactions A map of sender to a list of their transactions,
+     *  sorted by nonce and without nonce gaps.
+     * @param baseFee The base fee of the next block, if it's going to use EIP-1559
+     */
+    constructor(pendingTransactions, mempoolOrder, baseFee) {
+        this._queuedTransactions = new Map();
+        this._heap = getOrderedTransactionHeap(mempoolOrder, baseFee);
+        for (const [address, txList] of pendingTransactions) {
+            if (baseFee === undefined && txList.some((tx) => tx.data.type === 2)) {
+                // eslint-disable-next-line @nomicfoundation/hardhat-internal-rules/only-hardhat-error
+                throw new errors_1.InternalError("Trying to initialize and sort a mempool with an EIP-1559 tx but no base fee");
+            }
+            const [firstTx, ...remainingTxs] = txList;
+            this._heap.push(firstTx);
+            this._queuedTransactions.set(address, remainingTxs);
+        }
+    }
+    getNextTransaction() {
+        if (this._lastTransactionSender !== undefined) {
+            this._moveFirstEnqueuedTransactionToHeap(this._lastTransactionSender);
+        }
+        const nextTx = this._heap.pop();
+        if (nextTx === undefined) {
+            return undefined;
+        }
+        this._lastTransactionSender = nextTx.data.getSenderAddress().toString();
+        return nextTx.data;
+    }
+    removeLastSenderTransactions() {
+        if (this._lastTransactionSender === undefined) {
+            // eslint-disable-next-line @nomicfoundation/hardhat-internal-rules/only-hardhat-error
+            throw new errors_1.InternalError("TransactionQueue#removeLastSenderTransactions called before TransactionQueue#getNextTransaction");
+        }
+        this._queuedTransactions.delete(this._lastTransactionSender);
+        this._lastTransactionSender = undefined;
+    }
+    _moveFirstEnqueuedTransactionToHeap(sender) {
+        const queue = this._queuedTransactions.get(sender);
+        if (queue === undefined || queue.length === 0) {
+            return;
+        }
+        const [first, ...rest] = queue;
+        this._heap.push(first);
+        this._queuedTransactions.set(sender, rest);
+    }
+}
+exports.TransactionQueue = TransactionQueue;
+//# sourceMappingURL=TransactionQueue.js.map

package/internal/hardhat-network/provider/TransactionQueue.js.map

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