doc: doc

contract/src/ft_receiver.rs

@@ -34,7 +34,7 @@ pub struct StakeMessage {
     /// An optional account ID representing the intended owner of the created jar.
     receiver_id: Option<crate::AccountId>,
 
-    /// And optional user timezone. Required for creating step jars.
+    /// An optional user timezone. Required for creating step jars.
     timezone: Option<Timezone>,
 }
 

model/src/api.rs

@@ -273,7 +273,21 @@ pub trait WithdrawApi {
 
 #[make_integration_version]
 pub trait ScoreApi {
-    /// TODO: document
+    /// Records the score for a batch of accounts and updates their jars score accordingly.
+    ///
+    /// This method processes a batch of new scores for multiple accounts, updates their
+    /// respective jars score, calculates interest based on the current timestamp, and emits
+    /// an event with the recorded scores.
+    ///
+    /// # Arguments
+    ///
+    /// * `batch` - A vector of tuples, where each tuple contains an `AccountId` and a vector
+    ///   of tuples representing the new scores and their associated timestamps (in UTC).
+    ///
+    /// # Panics
+    ///
+    /// - This function will panic if an account does not have score jars.
+    /// - This function will panic if a product associated with a jar does not exist.
     fn record_score(&mut self, batch: Vec<(AccountId, Vec<(Score, UTC)>)>);
 }