Add clarifying comments and fix documentation inconsistency

Co-authored-by: Steake <530040+Steake@users.noreply.github.com>

Author: Copilot

crates/bitcell-state/src/storage.rs

@@ -254,8 +254,11 @@ impl StorageManager {
                 continue; // Invalid key format (too short)
             }
 
-            // Check if sender portion matches exactly
-            // This ensures we don't match longer senders that share a prefix
+            // Check if sender portion matches exactly.
+            // This break is intentional: RocksDB's prefix_iterator may return keys for longer
+            // senders that share the same initial bytes (e.g., when searching for "abc", it
+            // might also return keys starting with "abcd"). We break as soon as the prefix
+            // no longer matches exactly to avoid returning transactions from other senders.
             if &key[0..sender.len()] != sender {
                 break; // No longer matching our sender prefix
             }

crates/bitcell-state/tests/storage_persistence_test.rs

@@ -228,7 +228,7 @@ fn test_snapshot_based_recovery() {
         assert!(header.is_none(), "Block {} should have been pruned", height);
     }
 
-    // Recent blocks should still exist
+    // Recent blocks should still exist (blocks 799-999 since we stored 0-999)
     for height in 799..1000 {
         let header = storage.get_header_by_height(height).unwrap();
         assert!(header.is_some(), "Block {} should not have been pruned", height);

docs/STORAGE.md

@@ -230,10 +230,12 @@ let stats = storage.prune_old_blocks_production(
 )?;
 
 println!("Deleted {} blocks", stats.blocks_deleted);
-println!("Deleted {} transactions", stats.transactions_deleted);
+println!("Deleted ~{} transactions (approximate)", stats.transactions_deleted);
 println!("Archived: {}", stats.archived);
 ```
 
+> **Note:** Transaction deletion count is currently approximate as the pruning implementation doesn't fully track individual transaction deletions.
+
 ## Integration with StateManager
 
 The `StateManager` can use persistent storage: