ethereum.forks.shanghai.utils.messageethereum.forks.cancun.utils.message

Hardfork Utility Functions For The Message Data-structure.

.. contents:: Table of Contents :backlinks: none :local:

Introduction

Message specific functions used in this shanghai version ofMessage specific functions used in this cancun version of specification.

prepare_message

Execute a transaction against the provided environment.

Parameters

block_env : Environment for the Ethereum Virtual Machine. tx_env : Environment for the transaction. tx : Transaction to be executed.

Returns

message: ethereum.forks.shanghai.vm.Messageethereum.forks.cancun.vm.Message Items containing contract creation or message call specific data.

def prepare_message(​block_env: BlockEnvironment, ​​tx_env: TransactionEnvironment, ​​tx: Transaction​) -> Message:
32
    """
33
    Execute a transaction against the provided environment.
34
35
    Parameters
36
    ----------
37
    block_env :
38
        Environment for the Ethereum Virtual Machine.
39
    tx_env :
40
        Environment for the transaction.
41
    tx :
42
        Transaction to be executed.
43
44
    Returns
45
    -------
46
    message: `ethereum.forks.shanghai.vm.Message`
46
    message: `ethereum.forks.cancun.vm.Message`
47
        Items containing contract creation or message call specific data.
48
49
    """
50
    accessed_addresses = set()
51
    accessed_addresses.add(tx_env.origin)
52
    accessed_addresses.update(PRE_COMPILED_CONTRACTS.keys())
53
    accessed_addresses.update(tx_env.access_list_addresses)
54
55
    if isinstance(tx.to, Bytes0):
56
        current_target = compute_contract_address(
57
            tx_env.origin,
58
            get_account(block_env.state, tx_env.origin).nonce - Uint(1),
59
        )
60
        msg_data = Bytes(b"")
61
        code = tx.data
62
        code_address = None
63
    elif isinstance(tx.to, Address):
64
        current_target = tx.to
65
        msg_data = tx.data
66
        state = block_env.state
67
        code = get_code(state, get_account(state, tx.to).code_hash)
68
69
        code_address = tx.to
70
    else:
71
        raise AssertionError("Target must be address or empty bytes")
72
73
    accessed_addresses.add(current_target)
74
75
    return Message(
76
        block_env=block_env,
77
        tx_env=tx_env,
78
        caller=tx_env.origin,
79
        target=tx.to,
80
        gas=tx_env.gas,
81
        value=tx.value,
82
        data=msg_data,
83
        code=code,
84
        depth=Uint(0),
85
        current_target=current_target,
86
        code_address=code_address,
87
        should_transfer_value=True,
88
        is_static=False,
89
        accessed_addresses=accessed_addresses,
90
        accessed_storage_keys=set(tx_env.access_list_storage_keys),
91
        parent_evm=None,
92
    )