verify.rs: Initial Verify trait

signature-crate/src/sign.rs

@@ -1,4 +1,4 @@
-//! Trait for producing digital signatures
+//! Trait for generating digital signatures of message bytestrings
 
 use crate::{error::Error, Signature};
 

signature-crate/src/verify.rs

@@ -0,0 +1,12 @@
+//! Trait for verifying digital signatures of message bytestrings
+
+use crate::{error::Error, Signature};
+
+/// Verify the provided message bytestring using `Self` (e.g. a public key)
+pub trait Verify<S: Signature>: Send + Sync {
+    /// Use `Self` to verify that the provided signature for a given message
+    /// bytestring is authentic.
+    ///
+    /// Returns `Error` if it is inauthentic, or otherwise returns `()`.
+    fn verify(&self, msg: &[u8], signature: &S) -> Result<(), Error>;
+}