@nomicfoundation/edr 0.12.0-next.9 → 0.12.1

package/coverage.sol

@@ -0,0 +1,38 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.4.22 <0.9.0;
+
+library __NomicFoundationCoverage {
+  address constant COVERAGE_ADDRESS =
+    0xc0bEc0BEc0BeC0bEC0beC0bEC0bEC0beC0beC0BE;
+
+  function _sendHitImplementation(uint256 coverageId) private view {
+    address coverageAddress = COVERAGE_ADDRESS;
+    /// @solidity memory-safe-assembly
+    assembly {
+      let ptr := mload(0x40)           // Get free memory pointer
+      mstore(ptr, coverageId)          // Store coverageId at free memory
+      pop(
+        staticcall(
+          gas(),
+          coverageAddress,
+          ptr,
+          32,                          // Size of uint256 is 32 bytes
+          0,
+          0
+        )
+      )
+    }
+  }
+
+  function _castToPure(
+    function(uint256) internal view fnIn
+  ) private pure returns (function(uint256) pure fnOut) {
+    assembly {
+      fnOut := fnIn
+    }
+  }
+
+  function sendHit(uint256 coverageId) internal pure {
+    _castToPure(_sendHitImplementation)(coverageId);
+  }
+}

package/dist/src/ts/coverage.d.ts

@@ -0,0 +1,6 @@
+export interface CoverageLib {
+    content: string;
+    filename: string;
+}
+export declare function getCoverageLibrary(): CoverageLib;
+//# sourceMappingURL=coverage.d.ts.map

package/dist/src/ts/coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../../../src/ts/coverage.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,kBAAkB,IAAI,WAAW,CAYhD"}

package/dist/src/ts/coverage.js

@@ -0,0 +1,51 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCoverageLibrary = getCoverageLibrary;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const edr_1 = require("@nomicfoundation/edr");
+function getCoverageLibrary() {
+    const packageRoot = path.dirname(require.resolve("@nomicfoundation/edr"));
+    const sourcePath = path.join(packageRoot, "coverage.sol");
+    if (!fs.existsSync(sourcePath)) {
+        throw new Error(`Coverage library file not found at ${sourcePath}. It should be bundled with @nomicfoundation/edr.`);
+    }
+    return {
+        content: fs.readFileSync(sourcePath, "utf-8"),
+        filename: edr_1.COVERAGE_LIBRARY_FILE_NAME,
+    };
+}
+//# sourceMappingURL=coverage.js.map

package/dist/src/ts/coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.js","sourceRoot":"","sources":["../../../src/ts/coverage.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,gDAYC;AAtBD,uCAAyB;AACzB,2CAA6B;AAE7B,8CAAkE;AAOlE,SAAgB,kBAAkB;IAChC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC1D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,sCAAsC,UAAU,mDAAmD,CACpG,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC;QAC7C,QAAQ,EAAE,gCAA0B;KACrC,CAAC;AACJ,CAAC"}

package/index.d.ts

