docs: improve SealedBlockRecoveryError documentation

crates/primitives-traits/src/block/error.rs

@@ -3,6 +3,37 @@
 use crate::transaction::signed::RecoveryError;
 
 /// Type alias for [`BlockRecoveryError`] with a [`SealedBlock`](crate::SealedBlock) value.
+///
+/// This error type is specifically used when recovering a sealed block fails.
+/// It contains the original sealed block that could not be recovered, allowing
+/// callers to inspect the problematic block or attempt recovery with different
+/// parameters.
+///
+/// # Example
+///
+/// ```rust
+/// use alloy_consensus::{Block, BlockBody, Header, Signed, TxEnvelope, TxLegacy};
+/// use alloy_primitives::{Signature, B256};
+/// use reth_primitives_traits::{block::error::SealedBlockRecoveryError, SealedBlock};
+///
+/// // Create a simple block for demonstration
+/// let header = Header::default();
+/// let tx = TxLegacy::default();
+/// let signed_tx = Signed::new_unchecked(tx, Signature::test_signature(), B256::ZERO);
+/// let envelope = TxEnvelope::Legacy(signed_tx);
+/// let body = BlockBody { transactions: vec![envelope], ommers: vec![], withdrawals: None };
+/// let block = Block::new(header, body);
+/// let sealed_block = SealedBlock::new_unchecked(block, B256::ZERO);
+///
+/// // Simulate a block recovery operation that fails
+/// let block_recovery_result: Result<(), SealedBlockRecoveryError<_>> =
+///     Err(SealedBlockRecoveryError::new(sealed_block));
+///
+/// // When block recovery fails, you get the error with the original block
+/// let error = block_recovery_result.unwrap_err();
+/// let failed_block = error.into_inner();
+/// // Now you can inspect the failed block or try recovery again
+/// ```
 pub type SealedBlockRecoveryError<B> = BlockRecoveryError<crate::SealedBlock<B>>;
 
 /// Error when recovering a block from [`SealedBlock`](crate::SealedBlock) to