Struct clarity_repl::clarity::clarity::ClarityBlockConnection

pub struct ClarityBlockConnection<'a> { /* private fields */ }

A high-level interface for Clarity VM interactions within a single block.

Implementations

impl ClarityBlockConnection<'_>

pub fn reset_block_cost(&mut self, cost: ExecutionCost)

Reset the block’s total execution to the given cost, if there is a cost tracker at all. Used by the miner to “undo” applying a transaction that exceeded the budget.

pub fn set_cost_tracker(
    &mut self,
    tracker: LimitedCostTracker
) -> LimitedCostTracker

pub fn cost_so_far(&self) -> ExecutionCost

Get the current cost so far

impl<'a> ClarityBlockConnection<'a>

pub fn rollback_block(self)

Rolls back all changes in the current block by (1) dropping all writes from the current MARF tip, (2) rolling back side-storage

pub fn commit_to_block(self, final_bhh: &StacksBlockId) -> LimitedCostTracker

Commits all changes in the current block by (1) committing the current MARF tip to storage, (2) committing side-storage. Commits all changes in the current block by (1) committing the current MARF tip to storage, (2) committing side-storage. Commits to a different block hash than the one opened (i.e. since the caller may not have known the “real” block hash at the time of opening).

pub fn commit_mined_block(self, bhh: &StacksBlockId) -> LimitedCostTracker

Commits all changes in the current block by (1) committing the current MARF tip to storage, (2) committing side-storage. before this saves, it updates the metadata headers in the sidestore so that they don’t get stepped on after a miner re-executes a constructed block.

pub fn start_transaction_processing<'b>(
    &'b mut self
) -> ClarityTransactionConnection<'b>

pub fn as_transaction<F, R>(&mut self, todo: F) -> R where
    F: FnOnce(&mut ClarityTransactionConnection<'_>) -> R, 

Trait Implementations

impl ClarityConnection for ClarityBlockConnection<'_>

fn with_clarity_db_readonly_owned<F, R>(&mut self, to_do: F) -> R where
    F: FnOnce(ClarityDatabase<'_>) -> (R, ClarityDatabase<'_>), 

Do something with ownership of the underlying DB that involves only reading.

fn with_analysis_db_readonly<F, R>(&mut self, to_do: F) -> R where
    F: FnOnce(&mut AnalysisDatabase<'_>) -> R, 

fn with_clarity_db_readonly<F, R>(&mut self, to_do: F) -> R where
    F: FnOnce(&mut ClarityDatabase<'_>) -> R, 

fn with_readonly_clarity_env<F, R>(
    &mut self,
    mainnet: bool,
    sender: PrincipalData,
    cost_track: LimitedCostTracker,
    to_do: F
) -> Result<R, InterpreterError> where
    F: FnOnce(&mut Environment<'_, '_>) -> Result<R, InterpreterError>,