chore: misc comments

mpz-core/src/cointoss/receiver.rs

@@ -90,7 +90,7 @@ pub mod receiver_state {
 
     opaque_debug::implement!(Initialized);
 
-    /// The receiver's state after receiving the sender's commitment.
+    /// The receiver's state after receiving the sender's commitment and revealing one's own seed.
     pub struct Received {
         pub(super) seeds: Vec<Block>,
         pub(super) commitment: Hash,

ot/mpz-ot-core/src/kos/receiver.rs

@@ -689,7 +689,10 @@ pub mod state {
 
     opaque_debug::implement!(Initialized);
 
-    /// The receiver's state after base setup
+    /// The receiver's state after the setup phase.
+    ///
+    /// In this state the receiver performs OT extension (potentially multiple times). Also in this
+    /// state the receiver sends OT requests.
     pub struct Extension {
         /// Receiver's rngs
         pub(super) rngs: Vec<[ChaCha20Rng; 2]>,

ot/mpz-ot-core/src/kos/sender.rs

@@ -472,7 +472,10 @@ pub mod state {
 
     opaque_debug::implement!(Initialized);
 
-    /// The sender's state after base OT setup
+    /// The sender's state after the setup phase.
+    ///
+    /// In this state the sender performs OT extension (potentially multiple times). Also in this
+    /// state the sender responds to OT requests.
     pub struct Extension {
         /// Sender's base OT choices
         pub(super) delta: Block,

share-conversion/mpz-share-conversion-core/src/fields/p256.rs

@@ -43,6 +43,7 @@ impl From<P256> for [u8; 32] {
 impl TryFrom<[u8; 32]> for P256 {
     type Error = ark_serialize::SerializationError;
 
+    /// Converts little-endian bytes into a P256 field element.
     fn try_from(value: [u8; 32]) -> Result<Self, Self::Error> {
         Fq::deserialize_with_mode(&value[..], Compress::No, Validate::Yes).map(P256)
     }