[Feature] Receipt trait in alloy-consensus

crates/consensus/src/receipt/any.rs

@@ -1,4 +1,4 @@
-use crate::ReceiptWithBloom;
+use crate::{ReceiptWithBloom, TxReceipt};
 use alloy_eips::eip2718::{Decodable2718, Encodable2718};
 use alloy_primitives::{bytes::BufMut, Bloom, Log};
 use alloy_rlp::{Decodable, Encodable};
@@ -55,6 +55,11 @@ impl<T> AnyReceiptEnvelope<T> {
         self.inner.receipt.status
     }
 
+    /// Return the receipt's bloom.
+    pub const fn bloom(&self) -> Bloom {
+        self.inner.logs_bloom
+    }
+
     /// Returns the cumulative gas used at this receipt.
     pub const fn cumulative_gas_used(&self) -> u128 {
         self.inner.receipt.cumulative_gas_used
@@ -64,10 +69,27 @@ impl<T> AnyReceiptEnvelope<T> {
     pub fn logs(&self) -> &[T] {
         &self.inner.receipt.logs
     }
+}
+
+impl<T> TxReceipt<T> for AnyReceiptEnvelope<T> {
+    /// Returns the success status of the receipt's transaction.
+    fn status(&self) -> bool {
+        self.inner.receipt.status
+    }
 
     /// Return the receipt's bloom.
-    pub const fn logs_bloom(&self) -> &Bloom {
-        &self.inner.logs_bloom
+    fn bloom(&self) -> Bloom {
+        self.inner.logs_bloom
+    }
+
+    /// Returns the cumulative gas used at this receipt.
+    fn cumulative_gas_used(&self) -> u128 {
+        self.inner.receipt.cumulative_gas_used
+    }
+
+    /// Return the receipt logs.
+    fn logs(&self) -> &[T] {
+        &self.inner.receipt.logs
     }
 }
 

crates/consensus/src/receipt/envelope.rs

@@ -1,4 +1,4 @@
-use crate::{Receipt, ReceiptWithBloom, TxType};
+use crate::{Receipt, ReceiptWithBloom, TxReceipt, TxType};
 use alloy_eips::eip2718::{Decodable2718, Encodable2718};
 use alloy_primitives::{Bloom, Log};
 use alloy_rlp::{length_of_length, BufMut, Decodable, Encodable};
@@ -93,6 +93,31 @@ impl<T> ReceiptEnvelope<T> {
     }
 }
 
+impl<T> TxReceipt<T> for ReceiptEnvelope<T> {
+    fn status(&self) -> bool {
+        self.as_receipt().unwrap().status
+    }
+
+    /// Return the receipt's bloom.
+    fn bloom(&self) -> Bloom {
+        self.as_receipt_with_bloom().unwrap().logs_bloom
+    }
+
+    fn bloom_cheap(&self) -> Option<Bloom> {
+        Some(self.bloom())
+    }
+
+    /// Returns the cumulative gas used at this receipt.
+    fn cumulative_gas_used(&self) -> u128 {
+        self.as_receipt().unwrap().cumulative_gas_used
+    }
+
+    /// Return the receipt logs.
+    fn logs(&self) -> &[T] {
+        &self.as_receipt().unwrap().logs
+    }
+}
+
 impl ReceiptEnvelope {
     /// Get the length of the inner receipt in the 2718 encoding.
     pub fn inner_length(&self) -> usize {

crates/consensus/src/receipt/mod.rs

@@ -10,9 +10,9 @@ mod receipts;
 pub use receipts::{Receipt, ReceiptWithBloom};
 
 /// Receipt is the result of a transaction execution.
-pub trait TxReceipt {
+pub trait TxReceipt<T = Log> {
     /// Returns true if the transaction was successful.
-    fn success(&self) -> bool;
+    fn status(&self) -> bool;
 
     /// Returns the bloom filter for the logs in the receipt. This operation
     /// may be expensive.
@@ -28,7 +28,7 @@ pub trait TxReceipt {
     fn cumulative_gas_used(&self) -> u128;
 
     /// Returns the logs emitted by this transaction.
-    fn logs(&self) -> &[Log];
+    fn logs(&self) -> &[T];
 }
 
 #[cfg(test)]

crates/consensus/src/receipt/receipts.rs

@@ -43,7 +43,7 @@ where
 }
 
 impl TxReceipt for Receipt {
-    fn success(&self) -> bool {
+    fn status(&self) -> bool {
         self.status
     }
 
@@ -78,7 +78,7 @@ pub struct ReceiptWithBloom<T = Log> {
 }
 
 impl TxReceipt for ReceiptWithBloom {
-    fn success(&self) -> bool {
+    fn status(&self) -> bool {
         self.receipt.status
     }
 

crates/network/src/lib.rs

@@ -15,6 +15,7 @@
 #![deny(unused_must_use, rust_2018_idioms)]
 #![cfg_attr(docsrs, feature(doc_cfg, doc_auto_cfg))]
 
+use alloy_consensus::TxReceipt;
 use alloy_eips::eip2718::{Eip2718Envelope, Eip2718Error};
 use alloy_json_rpc::RpcObject;
 use alloy_primitives::Address;
@@ -75,7 +76,7 @@ pub trait Network: Debug + Clone + Copy + Sized + Send + Sync + 'static {
     type UnsignedTx: From<Self::TxEnvelope>;
 
     /// The network receipt envelope type.
-    type ReceiptEnvelope: Eip2718Envelope;
+    type ReceiptEnvelope: Eip2718Envelope + TxReceipt;
 
     /// The network header type.
     type Header;