spike

Author: patrick-ogrady

consensus/src/lib.rs

@@ -196,14 +196,14 @@ stability_scope!(BETA, cfg(not(target_arch = "wasm32")) {
 
         /// Broadcast a payload to the given recipients.
         ///
-        /// Returns `true` when the relay accepted the payload for the requested
-        /// broadcast plan. Returns `false` when the relay could not complete the
-        /// handoff.
+        /// Broadcast is best-effort dissemination and does not signal
+        /// durability; callers that need durability must rely on
+        /// [`Automaton::propose`] or [`Automaton::verify`].
         fn broadcast(
             &mut self,
             payload: Self::Digest,
             plan: Self::Plan,
-        ) -> impl Future<Output = bool> + Send;
+        ) -> impl Future<Output = ()> + Send;
     }
 
     /// Reporter is the interface responsible for reporting activity to some external actor.

consensus/src/marshal/application/validation.rs

@@ -8,12 +8,6 @@ use crate::{
     types::{Epoch, Epocher, Height, Round},
 };
 use commonware_cryptography::certificate::Scheme;
-use commonware_utils::sync::Mutex;
-use std::sync::Arc;
-
-/// Cache for the last block built during proposal, shared between the
-/// proposer task and the broadcast path.
-pub(crate) type LastBuilt<B> = Arc<Mutex<Option<(Round, B)>>>;
 
 /// Which stage of verification a block has reached.
 ///

consensus/src/marshal/coding/marshaled.rs

@@ -83,7 +83,7 @@ use crate::{
         ancestry::AncestorStream,
         application::{
             validation::{
-                is_inferred_reproposal_at_certify, is_valid_reproposal_at_verify, LastBuilt, Stage,
+                is_inferred_reproposal_at_certify, is_valid_reproposal_at_verify, Stage,
             },
             verification_tasks::VerificationTasks,
         },
@@ -106,6 +106,7 @@ use commonware_cryptography::{
     Committable, Digestible, Hasher,
 };
 use commonware_macros::select;
+use commonware_p2p::Recipients;
 use commonware_parallel::Strategy;
 use commonware_runtime::{
     telemetry::metrics::histogram::{Buckets, Timed},
@@ -116,7 +117,6 @@ use commonware_utils::{
         fallible::OneshotExt,
         oneshot::{self, error::RecvError},
     },
-    sync::Mutex,
     NZU16,
 };
 use futures::future::{ready, try_join, Either, Ready};
@@ -183,7 +183,6 @@ where
     scheme_provider: Z,
     epocher: ES,
     strategy: S,
-    last_built: LastBuilt<CodedBlock<B, C, H>>,
     verification_tasks: VerificationTasks<Commitment>,
     cached_genesis: Arc<OnceLock<(Commitment, CodedBlock<B, C, H>)>>,
 
@@ -266,7 +265,6 @@ where
             scheme_provider,
             strategy,
             epocher,
-            last_built: Arc::new(Mutex::new(None)),
             verification_tasks: VerificationTasks::new(),
             cached_genesis: Arc::new(OnceLock::new()),
 
@@ -491,15 +489,15 @@ where
     /// boundary block to avoid creating blocks that would be invalidated by the epoch transition.
     ///
     /// The proposal operation is spawned in a background task and returns a receiver that will
-    /// contain the proposed block's digest when ready. The built block is cached for later
-    /// broadcasting.
+    /// contain the proposed block's commitment when ready. The built block is persisted via
+    /// [`core::Mailbox::verified`] before the commitment is delivered, so consensus can rely
+    /// on the block surviving restart.
     async fn propose(
         &mut self,
         consensus_context: Context<Commitment, <Z::Scheme as CertificateScheme>::PublicKey>,
     ) -> oneshot::Receiver<Self::Digest> {
         let mut marshal = self.marshal.clone();
         let mut application = self.application.clone();
-        let last_built = self.last_built.clone();
         let epocher = self.epocher.clone();
         let strategy = self.strategy.clone();
         let cached_genesis = self.cached_genesis.clone();
@@ -537,10 +535,6 @@ where
                 if let Some(block) = marshal.get_verified(consensus_context.round).await {
                     let commitment = block.commitment();
                     let round = consensus_context.round;
-                    {
-                        let mut lock = last_built.lock();
-                        *lock = Some((round, block));
-                    }
                     let success = tx.send_lossy(commitment);
                     debug!(
                         ?round,
@@ -593,11 +587,14 @@ where
                 if parent.height() == last_in_epoch {
                     let commitment = parent.commitment();
                     let round = consensus_context.round;
-                    {
-                        let mut lock = last_built.lock();
-                        *lock = Some((round, parent));
+                    if !marshal.verified(round, parent).await {
+                        debug!(
+                            ?round,
+                            ?commitment,
+                            "marshal rejected re-proposed boundary block"
+                        );
+                        return;
                     }
-
                     let success = tx.send_lossy(commitment);
                     debug!(
                         ?round,
@@ -643,11 +640,10 @@ where
 
                 let commitment = coded_block.commitment();
                 let round = consensus_context.round;
-                {
-                    let mut lock = last_built.lock();
-                    *lock = Some((round, coded_block));
+                if !marshal.verified(round, coded_block).await {
+                    debug!(?round, ?commitment, "marshal rejected proposed block");
+                    return;
                 }
-
                 let success = tx.send_lossy(commitment);
                 debug!(?round, ?commitment, success, "proposed new block");
             });
@@ -973,38 +969,17 @@ where
     type PublicKey = <Z::Scheme as CertificateScheme>::PublicKey;
     type Plan = Plan<Self::PublicKey>;
 
-    async fn broadcast(&mut self, commitment: Self::Digest, plan: Self::Plan) -> bool {
-        match plan {
-            Plan::Propose => {
-                let Some((round, block)) = self.last_built.lock().take() else {
-                    warn!(?commitment, "missing block to broadcast");
-                    return false;
-                };
-                if block.commitment() != commitment {
-                    warn!(
-                        round = %round,
-                        commitment = %block.commitment(),
-                        height = %block.height(),
-                        "skipping requested broadcast of block with mismatched commitment"
-                    );
-                    return false;
-                };
-                let height = block.height();
-                if !self.marshal.proposed(round, block).await {
-                    warn!(?round, ?commitment, %height, "marshal unable to accept block");
-                    return false;
-                }
-                debug!(?round, ?commitment, %height, "requested broadcast of built block");
-                true
-            }
-            Plan::Forward { .. } => {
-                // Coding variant does not support targeted forwarding;
-                // peers reconstruct blocks from erasure-coded shards.
-                //
-                // TODO(#3389): Support checked data forwarding for PhasedScheme.
-                true
-            }
-        }
+    async fn broadcast(&mut self, commitment: Self::Digest, plan: Self::Plan) {
+        // Coding only disseminates on the initial proposer broadcast; peers
+        // reconstruct blocks from erasure-coded shards rather than receiving
+        // targeted full-block forwards. TODO(#3389): checked data forwarding
+        // for PhasedScheme.
+        let Plan::Propose { round } = plan else {
+            return;
+        };
+        self.marshal
+            .forward(round, commitment, Recipients::All)
+            .await;
     }
 }