Fix docs warnings

Author: Alenar

mithril-aggregator/src/certifier_service.rs

@@ -1,7 +1,7 @@
 //! ## Certifier Service
 //!
 //! This service is responsible of [OpenMessage] cycle of life. It creates open
-//! messages and turn them into [CertificateRecord]. To do so, it registers
+//! messages and turn them into [Certificate]. To do so, it registers
 //! single signatures and deal with the multi_signer for aggregate signature
 //! creation.
 use std::sync::Arc;

mithril-aggregator/src/database/provider/open_message.rs

@@ -471,7 +471,7 @@ impl OpenMessageRepository {
         Self { connection }
     }
 
-    /// Return the latest [OpenMessage] for the given Epoch and [SignedEntityType].
+    /// Return the latest [OpenMessageRecord] for the given Epoch and [SignedEntityType].
     pub async fn get_open_message(
         &self,
         signed_entity_type: &SignedEntityType,
@@ -486,7 +486,7 @@ impl OpenMessageRepository {
         Ok(messages.next())
     }
 
-    /// Create a new [OpenMessage] in the database.
+    /// Create a new [OpenMessageRecord] in the database.
     pub async fn create_open_message(
         &self,
         epoch: Epoch,
@@ -503,7 +503,7 @@ impl OpenMessageRepository {
             .ok_or_else(|| panic!("Inserting an open_message should not return nothing."))
     }
 
-    /// Updates an [OpenMessage] in the database.
+    /// Updates an [OpenMessageRecord] in the database.
     pub async fn update_open_message(
         &self,
         open_message: &OpenMessageRecord,
@@ -518,7 +518,7 @@ impl OpenMessageRepository {
             .ok_or_else(|| panic!("Updating an open_message should not return nothing."))
     }
 
-    /// Remove all the [OpenMessage] for the given Epoch in the database.
+    /// Remove all the [OpenMessageRecord] for the given Epoch in the database.
     /// It returns the number of messages removed.
     pub async fn clean_epoch(&self, epoch: Epoch) -> StdResult<usize> {
         let lock = self.connection.lock().await;

mithril-aggregator/src/dependency_injection/builder.rs

@@ -864,7 +864,7 @@ impl DependenciesBuilder {
         Ok(signer_recorder)
     }
 
-    /// [SignerRecorder]
+    /// [SignerRecorder] service
     pub async fn get_signer_recorder(&mut self) -> Result<Arc<dyn SignerRecorder>> {
         if self.signer_recorder.is_none() {
             self.signer_recorder = Some(self.build_signer_recorder().await?);

mithril-aggregator/src/lib.rs

@@ -34,10 +34,14 @@ mod store;
 pub mod ticker_service;
 mod tools;
 
+pub use crate::artifact_builder::{ArtifactBuilder, ArtifactBuilderService};
 pub use crate::configuration::{
     Configuration, DefaultConfiguration, ExecutionEnvironment, SnapshotUploaderType,
 };
 pub use crate::multi_signer::{MultiSigner, MultiSignerImpl, ProtocolError};
+pub use crate::signable_builder::{
+    ImmutableSignableBuilder, MithrilStakeDistributionSignableBuilder, SignableBuilderService,
+};
 pub use crate::snapshot_stores::{LocalSnapshotStore, SnapshotStore};
 pub use command_args::MainOpts;
 pub use dependency::DependencyManager;
@@ -48,8 +52,8 @@ pub use runtime::{
     AggregatorConfig, AggregatorRunner, AggregatorRunnerTrait, AggregatorRuntime, RuntimeError,
 };
 pub use signer_registerer::{
-    MithrilSignerRegisterer, SignerRegisterer, SignerRegistrationError, SignerRegistrationRound,
-    SignerRegistrationRoundOpener,
+    MithrilSignerRegisterer, SignerRecorder, SignerRegisterer, SignerRegistrationError,
+    SignerRegistrationRound, SignerRegistrationRoundOpener,
 };
 pub use snapshot_uploaders::{
     DumbSnapshotUploader, LocalSnapshotUploader, RemoteSnapshotUploader, SnapshotUploader,

mithril-aggregator/src/signable_builder/immutable_signable_builder.rs

@@ -8,6 +8,7 @@ use mithril_common::{
     StdResult,
 };
 
+/// A [SignableBuilder] for cardano immutable files.
 pub struct ImmutableSignableBuilder {
     immutable_digester: Arc<dyn ImmutableDigester>,
 }

mithril-aggregator/src/signable_builder/mithril_stake_distribution.rs

@@ -11,7 +11,7 @@ use mithril_common::{
 
 use crate::MultiSigner;
 
-/// A [MithrilStakeDistributionSignable] builder
+/// A [SignableBuilder] for mithril stake distribution.
 pub struct MithrilStakeDistributionSignableBuilder {
     multi_signer: Arc<RwLock<dyn MultiSigner>>,
 }

mithril-common/src/crypto_helper/mod.rs

@@ -8,8 +8,10 @@ mod genesis;
 pub mod tests_setup;
 mod types;
 
-pub use cardano::ColdKeyGenerator;
-pub use cardano::{KESPeriod, OpCert, SerDeShelleyFileFormat, Sum6KesBytes};
+pub use cardano::{
+    ColdKeyGenerator, KESPeriod, OpCert, ProtocolInitializerErrorWrapper,
+    ProtocolRegistrationErrorWrapper, SerDeShelleyFileFormat, Sum6KesBytes,
+};
 pub use codec::*;
 pub use era::{
     EraMarkersSigner, EraMarkersVerifier, EraMarkersVerifierError, EraMarkersVerifierSecretKey,

mithril-common/src/crypto_helper/types.rs

@@ -71,10 +71,10 @@ pub type ProtocolGenesisSecretKey = ed25519_dalek::SecretKey;
 pub type ProtocolGenesisSignature = ed25519_dalek::Signature;
 
 // Error alias
-/// Alias of a wrapper of [MithrilCommon:ProtocolRegistrationErrorWrapper](enum@mithril_common::ProtocolRegistrationErrorWrapper).
+/// Alias of a wrapper of [MithrilCommon:ProtocolRegistrationErrorWrapper](enum@ProtocolRegistrationErrorWrapper).
 pub type ProtocolRegistrationError = ProtocolRegistrationErrorWrapper;
 
-/// Alias of a wrapper of [MithrilCommon:ProtocolInitializerErrorWrapper](enum@mithril_common::ProtocolInitializerErrorWrapper).
+/// Alias of a wrapper of [MithrilCommon:ProtocolInitializerErrorWrapper](enum@ProtocolInitializerErrorWrapper).
 pub type ProtocolInitializerError = ProtocolInitializerErrorWrapper;
 
 /// Alias of [MithrilStm:AggregationError](enum@mithril_stm::AggregationError).