revm-trace 4.2.0

//! Inspector management for TraceEvm
//!
//! This module provides inspector-specific functionality for the TraceEvm,
//! allowing access to trace data and inspector state management.

use crate::evm::TraceEvm;
use crate::traits::{Reset, TraceOutput};
use revm::database::Database;

impl<DB, INSP> TraceEvm<DB, INSP>
where
    DB: Database,
    INSP: TraceOutput + Reset,
{
    /// Retrieve the current output from the inspector
    ///
    /// Returns the accumulated trace data or analysis results from the inspector.
    /// The exact type and content depends on the specific inspector implementation.
    ///
    /// # Examples
    /// ```no_run
    /// use revm_trace::{create_evm_with_tracer, TxInspector};
    ///
    /// # async fn example() -> Result<(), Box<dyn std::error::Error>> {
    /// let trace_inspector = TxInspector::new();
    /// let mut evm = create_evm_with_tracer("https://eth.llamarpc.com", trace_inspector).await?;
    ///
    /// // After processing transactions...
    /// let trace_output = evm.get_inspector_output();
    /// println!("Collected trace data: {:?}", trace_output);
    /// # Ok(())
    /// # }
    /// ```
    ///
    /// # Returns
    /// The inspector's output data (traces, logs, analysis results, etc.)
    pub fn get_inspector_output(&self) -> INSP::Output {
        self.inspector.get_output()
    }

    /// Reset the inspector to its initial state
    ///
    /// Clears any accumulated trace data, logs, or internal state in the inspector.
    /// This should be called before processing a new transaction or batch to ensure
    /// clean state isolation between transactions.
    ///
    /// # Examples
    /// ```no_run
    /// use revm_trace::{create_evm_with_tracer, TxInspector};
    ///
    /// # async fn example() -> Result<(), Box<dyn std::error::Error>> {
    /// let trace_inspector = TxInspector::new();
    /// let mut evm = create_evm_with_tracer("https://eth.llamarpc.com", trace_inspector).await?;
    ///
    /// // Process first transaction...
    /// // let result1 = evm.process_transaction(tx1).await?;
    ///
    /// // Reset before processing next transaction
    /// evm.reset_inspector();
    ///
    /// // Process second transaction with clean state...
    /// // let result2 = evm.process_transaction(tx2).await?;
    /// # Ok(())
    /// # }
    /// ```
    ///
    /// # Note
    /// This method is automatically called internally before each transaction
    /// in batch processing to ensure proper state isolation.
    pub fn reset_inspector(&mut self) {
        self.inspector.reset();
    }
}