Struct odra::ContractEnv

pub struct ContractEnv { /* private fields */ }

Represents the environment accessible in the contract context.

The ContractEnv struct provides methods for interacting with the contract environment, such as accessing storage, calling other contracts, and handling various contract-related operations.

The ContractEnv is available for the user to use in the module code.

Implementations

impl ContractEnv

pub const fn new( index: u32, backend: Rc<RefCell<dyn ContractContext>>, ) -> ContractEnv

Creates a new ContractEnv instance.

pub fn get_value<T>(&self, key: &[u8]) -> Option<T>

where T: FromBytes,

Retrieves the value associated with the given key from the contract storage.

Returns

The value associated with the key, if it exists.

pub fn set_value<T>(&self, key: &[u8], value: T)

where T: ToBytes + CLTyped,

Sets the value associated with the given key in the contract storage.

pub fn get_named_value<T, U>(&self, name: U) -> Option<T>

where T: FromBytes + CLTyped, U: AsRef<str>,

Retrieves the value associated with the given named key from the contract storage.

pub fn set_named_value<T, U>(&self, name: U, value: T)

where T: CLTyped + ToBytes, U: AsRef<str>,

Sets the value associated with the given named key in the contract storage.

pub fn get_dictionary_value<T, U>( &self, dictionary_name: U, key: &[u8], ) -> Option<T>

where T: FromBytes + CLTyped, U: AsRef<str>,

Retrieves the value associated with the given named key from the named dictionary in the contract storage.

pub fn set_dictionary_value<T, U>( &self, dictionary_name: U, key: &[u8], value: T, )

where T: CLTyped + ToBytes, U: AsRef<str>,

Sets the value associated with the given named key in the named dictionary in the contract storage.

pub fn remove_dictionary<U>(&self, dictionary_name: U)

where U: AsRef<str>,

Removes the dictionary from the contract storage.

pub fn caller(&self) -> Address

Returns the address of the caller of the contract.

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

where T: FromBytes,

Calls another contract with the specified address and call definition.

Returns

The result of the contract call. If any error occurs during the call, the contract will revert.

pub fn self_address(&self) -> Address

Returns the address of the current contract.

pub fn transfer_tokens(&self, to: &Address, amount: &U512)

Transfers tokens to the specified address.

pub fn get_block_time(&self) -> u64

Returns the current block time as u64 value.

pub fn attached_value(&self) -> U512

Returns the value attached to the contract call.

pub fn self_balance(&self) -> U512

Returns the CSPR balance of the current contract.

pub fn revert<E>(&self, error: E) -> !

where E: Into<OdraError>,

Reverts the contract execution with the specified error.

pub fn emit_event<T>(&self, event: T)

where T: ToBytes,

Emits an event with the specified data.

pub fn verify_signature( &self, message: &Bytes, signature: &Bytes, public_key: &PublicKey, ) -> bool

Verifies the signature of a message using the specified signature, public key, and message.

Arguments

• message - The message to verify.
• signature - The signature to verify.
• public_key - The public key to use for verification.

Returns

true if the signature is valid, false otherwise.

pub fn hash<T>(&self, value: T) -> [u8; 32]

where T: AsRef<[u8]>,

Hashes the specified value.

Returns

The hash value as a 32-byte array.

Trait Implementations

impl Clone for ContractEnv

fn clone(&self) -> ContractEnv

Returns a copy of the value.

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

Performs copy-assignment from source.