Struct TransactionContext

pub struct TransactionContext { /* private fields */ }

Represents all needed data for executing a transaction, or arbitrary code.

It implements DataStore, so transactions may be executed with TransactionExecutor

Implementations

impl TransactionContext

pub fn execute_code_with_assembler( &self, code: &str, assembler: Assembler, ) -> Result<Process, ExecutionError>

Executes arbitrary code within the context of a mocked transaction environment and returns the resulting Process.

The code is compiled with the assembler attached to this context and executed with advice inputs constructed from the data stored in the context. The program is run on a MockHost which is loaded with the procedures exposed by the transaction kernel, and also individual kernel functions (not normally exposed).

To improve the error message quality, convert the returned ExecutionError into a Report.

Errors

Returns an error if the assembly or execution of the provided code fails.

Panics

• If the provided code is not a valid program.

pub fn execute_code(&self, code: &str) -> Result<Process, ExecutionError>

Executes arbitrary code with a testing assembler (TransactionKernel::testing_assembler()).

For more information, see the docs for TransactionContext::execute_code_with_assembler().

pub fn execute(self) -> Result<ExecutedTransaction, TransactionExecutorError>

Executes the transaction through a TransactionExecutor

pub fn account(&self) -> &Account

pub fn expected_output_notes(&self) -> &[Note]

pub fn tx_args(&self) -> &TransactionArgs

pub fn input_notes(&self) -> &InputNotes<InputNote>

pub fn set_tx_args(&mut self, tx_args: TransactionArgs)

pub fn tx_inputs(&self) -> &TransactionInputs

pub fn authenticator(&self) -> Option<&BasicAuthenticator<ChaCha20Rng>>

pub fn source_manager(&self) -> Arc<dyn SourceManager>

Returns the source manager used in the assembler of the transaction context builder.

Trait Implementations

impl DataStore for TransactionContext

fn get_transaction_inputs( &self, account_id: AccountId, _ref_blocks: BTreeSet<BlockNumber>, ) -> Result<(Account, Option<Word>, BlockHeader, PartialBlockchain), DataStoreError>

Returns all the data required to execute a transaction against the account with the specified ID and consuming input notes created in blocks in the input ref_blocks set.

impl MastForestStore for TransactionContext

fn get(&self, procedure_hash: &Digest) -> Option<Arc<MastForest>>

Returns a MastForest which is guaranteed to contain a procedure with the provided procedure hash as one of its procedure, if any.