Description

traceCallruns an eth_call with the context of the provided block execution using the final state of the parent block as the base.

Parameters

Response

The traceCall method returns a Promise<DebugCallTrace>response object with the following properties.

Example Request and Response

Prerequisite: You will need to install the Alchemy SDK before making requests with it.

The commands for installing it using npm or yarn are given below:

npm install alchemy-sdk@latest

yarn add alchemy-sdk@latest

Request

Here is an example of how to make a traceCall request using the Alchemy SDK:

// Imports the Alchemy SDK
const { Alchemy, Network } = require("alchemy-sdk");

// Configures the Alchemy SDK
const config = {
  apiKey: "demo", // Replace with your API key
  network: Network.ETH_MAINNET, // Replace with your network
};

// Creates an Alchemy object instance with the config to use for making requests
const alchemy = new Alchemy(config);

// Example of using the traceCall method
const main = async () => {
  // The transaction to debug trace.
  let transaction = {
    from: "0x6f1FB6EFDf50F34bFA3F2bC0E5576EdD71631638",
    to: "0x6b175474e89094c44da98b954eedeac495271d0f",
    value: "0x0",
    data: "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE",
  };

  // The block to debug the transaction in.
  let block = "latest";

  // Tracer type and configuration.
  let tracerConfig = {
    type: "callTracer",
    onlyTopCall: true,
  };

  // Calling the traceCall method
  let response = await alchemy.debug.traceCall(
    transaction,
    block,
    tracerConfig
  );

  // Logging the response to the console
  console.log(response);
};

main();

Response

And here is an example of what a successful response to this request might look like:

{
    "from": "0x6f1fb6efdf50f34bfa3f2bc0e5576edd71631638",
    "gas": "0x7fffffffffffffff",
    "gasUsed": "0x5de2",
    "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
    "input": "0x70a082310000000000000000000000006e0d01a76c3cf4288372a29124a26d4353ee51be",
    "output": "0x0000000000000000000000000000000000000000000000000858898f93629000",
    "value": "0x0",
    "type": "CALL"
}

Code Sandbox

You can test the traceCall method using the code sandbox below:

Use Cases

Some of the use cases for traceCall are:

• Debugging Contract Issues: Developers can use the traceCall method to diagnose and fix issues with smart contract execution by tracing the flow of execution and the state changes made by the contract.

• Optimizing Contract Performance: Developers can use the traceCall method to identify and optimize slow or inefficient sections of code by tracing the execution and gas consumption of smart contract calls.

• Verifying Contract Security: Security auditors can use the traceCall method to verify the security of smart contracts by tracing the execution of malicious inputs and evaluating the contract's response.

• Improving Contract User Experience: Developers can use the traceCall method to improve the user experience of smart contract interactions by tracing the execution of user inputs and evaluating the contract's response.

Related Methods

Here are the methods related to traceCall:

• traceTransaction: Attempts to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it and will then attempt to execute the transaction that corresponds to the given hash.
• traceBlock: Replays a block that has already been mined.