improved some comments

Author: felix314159

src/ethereum_test_types/blob_types.py

@@ -54,13 +54,13 @@ class Blob(CamelModel):
     data: Bytes
     commitment: Bytes
     proof: List[Bytes] | Bytes  # Bytes < Osaka, List[Bytes] >= Osaka
-    cells: List[Bytes] | None  # None (in json: null)  < Osaka, List[Bytes] >= Osaka
+    cells: List[Bytes] | None  # None (in json: null) < Osaka, List[Bytes] >= Osaka
 
     versioned_hash: Hash
-    name: str  # blob_<fork>_<seed>
+    name: str
     fork: Fork
     seed: int
-    timestamp: int
+    timestamp: int  # fork transitions require timestamp >= 15000 to occur
 
     _trusted_setup: ClassVar[Any | None] = None
 
@@ -149,7 +149,7 @@ def get_commitment(data: Bytes) -> Bytes:
             """
             Take a blob and returns a cryptographic commitment to it.
 
-            Note: Each cell seems to hold a copy of this commitment.
+            Note: Each cell holds the exact same copy of this commitment.
             """
             # sanity check
             field_elements: int = cast(int, fork.get_blob_constant("FIELD_ELEMENTS_PER_BLOB"))
@@ -181,7 +181,7 @@ def get_proof(fork: Fork, data: Bytes) -> List[Bytes] | Bytes:
                 proof, _ = ckzg.compute_kzg_proof(data, z_valid_size, Blob._trusted_setup)
                 return proof
 
-            # osaka
+            # >=osaka
             if amount_cell_proofs == 128:
                 _, proofs = ckzg.compute_cells_and_kzg_proofs(
                     data, Blob._trusted_setup
@@ -201,7 +201,7 @@ def get_cells(fork: Fork, data: Bytes) -> List[Bytes] | None:
             if amount_cell_proofs == 0:
                 return None
 
-            # osaka
+            # >=osaka
             if amount_cell_proofs == 128:
                 cells, _ = ckzg.compute_cells_and_kzg_proofs(
                     data, Blob._trusted_setup
@@ -406,12 +406,10 @@ def corrupt_byte(b: bytes) -> Bytes:
                 raise ValueError("Input must be a single byte")
             return Bytes(bytes([b[0] ^ 0xFF]))
 
-        # osaka and later
+        # >=osaka
         amount_cell_proofs: int = cast(int, self.fork.get_blob_constant("AMOUNT_CELL_PROOFS"))
         if amount_cell_proofs > 0:
-            assert isinstance(self.proof, list), (
-                "proof was expected to be a list but it isn't"
-            )  # make mypy happy
+            assert isinstance(self.proof, list), "proof was expected to be a list but it isn't"
 
             if mode == self.ProofCorruptionMode.CORRUPT_FIRST_BYTE:
                 for i in range(len(self.proof)):