chore: fix various comments (#31082)

core/vm/eof_validation_test.go

@@ -363,7 +363,7 @@ func BenchmarkEOFValidation(b *testing.B) {
 	}
 }
 
-// BenchmarkEOFValidation tries to benchmark the code validation for the CALLF/RETF operation.
+// BenchmarkEOFValidation2 tries to benchmark the code validation for the CALLF/RETF operation.
 // For this we set up code that calls into 1024 code sections which
 // - contain calls to some other code sections.
 // We can't have all code sections calling each other, otherwise we would exceed 48KB.

tests/fuzzers/bls12381/bls12381_fuzz.go

@@ -346,7 +346,7 @@ func multiExpG1Gnark(gs []gnark.G1Affine, scalars []fr.Element) gnark.G1Affine {
 	return res
 }
 
-// multiExpG1Gnark is a naive implementation of G1 multi-exponentiation
+// multiExpG2Gnark is a naive implementation of G2 multi-exponentiation
 func multiExpG2Gnark(gs []gnark.G2Affine, scalars []fr.Element) gnark.G2Affine {
 	res := gnark.G2Affine{}
 	for i := 0; i < len(gs); i++ {

triedb/pathdb/database.go

@@ -471,8 +471,8 @@ func (db *Database) Recoverable(root common.Hash) bool {
 	if id == nil {
 		return false
 	}
-	// Recoverable state must below the disk layer. The recoverable
+	// Recoverable state must be below the disk layer. The recoverable
-	// state only refers the state that is currently not available,
+	// state only refers to the state that is currently not available,
 	// but can be restored by applying state history.
 	dl := db.tree.bottom()
 	if *id >= dl.stateID() {

triedb/pathdb/difflayer.go

@@ -27,8 +27,8 @@ import (
 // diffLayer represents a collection of modifications made to the in-memory tries
 // along with associated state changes after running a block on top.
 //
-// The goal of a diff layer is to act as a journal, tracking recent modifications
+// The purpose of a diff layer is to serve as a journal, recording recent state modifications
-// made to the state, that have not yet graduated into a semi-immutable state.
+// that have not yet been committed to a more stable or semi-permanent state.
 type diffLayer struct {
 	// Immutables
 	root   common.Hash         // Root hash to which this layer diff belongs to