Skip to content
Tevm Docs

traceCallHandler

traceCallHandler(client): DebugTraceCallHandler

Returns a trace of an eth_call within the context of the given block execution using the final state of the parent block

Parameters

• client

• client.extend

Extends the base client with additional functionality. This enables optimal code splitting and extensibility

• client.forkUrl?: string

Fork url if the EVM is forked

Example

const client = createMemoryClient({ forkUrl: 'https://mainnet.infura.io/v3/your-api-key' })
console.log(client.forkUrl)

• client.getChainCommon

Returns the chain being used by the client. THis type extends both viem Chain and ethereumjs Common This is the same object on getVm().common

• client.getReceiptsManager

Interface for querying receipts and historical state

• client.getTxPool

Gets the pool of pending transactions to be included in next block

• client.getVm

Internal instance of the VM. Can be used for lower level operations. Normally not recomended to use unless building libraries or extensions on top of Tevm.

• client.logger: Logger

The logger instance

• client.miningConfig: MiningConfig

The configuration for mining. Defaults to ‘auto'

  • 'auto’ will mine a block on every transaction
  • ’interval’ will mine a block every interval milliseconds
  • ’manual’ will not mine a block automatically and requires a manual call to mineBlock

• client.mode: "fork" | "normal"

The mode the current client is running in fork mode will fetch and cache all state from the block forked from the provided URL normal mode will not fetch any state and will only run the EVM in memory

Example

let client = createMemoryClient()
console.log(client.mode) // 'normal'
client = createMemoryClient({ forkUrl: 'https://mainnet.infura.io/v3/your-api-key' })
console.log(client.mode) // 'fork'

• client.ready

Returns promise that resulves when the client is ready The client is usable without calling this method but may have extra latency on the first call from initialization

Example

const client = createMemoryClient()
await client.ready()

Returns

DebugTraceCallHandler

an execution trace of an eth_call in the context of a given block execution mirroring the output from traceTransaction

Source

packages/actions/src/debug/traceCallHandler.js:11