feat(test-forks): EIP-8037 add SELFDESTRUCT refund

Author: marioevz

packages/testing/src/execution_testing/forks/forks/eips/amsterdam/eip_8037.py

@@ -183,9 +183,10 @@ def opcode_refund_calculator(cls) -> OpcodeGasCalculator:
 
         def fn(opcode: OpcodeBase) -> int:
             # Get the gas refund or calculator
+            state_refund = opcode_state_refund_calculator(opcode)
             if opcode not in opcode_refund_map:
                 # Most opcodes don't provide refunds
-                return 0
+                return state_refund
             refund_or_calculator = opcode_refund_map[opcode]
 
             # If it's a callable, call it with the opcode
@@ -196,7 +197,7 @@ def fn(opcode: OpcodeBase) -> int:
                 regular_refund = refund_or_calculator
 
             # EIP-8037 adds the state refund on top of the regular refund.
-            return regular_refund + opcode_state_refund_calculator(opcode)
+            return regular_refund + state_refund
 
         return fn
 
@@ -217,6 +218,11 @@ def opcode_state_refund_map(
             Opcodes.SSTORE: lambda op: cls._calculate_sstore_state_refund(
                 op, gas_costs
             ),
+            Opcodes.SELFDESTRUCT: (
+                lambda op: cls._calculate_selfdestruct_state_refund(
+                    op, gas_costs
+                )
+            ),
         }
 
     @classmethod
@@ -386,6 +392,37 @@ def _calculate_sstore_state_refund(
                     return 32 * cpsb
         return 0
 
+    @classmethod
+    def _calculate_selfdestruct_state_refund(
+        cls, opcode: OpcodeBase, gas_costs: GasCosts
+    ) -> int:
+        """
+        Calculate SELFDESTRUCT state gas refund.
+
+        Account creation: 112 × cost_per_state_byte
+        Created storage slots: 32 × cost_per_state_byte per non-zero slot
+        Code deposit: len(code) × cost_per_state_byte
+        """
+        del gas_costs
+        metadata = opcode.metadata
+        cpsb = cls.cost_per_state_byte()
+
+        self_destructed_account = metadata["self_destructed_account"]
+        self_destructed_account_storage_slot_count = metadata[
+            "self_destructed_account_storage_slot_count"
+        ]
+        self_destructed_account_code_deposit = metadata[
+            "self_destructed_account_code_deposit"
+        ]
+        state_refund = 0
+        if self_destructed_account:
+            state_refund = 112 * cpsb
+            state_refund += (
+                32 * cpsb * self_destructed_account_storage_slot_count
+            )
+            state_refund += cpsb * self_destructed_account_code_deposit
+        return state_refund
+
     @classmethod
     def _calculate_return_gas(
         cls, opcode: OpcodeBase, gas_costs: GasCosts

packages/testing/src/execution_testing/vm/opcodes.py

@@ -5617,7 +5617,13 @@ class Opcodes(Opcode, Enum):
         0xFF,
         popped_stack_items=1,
         kwargs=["address"],
-        metadata={"address_warm": False, "account_new": False},
+        metadata={
+            "address_warm": False,
+            "account_new": False,
+            "self_destructed_account": False,
+            "self_destructed_account_storage_slot_count": 0,
+            "self_destructed_account_code_deposit": 0,
+        },
     )
     """
     SELFDESTRUCT(address)
@@ -5645,6 +5651,12 @@ class Opcodes(Opcode, Enum):
                     (default: False)
     - account_new: whether creating a new beneficiary account, requires
                    non-zero balance in the source account (default: False)
+    - self_destructed_account: whether the execution results in an account
+            self-destructing (default: False)
+    - self_destructed_account_storage_slot_count: amount of storage slots that
+            were created in the self-destructing account (default: 0)
+    - self_destructed_account_code_deposit: amount of bytes that comprised the
+            code of the self-destructing account (default: 0)
 
     Source: [evm.codes/#FF](https://www.evm.codes/#FF)
     """