Fully document crypto/

crypto/schnorr/src/aggregate.rs

@@ -66,8 +66,8 @@ fn weight<D: Send + Clone + SecureDigest, F: PrimeField>(digest: &mut DigestTran
 #[allow(non_snake_case)]
 #[derive(Clone, PartialEq, Eq, Debug, Zeroize)]
 pub struct SchnorrAggregate<C: Ciphersuite> {
-  pub Rs: Vec<C::G>,
-  pub s: C::F,
+  Rs: Vec<C::G>,
+  s: C::F,
 }
 
 impl<C: Ciphersuite> SchnorrAggregate<C> {
@@ -137,6 +137,7 @@ impl<C: Ciphersuite> SchnorrAggregate<C> {
   }
 }
 
+/// A signature aggregator capable of consuming signatures in order to produce an aggregate.
 #[allow(non_snake_case)]
 #[derive(Clone, Debug, Zeroize)]
 pub struct SchnorrAggregator<C: Ciphersuite> {

crypto/schnorr/src/lib.rs

@@ -1,3 +1,6 @@
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
+#![doc = include_str!("../README.md")]
+
 use core::ops::Deref;
 use std::io::{self, Read, Write};
 
@@ -14,6 +17,7 @@ use ciphersuite::{
 };
 use multiexp::{multiexp_vartime, BatchVerifier};
 
+/// Half-aggregation from <https://eprint.iacr.org/2021/350>.
 pub mod aggregate;
 
 #[cfg(test)]