crypto_api 0.2.2

Defines a general purpose API for various cryptographic primitives
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

use crate::rng::{ SecKeyGen, PubKeyGen };
use std::{ error::Error, ops::Range };


/// Information about a signature implementation
#[derive(Debug, Eq, PartialEq, Clone)]
pub struct SignerInfo {
	/// The name
	pub name: &'static str,
	
	/// The supported signature lengths
	pub sig_len_r: Range<usize>,
	/// The supported private key lengths
	pub sec_key_len_r: Range<usize>,
	/// The supported public key lengths
	pub pub_key_len_r: Range<usize>
}


/// A stateless (oneshot) signature interface
pub trait Signer: SecKeyGen + PubKeyGen {
	/// Returns information about the signer
	fn info(&self) -> SignerInfo;
	
	/// Signs `data` into `buf` using `sec_key` and returns the signature length
	fn sign(&self, buf: &mut[u8], data: &[u8], sec_key: &[u8])
		-> Result<usize, Box<dyn Error + 'static>>;
	/// Verifies `sig` for `data` with `pub_key` and returns an error if the signature was
	/// __invalid__
	fn verify(&self, data: &[u8], sig: &[u8], pub_key: &[u8])
		-> Result<(), Box<dyn Error + 'static>>;
}