Truffle includes an integrated debugger so that you can debug transactions made against your contracts. This debugger looks and feels like existing command line debuggers available for traditional development environments.
In order to debug transactions, you'll need the following:
- Truffle 4.0 or above.
- The hash of a transaction on your desired blockchain.
- The source code and artifacts the transaction encounters.
Note that it's okay if your desired transaction resulted in an exception or if it ran out of gas. The transaction still exists on chain, and so you can still debug it!
To use the debugger, gather the transaction you'd like to debug then run the following:
$ truffle debug <transaction hash>
Using a transaction starting with
0x8e5dadfb921dd... as an example, the command would look as follows:
$ truffle debug 0x8e5dadfb921ddddfa8f53af1f9bd8beeac6838d52d7e0c2fe5085b42a4f3ca76
This will launch the debugging interface described below.
Starting the debugger will open an interface familiar to those that have debugged other types of applications. When it starts, you'll see the following:
- A list of addresses either transacted against or created during the course of this transaction.
- A list of available commands for using the debugger.
- And the initial entry point for the transaction, including contract source file and code preview.
enter key is set to perform the last command entered. When the debugger starts, the
enter key is set to step to the next logical source code element encountered during execution (i.e., the next expression or statement evaluated by the Ethereum virtual machine). At this point you can press
enter to step through the transaction, or enter one of the available commands to analyze the transaction in more detail. The list of commands is detailed below.
This command steps over the current line, relative to the position of the statement or expression currently being evaluated in the Solidity source file. Use this command if you don't want to step into a function call or contract creation on the current line, or if you'd like to quickly jump to a specific point in the source file.
This command steps into the function call or contract creation currently being evaluated. Use this command to jump into the function and quickly start debugging the code that exists there.
This command steps out of the currently running function. Use this command to quickly get back to the calling function, or end execution of the transaction if this was the entry point of the transaction.
This command steps to the next logical statement or expression in the source code. For example, evaluating sub expressions will need to occur first before the virtual machine can evaluate the full expression. Use this command if you'd like to analyze each logical item the virtual machine evaluates.
This command allows you to step through each individual instruction evaluated by the virtual machine. This is useful if you're interested in understanding the low level bytecode created by the Solidity source code. When you use this command, the debugger will also print out the stack data at the time the instruction was evaluated.
This commands prints the current instruction and stack data, but does not step to the next instruction. Use this when you'd like to see the current instruction and stack data after navigating through the transaction with the logical commands described above.
Print the list of available commands.
Quit the debugger.