Clarify public API and store comments (#3479)

Signed-off-by: zerozebrazone <zerozebrazone@outlook.com>

Author: zerozebrazone

block/public.go

@@ -19,7 +19,7 @@ func DefaultBlockOptions() BlockOptions {
 	return common.DefaultBlockOptions()
 }
 
-// Expose Metrics for constructor
+// Expose the Metrics type for constructors
 type Metrics = common.Metrics
 
 // PrometheusMetrics creates a new PrometheusMetrics instance with the given namespace and labelsAndValues.
@@ -100,5 +100,5 @@ func NewForcedInclusionRetriever(
 	)
 }
 
-// Expose Raft types for consensus integration
+// Expose the Raft node type for consensus integration
 type RaftNode = common.RaftNode

pkg/store/store.go

@@ -40,8 +40,8 @@ func (s *DefaultStore) Height(ctx context.Context) (uint64, error) {
 		return 0, nil
 	}
 	if err != nil {
-		// Since we can't return an error due to interface constraints,
-		// we log by returning 0 when there's an error reading from disk
+		// Since we can return an error alongside the height,
+		// we return 0 when there's an error reading from disk
 		return 0, err
 	}