docs and changelog

Author: hanabi1224

fvm/src/state_tree.rs

@@ -364,6 +364,7 @@ where
         self.hamt.into_store()
     }
 
+    /// Iterates over each KV in the Hamt and runs a function on the values with cache.
     pub fn for_each<F>(&self, mut f: F) -> anyhow::Result<()>
     where
         F: FnMut(Address, &ActorState) -> anyhow::Result<()>,
@@ -375,6 +376,7 @@ where
         Ok(())
     }
 
+    /// Iterates over each KV in the Hamt and runs a function on the values without cache.
     pub fn for_each_cacheless<F>(&self, mut f: F) -> anyhow::Result<()>
     where
         F: FnMut(Address, &ActorState) -> anyhow::Result<()>,

ipld/hamt/CHANGELOG.md

@@ -4,6 +4,8 @@ Changes to the reference FVM's HAMT implementation.
 
 ## [Unreleased]
 
+- Added `for_each_cacheless` method to iterate over the HAMT without caching the values. This is lowers memory requirements usage and is useful for single-pass, read-only operations over large HAMTs.
+
 ## 0.10.4 [2025-04-09]
 
 - Updates multiple dependencies (semver breaking internally but not exported).