refactor(iota-core): Add more comments for ReadApi::try_get_object_before_version

crates/iota-json-rpc-api/src/read.rs

@@ -88,6 +88,13 @@ pub trait ReadApi {
     /// version exists/existed. The result may vary across nodes depending
     /// on their pruning policies. Returns the latest object information
     /// with a version less than or equal to the given version
+    // Note that this endpoint is used by iota replay tool. Also the
+    // implementation in `iota-json-rpc` uses internally the
+    // `AuthorityState::find_object_lt_or_eq_version` method, which has
+    // underlying utility, e.g., `RemoteFetcher::get_child_object` uses
+    // `try_get_object_before_version` to get the object with the versions <=
+    // the given version. We have the `deprecated` flag here to not expose it in
+    // the generated spec file, and it should be only for internal usage.
     #[method(name = "tryGetObjectBeforeVersion", deprecated = "true")]
     async fn try_get_object_before_version(
         &self,