@@ -91,7 +91,9 @@ export enum SpecId {
   /** Cancun */
   Cancun = 17,
   /** Prague */
-  Prague = 18
+  Prague = 18,
+  /** Osaka */
+  Osaka = 19
 }
 /**
  * Tries to parse the provided string to create a [`SpecId`] instance.
@@ -125,6 +127,7 @@ export const MERGE: string
 export const SHANGHAI: string
 export const CANCUN: string
 export const PRAGUE: string
+export const OSAKA: string
 /** Enumeration of supported OP hardforks. */
 export enum OpHardfork {
   Bedrock = 100,
@@ -243,6 +246,16 @@ export interface HardforkActivationByTimestamp {
   /** The timestamp at which the hardfork is activated */
   timestamp: bigint
 }
+/** Controls the gas estimation strategy used by `eth_estimateGas`. */
+export enum GasEstimationMode {
+  /** Estimates the minimum gas required for the top-level call to succeed. */
+  TopLevelSuccess = 0,
+  /**
+   * Estimates the minimum gas required for the top-level call to succeed
+   * without any internal sub-call running out of gas.
+   */
+  NoInternalOutOfGas = 1
+}
 /**The type of ordering to use when selecting blocks to mine. */
 export enum MineOrdering {
   /**Insertion order */
@@ -261,15 +274,42 @@ export interface IntervalRange {
 /** Configuration for the provider's miner. */
 export interface MiningConfig {
   autoMine: boolean
+  /**
+   * The block gas limit to use for mining a block.
+   *
+   * When not set, enforcement of the block gas limit is disabled in the mem
+   * pool, miner, and REVM.
+   */
+  blockGasLimit?: bigint
   interval?: bigint | IntervalRange
   memPool: MemPoolConfig
 }
+/** Configuration for a locally mined blockchain. */
+export interface LocalConfig {
+  /**
+   * The blob gas used for the genesis block, introduced in [EIP-4844].
+   *
+   * [EIP-4844]: https://eips.ethereum.org/EIPS/eip-4844
+   */
+  genesisBlobGas?: BlobGas
+  /** The block gas limit of the genesis block. */
+  genesisBlockGasLimit: bigint
+  /** The date, in seconds since the Unix epoch, of the genesis block. */
+  genesisBlockTime?: bigint
+}
 /** Configuration for runtime observability. */
 export interface ObservabilityConfig {
   /** If present, configures runtime observability to collect code coverage. */
   codeCoverage?: CodeCoverageConfig
   /** If present, configures runtime observability to collect gas reports. */
   gasReport?: GasReportConfig
+  /**
+   * Controls when to include call traces in the results of transaction
+   * execution.
+   *
+   * Defaults to `IncludeTraces.None`.
+   */
+  includeCallTraces?: IncludeTraces
 }
 /** Configuration for a provider */
 export interface ProviderConfig {
@@ -292,17 +332,20 @@ export interface ProviderConfig {
    * will be used.
    */
   baseFeeConfig?: Array<BaseFeeParamActivation>
-  /** The gas limit of each block */
-  blockGasLimit: bigint
   /** The chain ID of the blockchain */
   chainId: bigint
   /** The address of the coinbase */
   coinbase: Uint8Array
   /**
-   * The configuration for forking a blockchain. If not provided, a local
-   * blockchain will be created
+   * The default transaction gas limit to use for RPC call and transaction
+   * requests that do not specify a `gas` value.
+   */
+  defaultTransactionGasLimit: bigint
+  /**
+   * The gas estimation mode to use for `eth_estimateGas`. Defaults to
+   * `GasEstimationMode::TopLevelSuccess` if not set.
    */
-  fork?: ForkConfig
+  gasEstimationMode?: GasEstimationMode
   /** The genesis state of the blockchain */
   genesisState: Array<AccountOverride>
   /** The hardfork of the blockchain */
@@ -312,10 +355,6 @@ export interface ProviderConfig {
    * transactions and later
    */
   initialBaseFeePerGas?: bigint
-  /** The initial blob gas of the blockchain. Required for EIP-4844 */
-  initialBlobGas?: BlobGas
-  /** The initial date of the blockchain, in seconds since the Unix epoch */
-  initialDate?: bigint
   /**
    * The initial parent beacon block root of the blockchain. Required for
    * EIP-4788
@@ -325,6 +364,8 @@ export interface ProviderConfig {
   minGasPrice: bigint
   /** The configuration for the miner */
   mining: MiningConfig
+  /** The network configuration for the provider. */
+  network: ForkConfig | LocalConfig
   /** The network ID of the blockchain */
   networkId: bigint
   /** The configuration for the provider's observability */
@@ -333,6 +374,20 @@ export interface ProviderConfig {
   ownedAccounts: Array<string>
   /** Overrides for precompiles */
   precompileOverrides: Array<Precompile>
+  /**
+   * Transaction gas cap, introduced in [EIP-7825].
+   *
+   * Integer values should be larger than zero.
+   *
+   * When `false`, enforcement of the transaction gas cap is disabled and
+   * transactions with any `gas` value are accepted by the mempool and
+   * executed without REVM's transaction gas cap check.
+   *
+   * When not set, a hardfork-specific default value will be used.
+   *
+   * [EIP-7825]: https://eips.ethereum.org/EIPS/eip-7825
+   */
+  transactionGasCap?: bigint | false
 }
 /** Tracing config for Solidity stack trace generation. */
 export interface TracingConfigWithBuffers {
@@ -399,11 +454,19 @@ export enum GasReportExecutionStatus {
 export interface DeploymentGasReport {
   gas: bigint
   size: bigint
+  runtimeSize: bigint
   status: GasReportExecutionStatus
 }
 export interface FunctionGasReport {
   gas: bigint
   status: GasReportExecutionStatus
+  /**
+   * The proxy delegation chain for this call, if the called contract is a
+   * proxy. Contains contract identifiers from outermost proxy to final
+   * implementation, e.g. `["Proxy", "Implementation"]`.
+   * Empty if the call is not through a proxy.
+   */
+  proxyChain: Array<string>
 }
 export interface InstrumentationResult {
   /** The generated source code with coverage instrumentation. */
@@ -434,11 +497,15 @@ export interface InstrumentationMetadata {
    */
   readonly endUtf16: number
 }
+/** The instrumentation coverage library file name. */
+export const COVERAGE_LIBRARY_FILE_NAME: string
 /**
  * Adds per-statement coverage instrumentation to the given Solidity source
  * code.
  */
-export declare function addStatementCoverageInstrumentation(sourceCode: string, sourceId: string, solidityVersion: string, coverageLibraryPath: string): InstrumentationResult
+export declare function addStatementCoverageInstrumentation(sourceCode: string, sourceId: string, solidityVersion: string): InstrumentationResult
+/** Retrieves the latest version of `Solidity` supported for instrumentation. */
+export declare function latestSupportedSolidityVersion(): string
 /** Ethereum execution log. */
 export interface ExecutionLog {
   address: Uint8Array
@@ -492,6 +559,8 @@ export interface SuccessResult {
 export interface RevertResult {
   /** The amount of gas used */
   gasUsed: bigint
+  /** The logs */
+  logs: Array<ExecutionLog>
   /** The transaction output */
   output: Uint8Array
 }
@@ -527,6 +596,8 @@ export interface HaltResult {
    * gas limit
    */
   gasUsed: bigint
+  /** The logs */
+  logs: Array<ExecutionLog>
 }
 /** The result of executing a transaction. */
 export interface ExecutionResult {
@@ -574,6 +645,20 @@ export interface LinkReference {
   start: number
   length: number
 }
+/**Error codes that can be returned by cheatcodes in Solidity tests. */
+export enum CheatcodeErrorCode {
+  /**The specified cheatcode is not supported. */
+  UnsupportedCheatcode = 'UnsupportedCheatcode',
+  /**The specified cheatcode is missing. */
+  MissingCheatcode = 'MissingCheatcode'
+}
+/**Error returned by a cheatcode in Solidity tests. */
+export interface CheatcodeErrorDetails {
+  /**The error code representing the type of cheatcode error. */
+  code: CheatcodeErrorCode
+  /**The name of the cheatcode that caused the error. */
+  cheatcode: string
+}
 /**
  * Solidity test runner configuration arguments exposed through the ffi.
  * Docs based on <https://book.getfoundry.sh/reference/config/testing>.
@@ -586,8 +671,6 @@ export interface SolidityTestRunnerConfigArgs {
   projectRoot: string
   /** Configures the permissions of cheat codes that access the file system. */
   fsPermissions?: Array<PathPermission>
-  /** Whether to support the `testFail` prefix. Defaults to false. */
-  testFail?: boolean
   /** Address labels for traces. Defaults to none. */
   labels?: Array<AddressLabel>
   /**
@@ -635,6 +718,8 @@ export interface SolidityTestRunnerConfigArgs {
    * Defaults to `31337`.
    */
   chainId?: bigint
+  /** The hardfork to use for EVM execution. */
+  hardfork: string
   /**
    * The gas limit for each test case.
    * Defaults to `9_223_372_036_854_775_807` (`i64::MAX`).
@@ -675,6 +760,21 @@ export interface SolidityTestRunnerConfigArgs {
    * Defaults to false.
    */
   disableBlockGasLimit?: boolean
+  /**
+   * Transaction gas cap, introduced in [EIP-7825].
+   *
+   * When not set, defaults to the value defined by the used hardfork.
+   *
+   * [EIP-7825]: https://eips.ethereum.org/EIPS/eip-7825
+   */
+  transactionGasCap?: bigint
+  /**
+   * Whether to disable the [EIP-7825] transaction gas cap.
+   * Defaults to false.
+   *
+   * [EIP-7825]: https://eips.ethereum.org/EIPS/eip-7825
+   */
+  disableTransactionGasCap?: boolean
   /**
    * The memory limit of the EVM in bytes.
    * Defaults to `33_554_432` (2^25 = 32MiB).
@@ -743,6 +843,45 @@ export interface SolidityTestRunnerConfigArgs {
    * Defaults to false.
    */
   generateGasReport?: boolean
+  /**
+   * Test function level config overrides.
+   * Defaults to none.
+   */
+  testFunctionOverrides?: Array<TestFunctionOverride>
+  /**
+   * A list of EIP-712 canonical type definitions that can be referenced by
+   * type name in the `eip712HashType` and `eip712HashStruct` cheatcodes.
+   *
+   * Each entry is an independent, self-contained type definition. A
+   * definition that references nested struct types must inline those
+   * struct definitions, per the EIP-712 `encodeType` spec.
+   *
+   * Only the primary (leftmost) type of each entry is registered by name.
+   * Nested struct types referenced inside an entry are *not* registered
+   * under their own names. To look up a nested struct by name from a
+   * cheatcode, add it as a separate top-level entry whose primary type
+   * is the nested struct.
+   *
+   * The type of a struct is encoded as:
+   *
+   * `name ‖ "(" ‖ member₁ ‖ "," ‖ member₂ ‖ "," ‖ … ‖ memberₙ ")"`
+   *
+   * where each member is written as `type ‖ " " ‖ name`.
+   *
+   * Entries that fail to parse cause a startup error listing every bad
+   * entry.
+   *
+   * Example — to make both `Mail` and `Person` reachable by name:
+   *
+   * ```text
+   * "Mail(Person from,Person to,string contents)Person(address wallet,string name)"
+   * "Person(address wallet,string name)"
+   * ```
+   *
+   * With *only* the first entry, `vm.eip712HashType("Mail")` works but
+   * `vm.eip712HashType("Person")` fails with an unknown-type error.
+   */
+  eip712CanonicalTypes?: Array<string>
 }
 /** Fuzz testing configuration */
 export interface FuzzConfigArgs {
@@ -788,6 +927,16 @@ export interface FuzzConfigArgs {
    * Defaults to true.
    */
   includePushBytes?: boolean
+  /**
+   * Show `console.log` in fuzz test.
+   * Defaults to false.
+   */
+  showLogs?: boolean
+  /**
+   * Optional timeout (in seconds) for each property test.
+   * Defaults to none (no timeout).
+   */
+  timeout?: number
 }
 /** Invariant testing configuration. */
 export interface InvariantConfigArgs {
@@ -838,6 +987,17 @@ export interface InvariantConfigArgs {
    * Defaults to 5000.
    */
   shrinkRunLimit?: number
+  /**
+   * The maximum number of rejects via `vm.assume` which can be encountered
+   * during a single invariant run.
+   * Defaults to 65536.
+   */
+  maxAssumeRejects?: number
+  /**
+   * Optional timeout (in seconds) for each invariant test.
+   * Defaults to none (no timeout).
+   */
+  timeout?: number
 }
 /** Settings to configure caching of remote RPC endpoints. */
 export interface StorageCachingConfig {
@@ -921,17 +1081,104 @@ export enum CollectStackTraces {
   OnFailure = 1
 }
 /**
- * Configuration for [`SolidityTestRunnerConfigArgs::include_traces`] that
- * controls execution trace decoding and inclusion in test results.
+ * Configuration that controls whether execution traces are decoded and
+ * included in results.
+ *
+ * This can either be for Solidity test results or provider transaction
+ * execution results.
  */
 export enum IncludeTraces {
-  /** No traces will be included in any test result. */
+  /** No traces will be included at all. */
   None = 0,
-  /** Traces will be included only on the results of failed tests. */
+  /**
+   * Traces will be included only on the results of failed tests or
+   * execution.
+   */
   Failing = 1,
-  /** Traces will be included in all test results. */
+  /** Traces will be included for all test results or executed transactions. */
   All = 2
 }
+/** Test function level config override. */
+export interface TestFunctionConfigOverride {
+  /**
+   * Allow expecting reverts with `expectRevert` at the same callstack depth
+   * as the test.
+   */
+  allowInternalExpectRevert?: boolean
+  /**
+   * Whether to enable isolation of calls for the test. In isolation mode all
+   * top-level calls are executed as a separate transaction in a separate
+   * EVM context, enabling more precise gas accounting and transaction
+   * state changes.
+   * Ignored when gas reporting is enabled, as isolation is required for
+   * accurate gas measurements.
+   */
+  isolate?: boolean
+  /**
+   * The EVM version to use for this test, e.g. "Cancun". This will override
+   * the global EVM version.
+   */
+  evmVersion?: string
+  /** Configuration override for fuzz testing. */
+  fuzz?: FuzzConfigOverride
+  /** Configuration override for invariant testing. */
+  invariant?: InvariantConfigOverride
+}
+/** Test function override configuration. */
+export interface TestFunctionOverride {
+  /** The test function identifier. */
+  identifier: TestFunctionIdentifier
+  /** The configuration override. */
+  config: TestFunctionConfigOverride
+}
+/** Test function identifier. */
+export interface TestFunctionIdentifier {
+  /** The contract artifact id. */
+  contractArtifact: ArtifactId
+  /** The function selector as hex string. */
+  functionSelector: string
+}
+/**
+ * Timeout configuration.
+ * Note: This wrapper is needed to avoid ambiguity with NAPI conversion.
+ */
+export interface TimeoutConfig {
+  /** Optional timeout (in seconds). */
+  time?: number
+}
+/** Test function or test contract level fuzz config override. */
+export interface FuzzConfigOverride {
+  /** The number of test cases that must execute for each property test. */
+  runs?: number
+  /**
+   * The maximum number of test case rejections allowed by proptest, to be
+   * encountered during usage of `vm.assume` cheatcode. This will be used
+   * to set the `max_global_rejects` value in proptest test runner config.
+   * `max_local_rejects` option isn't exposed here since we're not using
+   * `prop_filter`.
+   */
+  maxTestRejects?: number
+  /** show `console.log` in fuzz test, defaults to `false`. */
+  showLogs?: boolean
+  /** Optional timeout (in seconds) for each property test. */
+  timeout?: TimeoutConfig
+}
+/** Test function or test contract level invariant config override. */
+export interface InvariantConfigOverride {
+  /** The number of runs that must execute for each invariant test group. */
+  runs?: number
+  /** The number of calls executed to attempt to break invariants in one run. */
+  depth?: number
+  /** Fails the invariant fuzzing if a revert occurs. */
+  failOnRevert?: boolean
+  /**
+   * Allows overriding an unsafe external call when running invariant tests.
+   * eg. reentrancy checks
+   */
+  callOverride?: boolean
+  /** Optional timeout (in seconds) for each invariant test. */
+  timeout?: TimeoutConfig
+}
 export declare function l1SolidityTestRunnerFactory(): SolidityTestRunnerFactory
 export declare function opSolidityTestRunnerFactory(): SolidityTestRunnerFactory
 /** A grouping of value snapshot entries for a test. */
@@ -1003,7 +1250,7 @@ export enum TestStatus {
   /**Test skipped */
   Skipped = 'Skipped'
 }
-/** See [`edr_solidity_tests::result::TestKind::Standard`] */
+/** See [`edr_solidity_tests::result::TestKind::Unit`] */
 export interface StandardTestKind {
   /** The gas consumed by the test. */
   readonly consumedGas: bigint
@@ -1034,6 +1281,16 @@ export interface InvariantTestKind {
   readonly calls: bigint
   /** See [`edr_solidity_tests::result::TestKind::Invariant`] */
   readonly reverts: bigint
+  /** See [`edr_solidity_tests::result::TestKind::Invariant`] */
+  readonly metrics: Record<string, InvariantMetrics>
+  /** See [`edr_solidity_tests::result::TestKind::Invariant`] */
+  readonly failedCorpusReplays: bigint
+}
+/** See [`edr_solidity_tests::result::InvariantMetrics`] */
+export interface InvariantMetrics {
+  readonly calls: bigint
+  readonly reverts: bigint
+  readonly discards: bigint
 }
 /**
  * Original sequence size and sequence of calls used as a counter example
@@ -1348,6 +1605,7 @@ export interface CheatcodeErrorStackTraceEntry {
   type: StackTraceEntryType.CHEATCODE_ERROR
   message: string
   sourceReference: SourceReference
+  details?: CheatcodeErrorDetails
 }
 export interface TracingMessage {
   /** Sender address */
@@ -1392,11 +1650,6 @@ export interface TracingMessageResult {
   /** Execution result */
   readonly executionResult: ExecutionResult
 }
-/**
- * Returns the latest version of solc that EDR officially
- * supports and is tested against.
- */
-export declare function getLatestSupportedSolcVersion(): string
 export interface Withdrawal {
   /** The index of withdrawal */
   index: bigint
@@ -1455,9 +1708,15 @@ export declare class Response {
   /**Returns the response data as a JSON string or a JSON object. */
   get data(): string | any
   /**Compute the error stack trace. Return the stack trace if it can be decoded, otherwise returns none. Throws if there was an error computing the stack trace. */
-  stackTrace(): SolidityStackTrace | null
-  /**Returns the raw traces of executed contracts. This maybe contain zero or more traces. */
-  get traces(): Array<RawTrace>
+  stackTrace(): StackTrace | UnexpectedError | HeuristicFailed | null
+  /**
+   * Constructs the execution traces for the request. Returns an empty array
+   * if traces are not enabled for this provider according to
+   * [`crate::solidity_tests::config::SolidityTestRunnerConfigArgs::include_traces`]. Otherwise, returns
+   * an array of the root calls of the trace, which always includes the
+   * request's call itself.
+   */
+  callTraces(): Array<CallTrace>
 }
 /** A JSON-RPC provider for Ethereum. */
 export declare class Provider {

package/index.js

@@ -310,7 +310,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { GENERIC_CHAIN_TYPE, genericChainProviderFactory, L1_CHAIN_TYPE, l1GenesisState, l1ProviderFactory, SpecId, l1HardforkFromString, l1HardforkToString, l1HardforkLatest, FRONTIER, FRONTIER_THAWING, HOMESTEAD, DAO_FORK, TANGERINE, SPURIOUS_DRAGON, BYZANTIUM, CONSTANTINOPLE, PETERSBURG, ISTANBUL, MUIR_GLACIER, BERLIN, LONDON, ARROW_GLACIER, GRAY_GLACIER, MERGE, SHANGHAI, CANCUN, PRAGUE, OpHardfork, opHardforkFromString, opHardforkToString, opLatestHardfork, OP_CHAIN_TYPE, opGenesisState, opProviderFactory, BEDROCK, REGOLITH, CANYON, ECOTONE, FJORD, GRANITE, HOLOCENE, ISTHMUS, MineOrdering, EdrContext, ContractDecoder, GasReportExecutionStatus, addStatementCoverageInstrumentation, Precompile, precompileP256Verify, ProviderFactory, Response, Provider, SuccessReason, ExceptionalHalt, CachedChains, CachedEndpoints, FsAccessPermission, CollectStackTraces, IncludeTraces, SolidityTestRunnerFactory, l1SolidityTestRunnerFactory, opSolidityTestRunnerFactory, SuiteResult, TestResult, TestStatus, CallKind, LogKind, linkHexStringBytecode, printStackTrace, Exit, ExitCode, BytecodeWrapper, ContractFunctionType, ReturnData, StackTraceEntryType, stackTraceEntryTypeToString, FALLBACK_FUNCTION_NAME, RECEIVE_FUNCTION_NAME, CONSTRUCTOR_FUNCTION_NAME, UNRECOGNIZED_FUNCTION_NAME, UNKNOWN_FUNCTION_NAME, PRECOMPILE_FUNCTION_NAME, UNRECOGNIZED_CONTRACT_NAME, RawTrace, getLatestSupportedSolcVersion } = nativeBinding
+const { GENERIC_CHAIN_TYPE, genericChainProviderFactory, L1_CHAIN_TYPE, l1GenesisState, l1ProviderFactory, SpecId, l1HardforkFromString, l1HardforkToString, l1HardforkLatest, FRONTIER, FRONTIER_THAWING, HOMESTEAD, DAO_FORK, TANGERINE, SPURIOUS_DRAGON, BYZANTIUM, CONSTANTINOPLE, PETERSBURG, ISTANBUL, MUIR_GLACIER, BERLIN, LONDON, ARROW_GLACIER, GRAY_GLACIER, MERGE, SHANGHAI, CANCUN, PRAGUE, OSAKA, OpHardfork, opHardforkFromString, opHardforkToString, opLatestHardfork, OP_CHAIN_TYPE, opGenesisState, opProviderFactory, BEDROCK, REGOLITH, CANYON, ECOTONE, FJORD, GRANITE, HOLOCENE, ISTHMUS, GasEstimationMode, MineOrdering, EdrContext, ContractDecoder, GasReportExecutionStatus, COVERAGE_LIBRARY_FILE_NAME, addStatementCoverageInstrumentation, latestSupportedSolidityVersion, Precompile, precompileP256Verify, ProviderFactory, Response, Provider, SuccessReason, ExceptionalHalt, CheatcodeErrorCode, CachedChains, CachedEndpoints, FsAccessPermission, CollectStackTraces, IncludeTraces, SolidityTestRunnerFactory, l1SolidityTestRunnerFactory, opSolidityTestRunnerFactory, SuiteResult, TestResult, TestStatus, CallKind, LogKind, linkHexStringBytecode, printStackTrace, Exit, ExitCode, BytecodeWrapper, ContractFunctionType, ReturnData, StackTraceEntryType, stackTraceEntryTypeToString, FALLBACK_FUNCTION_NAME, RECEIVE_FUNCTION_NAME, CONSTRUCTOR_FUNCTION_NAME, UNRECOGNIZED_FUNCTION_NAME, UNKNOWN_FUNCTION_NAME, PRECOMPILE_FUNCTION_NAME, UNRECOGNIZED_CONTRACT_NAME, RawTrace } = nativeBinding
 
 module.exports.GENERIC_CHAIN_TYPE = GENERIC_CHAIN_TYPE
 module.exports.genericChainProviderFactory = genericChainProviderFactory
@@ -340,6 +340,7 @@ module.exports.MERGE = MERGE
 module.exports.SHANGHAI = SHANGHAI
 module.exports.CANCUN = CANCUN
 module.exports.PRAGUE = PRAGUE
+module.exports.OSAKA = OSAKA
 module.exports.OpHardfork = OpHardfork
 module.exports.opHardforkFromString = opHardforkFromString
 module.exports.opHardforkToString = opHardforkToString
@@ -355,11 +356,14 @@ module.exports.FJORD = FJORD
 module.exports.GRANITE = GRANITE
 module.exports.HOLOCENE = HOLOCENE
 module.exports.ISTHMUS = ISTHMUS
+module.exports.GasEstimationMode = GasEstimationMode
 module.exports.MineOrdering = MineOrdering
 module.exports.EdrContext = EdrContext
 module.exports.ContractDecoder = ContractDecoder
 module.exports.GasReportExecutionStatus = GasReportExecutionStatus
+module.exports.COVERAGE_LIBRARY_FILE_NAME = COVERAGE_LIBRARY_FILE_NAME
 module.exports.addStatementCoverageInstrumentation = addStatementCoverageInstrumentation
+module.exports.latestSupportedSolidityVersion = latestSupportedSolidityVersion
 module.exports.Precompile = Precompile
 module.exports.precompileP256Verify = precompileP256Verify
 module.exports.ProviderFactory = ProviderFactory
@@ -367,6 +371,7 @@ module.exports.Response = Response
 module.exports.Provider = Provider
 module.exports.SuccessReason = SuccessReason
 module.exports.ExceptionalHalt = ExceptionalHalt
+module.exports.CheatcodeErrorCode = CheatcodeErrorCode
 module.exports.CachedChains = CachedChains
 module.exports.CachedEndpoints = CachedEndpoints
 module.exports.FsAccessPermission = FsAccessPermission
@@ -397,4 +402,3 @@ module.exports.UNKNOWN_FUNCTION_NAME = UNKNOWN_FUNCTION_NAME
 module.exports.PRECOMPILE_FUNCTION_NAME = PRECOMPILE_FUNCTION_NAME
 module.exports.UNRECOGNIZED_CONTRACT_NAME = UNRECOGNIZED_CONTRACT_NAME
 module.exports.RawTrace = RawTrace
-module.exports.getLatestSupportedSolcVersion = getLatestSupportedSolcVersion