Skip to content

Debugging#

Using Python debugger#

Both commands woke test and woke fuzz support entering pdb, the Python debugger, when an error occurs. Woke uses an enhanced version of the Python debugger, ipdb, which provides a more user-friendly interface.

It is also possible to enter the debugger manually by inserting a breakpoint() statement in the code.

from woke.testing import *

@default_chain.connect()
def test_breakpoint():
    breakpoint()
    block = default_chain.blocks[0]

Info

breakpoint() is not currently supported with woke fuzz.

Inside ipdb, any expression can be evaluated by typing it and pressing Enter. This can be used to get the value of a variable, to call a function, including contract functions, or even to deploy a new contract.

Useful commands:

  • h or help: show help
  • c or continue: continue execution
  • n or next: step over the next line
  • l or list: show the current line and a few lines around it
  • q or quit: quit the debugger
  • up or down: move up or down the call stack

Call traces#

Every transaction object has a call_trace property that visualizes the call stack of the transaction. It can be used to debug failing transactions.

External contracts in forking mode

When using forking mode (see connect keyword arguments), already present contracts are printed as unknown contracts in call traces. To show contract and function names, configure your API key for a given chain explorer.

from woke.testing import *
from pytypes.contracts.Counter import Counter
from pytypes.contracts.Gateway import Gateway

@default_chain.connect()
def test_call_trace():
    default_chain.set_default_accounts(default_chain.accounts[0])

    gateway = Gateway.deploy()
    counter = Counter.deploy()
    counter.addToWhitelist(gateway)

    tx = gateway.execute(
        counter,
        Abi.encode_call(counter.decrement, []),
        confirmations=0,
    )
    print(tx.call_trace)

    tx = gateway.execute(
        counter,
        Abi.encode_call(counter.increment, []),
    )
    print(tx.call_trace)
Woke Gateway.execute('0xe7f1725e77...43e90bb3f0512', b'+\xae\xce\xb7')✗ └── Counter.decrement()✗ Gateway.execute('0xe7f1725e77...43e90bb3f0512', b'\xd0\x9d\xe0\x8a')✓ └── Counter.increment()✓ └── console.log('Incremented count to', 1)✓[STATICCALL]

Info

Internal calls are not currently visualized in call traces.

Console logs#

Using the console.sol library from Hardhat may be the easiest way to debug a contract. Logs can be accessed through the console_logs property of a transaction object. Console logs are available even for failed transactions.

from woke.testing import *
from pytypes.contracts.Counter import Counter

@default_chain.connect()
def test_console_logs():
    default_chain.tx_callback = lambda tx: print(tx.console_logs)
    default_chain.set_default_accounts(default_chain.accounts[0])

    counter = Counter.deploy()
    counter.increment()
    counter.setCount(42)

Woke-integrated console.sol

Woke integrates the console.sol library implementing the same functionalities as Hardhat's console.sol. It can serve as a drop-in replacement in case that the tested project is not using Hardhat.

import "woke/console.sol";

contract MyContract {
    function myFunction() public view {
        console.log("Hello world!");
    }
}

Info

Accessing transaction console_logs is not currently supported with Hardhat and Ganache.