commit: improve error messages

commit_verify/src/commit.rs

@@ -32,10 +32,9 @@ use crate::CommitmentProtocol;
 #[derive(Copy, Clone, Eq, PartialEq, Debug, Display, Error)]
 #[display(doc_comments)]
 pub enum VerifyError {
-    /// The verified commitment doesn't commit to the provided message.
+    /// commitment doesn't match the message.
     InvalidCommitment,
-    /// The message is invalid since a commitment to it can't be created /
-    /// exist.
+    /// the message is invalid since a valid commitment to it can't be created.
     InvalidMessage,
 }
 

commit_verify/src/convolve.rs

@@ -32,14 +32,13 @@ use crate::{CommitEncode, CommitmentProtocol, VerifyEq};
     serde(crate = "serde_crate", rename_all = "camelCase")
 )]
 pub enum ConvolveVerifyError {
-    /// The verified commitment doesn't commit to the provided message.
+    /// commitment doesn't match the message.
     CommitmentMismatch,
 
-    /// The message is invalid since a valid commitment to it can't be created.
+    /// the message is invalid since a valid commitment to it can't be created.
     ImpossibleMessage,
 
-    /// The proof of the commitment is invalid and the commitment can't be
-    /// verified.
+    /// the proof is invalid and the commitment can't be verified.
     InvalidProof,
 }
 

commit_verify/src/embed.rs

@@ -27,22 +27,21 @@ use crate::{CommitEncode, CommitmentProtocol};
 #[derive(Copy, Clone, Eq, PartialEq, Debug, Display, Error, From)]
 #[display(doc_comments)]
 pub enum EmbedVerifyError<E: std::error::Error> {
-    /// The verified commitment doesn't commit to the provided message.
+    /// commitment doesn't match the message.
     CommitmentMismatch,
 
-    /// The message is invalid since a commitment to it can't be created /
-    /// exist.
+    /// the message is invalid since a valid commitment to it can't be created.
     ///
     /// Details: {0}
     #[from]
     InvalidMessage(E),
 
-    /// The proof of the commitment is invalid and the commitment can't be
-    /// verified since the original container can't be restored from it.
+    /// the proof is invalid and the commitment can't be verified since the
+    /// original container can't be restored from it.
     InvalidProof,
 
-    /// The proof of the commitment does not match to the proof generated for
-    /// the same message during the verification.
+    /// the proof does not match to the proof generated for the same message
+    /// during the verification.
     ProofMismatch,
 }