Struct odra::host::HostEnv

pub struct HostEnv { /* private fields */ }

Represents the host environment for executing smart contracts.

It provides methods for interacting with the underlying host context and managing the execution of contracts.

Implementations

impl HostEnv

pub fn new(backend: Rc<RefCell<dyn HostContext>>) -> HostEnv

Creates a new HostEnv instance with the specified backend.

pub fn get_account(&self, index: usize) -> Address

Returns the account address at the specified index.

pub fn set_caller(&self, address: Address)

Sets the caller address for the current contract execution.

pub fn advance_block_time(&self, time_diff: u64)

Advances the block time by the specified time difference.

pub fn block_time(&self) -> u64

Returns the current block time.

pub fn new_contract( &self, name: &str, init_args: RuntimeArgs, entry_points_caller: EntryPointsCaller ) -> Result<Address, OdraError>

Registers a new contract with the specified name, initialization arguments, and entry points caller.

pub fn register_contract( &self, address: Address, entry_points_caller: EntryPointsCaller )

Registers an existing contract with the specified address and entry points caller. Similar to new_contract, but skips the deployment phase.

pub fn call_contract<T>( &self, address: Address, call_def: CallDef ) -> Result<T, OdraError>

where T: FromBytes + CLTyped,

Calls a contract at the specified address with the given call definition.

pub fn contract_env(&self) -> ContractEnv

Returns the gas cost of the last contract call.

pub fn gas_report(&self) -> Vec<DeployReport>

Prints the gas report for the current contract execution.

pub fn balance_of(&self, address: &Address) -> U512

Returns the CSPR balance of the specified address.

pub fn get_event<T>( &self, contract_address: &Address, index: i32 ) -> Result<T, EventError>

where T: FromBytes + EventInstance,

Retrieves an event with the specified index from the specified contract.

Returns

Returns the event as an instance of the specified type, or an error if the event couldn’t be retrieved or parsed.

pub fn get_event_bytes( &self, contract_address: &Address, index: u32 ) -> Result<Bytes, EventError>

Retrieves a raw event (serialized) with the specified index from the specified contract.

pub fn event_names(&self, contract_address: &Address) -> Vec<String>

Returns the names of all events emitted by the specified contract.

pub fn events(&self, contract_address: &Address) -> Vec<Bytes>

Returns all events emitted by the specified contract.

pub fn events_count(&self, contract_address: &Address) -> u32

Returns the number of events emitted by the specified contract.

pub fn emitted_event<T>(&self, contract_address: &Address, event: &T) -> bool

where T: ToBytes + EventInstance,

Returns true if the specified event was emitted by the specified contract.

pub fn emitted<T>(&self, contract_address: &Address, event_name: T) -> bool

where T: AsRef<str>,

Returns true if an event with the specified name was emitted by the specified contract.

pub fn last_call_result(&self, contract_address: Address) -> ContractCallResult

Returns the last call result for the specified contract.

pub fn sign_message(&self, message: &Bytes, address: &Address) -> Bytes

Signs the specified message with the private key of the specified address.

pub fn public_key(&self, address: &Address) -> PublicKey

Returns the public key associated with the specified address.

pub fn caller(&self) -> Address

Returns the caller address for the current contract execution.

pub fn set_gas(&self, gas: u64)

Sets the gas limit for the current contract execution.

Trait Implementations

impl Clone for HostEnv

fn clone(&self) -> HostEnv

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.