[−][src]Trait transact::handler::TransactionContext

pub trait TransactionContext {
    fn get_state_entries(
        &self, 
        addresses: &[String]
    ) -> Result<Vec<(String, Vec<u8>)>, ContextError>;

    fn set_state_entries(
        &self, 
        entries: Vec<(String, Vec<u8>)>
    ) -> Result<(), ContextError>;

    fn delete_state_entries(
        &self, 
        addresses: &[String]
    ) -> Result<Vec<String>, ContextError>;

    fn add_receipt_data(&self, data: Vec<u8>) -> Result<(), ContextError>;

    fn add_event(
        &self, 
        event_type: String, 
        attributes: Vec<(String, String)>, 
        data: Vec<u8>
    ) -> Result<(), ContextError>;

    fn get_state_entry(
        &self, 
        address: &str
    ) -> Result<Option<Vec<u8>>, ContextError> { ... }

    fn set_state_entry(
        &self, 
        address: String, 
        data: Vec<u8>
    ) -> Result<(), ContextError> { ... }

    fn delete_state_entry(
        &self, 
        address: &str
    ) -> Result<Option<String>, ContextError> { ... }
}

Required methods

fn get_state_entries(
    &self,
    addresses: &[String]
) -> Result<Vec<(String, Vec<u8>)>, ContextError>

get_state_entries queries the validator state for data at each of the addresses in the given list. The addresses that have been set are returned.

Arguments

  • addresses - the addresses to fetch

fn set_state_entries(
    &self,
    entries: Vec<(String, Vec<u8>)>
) -> Result<(), ContextError>

set_state_entries requests that each address in the provided map be set in validator state to its corresponding value.

Arguments

  • entries - entries are a hashmap where the key is an address and value is the data

fn delete_state_entries(
    &self,
    addresses: &[String]
) -> Result<Vec<String>, ContextError>

delete_state_entries requests that each of the provided addresses be unset in validator state. A list of successfully deleted addresses is returned.

Arguments

  • addresses - the addresses to delete

fn add_receipt_data(&self, data: Vec<u8>) -> Result<(), ContextError>

add_receipt_data adds a blob to the execution result for this transaction

Arguments

  • data - the data to add

fn add_event(
    &self,
    event_type: String,
    attributes: Vec<(String, String)>,
    data: Vec<u8>
) -> Result<(), ContextError>

add_event adds a new event to the execution result for this transaction.

Arguments

  • event_type - This is used to subscribe to events. It should be globally unique and describe what, in general, has occured.
  • attributes - Additional information about the event that is transparent to the validator. Attributes can be used by subscribers to filter the type of events they receive.
  • data - Additional information about the event that is opaque to the validator.
Loading content...

Provided methods

fn get_state_entry(
    &self,
    address: &str
) -> Result<Option<Vec<u8>>, ContextError>

get_state_entry queries the validator state for data at the address given. If the address is set, the data is returned.

Arguments

  • address - the address to fetch

fn set_state_entry(
    &self,
    address: String,
    data: Vec<u8>
) -> Result<(), ContextError>

set_state_entry requests that the provided address is set in the validator state to its corresponding value.

Arguments

  • address - address of where to store the data
  • data - payload is the data to store at the address

fn delete_state_entry(
    &self,
    address: &str
) -> Result<Option<String>, ContextError>

delete_state_entry requests that the provided address be unset in validator state. A list of successfully deleted addresses is returned.

Arguments

  • address - the address to delete
Loading content...

Implementors

Loading content...