fix: documentation clarity

Author: EperezOk

src/ethereum/arrow_glacier/fork.py

@@ -705,8 +705,8 @@ def process_transaction(
     Execute a transaction against the provided environment.
 
     This function processes the actions needed to execute a transaction.
-    It decrements the sender's account after calculating the gas fee and
-    refunds them the proper amount after execution. Calling contracts,
+    It decrements the sender's account balance after calculating the gas fee
+    and refunds them the proper amount after execution. Calling contracts,
     deploying code, and incrementing nonces are all examples of actions that
     happen within this function or from a call made within this function.
 

src/ethereum/arrow_glacier/state.py

@@ -96,7 +96,7 @@ def commit_transaction(state: State) -> None:
 def rollback_transaction(state: State) -> None:
     """
     Rollback a state transaction, resetting the state to the point when the
-    corresponding `start_transaction()` call was made.
+    corresponding `begin_transaction()` call was made.
 
     Parameters
     ----------
@@ -420,7 +420,7 @@ def account_exists_and_is_empty(state: State, address: Address) -> bool:
 
 def is_account_alive(state: State, address: Address) -> bool:
     """
-    Check whether is an account is both in the state and non empty.
+    Check whether an account is both in the state and non-empty.
 
     Parameters
     ----------

src/ethereum/arrow_glacier/vm/interpreter.py

@@ -91,7 +91,7 @@ class MessageCallOutput:
 
 def process_message_call(message: Message) -> MessageCallOutput:
     """
-    If `message.current` is empty then it creates a smart contract
+    If `message.target` is empty then it creates a smart contract
     else it executes a call from the `message.caller` to the `message.target`.
 
     Parameters

src/ethereum/berlin/fork.py

@@ -598,8 +598,8 @@ def process_transaction(
     Execute a transaction against the provided environment.
 
     This function processes the actions needed to execute a transaction.
-    It decrements the sender's account after calculating the gas fee and
-    refunds them the proper amount after execution. Calling contracts,
+    It decrements the sender's account balance after calculating the gas fee
+    and refunds them the proper amount after execution. Calling contracts,
     deploying code, and incrementing nonces are all examples of actions that
     happen within this function or from a call made within this function.
 

src/ethereum/berlin/state.py

@@ -96,7 +96,7 @@ def commit_transaction(state: State) -> None:
 def rollback_transaction(state: State) -> None:
     """
     Rollback a state transaction, resetting the state to the point when the
-    corresponding `start_transaction()` call was made.
+    corresponding `begin_transaction()` call was made.
 
     Parameters
     ----------
@@ -420,7 +420,7 @@ def account_exists_and_is_empty(state: State, address: Address) -> bool:
 
 def is_account_alive(state: State, address: Address) -> bool:
     """
-    Check whether is an account is both in the state and non empty.
+    Check whether an account is both in the state and non-empty.
 
     Parameters
     ----------

src/ethereum/berlin/vm/interpreter.py

@@ -90,7 +90,7 @@ class MessageCallOutput:
 
 def process_message_call(message: Message) -> MessageCallOutput:
     """
-    If `message.current` is empty then it creates a smart contract
+    If `message.target` is empty then it creates a smart contract
     else it executes a call from the `message.caller` to the `message.target`.
 
     Parameters

src/ethereum/byzantium/fork.py

@@ -590,8 +590,8 @@ def process_transaction(
     Execute a transaction against the provided environment.
 
     This function processes the actions needed to execute a transaction.
-    It decrements the sender's account after calculating the gas fee and
-    refunds them the proper amount after execution. Calling contracts,
+    It decrements the sender's account balance after calculating the gas fee
+    and refunds them the proper amount after execution. Calling contracts,
     deploying code, and incrementing nonces are all examples of actions that
     happen within this function or from a call made within this function.
 

src/ethereum/byzantium/state.py

@@ -92,7 +92,7 @@ def commit_transaction(state: State) -> None:
 def rollback_transaction(state: State) -> None:
     """
     Rollback a state transaction, resetting the state to the point when the
-    corresponding `start_transaction()` call was made.
+    corresponding `begin_transaction()` call was made.
 
     Parameters
     ----------
@@ -394,7 +394,7 @@ def account_exists_and_is_empty(state: State, address: Address) -> bool:
 
 def is_account_alive(state: State, address: Address) -> bool:
     """
-    Check whether is an account is both in the state and non empty.
+    Check whether an account is both in the state and non-empty.
 
     Parameters
     ----------

src/ethereum/byzantium/vm/interpreter.py

@@ -89,7 +89,7 @@ class MessageCallOutput:
 
 def process_message_call(message: Message) -> MessageCallOutput:
     """
-    If `message.current` is empty then it creates a smart contract
+    If `message.target` is empty then it creates a smart contract
     else it executes a call from the `message.caller` to the `message.target`.
 
     Parameters

src/ethereum/cancun/fork.py

@@ -675,8 +675,8 @@ def process_transaction(
     Execute a transaction against the provided environment.
 
     This function processes the actions needed to execute a transaction.
-    It decrements the sender's account after calculating the gas fee and
-    refunds them the proper amount after execution. Calling contracts,
+    It decrements the sender's account balance after calculating the gas fee
+    and refunds them the proper amount after execution. Calling contracts,
     deploying code, and incrementing nonces are all examples of actions that
     happen within this function or from a call made within this function.