Addressed review comment:

- improved javadoc

Signed-off-by: Ivan Malygin <[email protected]>

Author: imalygin

platform-sdk/swirlds-state-api/src/main/java/com/swirlds/state/StateLifecycleManager.java

@@ -27,16 +27,22 @@ public interface StateLifecycleManager {
      * Get the mutable state. Consecutive calls to this method may return different instances,
      * if this method is not called on the one and the only thread that is calling {@link #copyMutableState}.
      * If a parallel thread calls {@link #copyMutableState}, the returned object will become immutable and
-     * on the subsequent call of {@link #copyMutableState} it will be destroyed.
+     * on the subsequent call of {@link #copyMutableState} it will be destroyed and, therefore, not usable in some contexts.
      *
      * @return the mutable state.
      */
     MerkleNodeState getMutableState();
 
     /**
-     * Get the latest immutable state. Consecutive calls to this method may return different instances,
-     * if this method is not called on the one and the only thread that is calling {@link #copyMutableState}
-     * If a parallel thread calls {@link #copyMutableState}, the returned object will become destroyed.
+     * Get the latest immutable state. Consecutive calls to this method may return different instances
+     * if this method is not called on the one and only thread that is calling {@link #copyMutableState}.
+     * If a parallel thread calls {@link #copyMutableState}, the returned object will become destroyed and, therefore, not usable in some contexts.
+     * <br>
+     * If a durable long-term reference to the immutable state returned by this method is required, it is the
+     * responsibility of the caller to ensure a reference is maintained to prevent its garbage collection. Also,
+     * it is the responsibility of the caller to ensure that the object is not used in contexts in which it may become unusable
+     * (e.g., hashing of the destroyed state is not possible).
+     *
      * @return the latest immutable state.
      */
     MerkleNodeState getLatestImmutableState();