BoaError

Description

Exception raised when contract execution fails. Contains detailed debugging information including call trace and stack trace.

Properties

• call_trace - Visual representation of the call hierarchy
• stack_trace - Detailed execution trace with source code context

Usage

import boa

contract = boa.loads('''
@external
def fail():
    raise "something went wrong"
''')

try:
    contract.fail()
except boa.BoaError as e:
    print(e.stack_trace)
    print(e.call_trace)

Error Matching

Use with boa.reverts() context manager for testing expected failures:

with boa.reverts("something went wrong"):
    contract.fail()