Struct ApplicationRegistryView

pub struct ApplicationRegistryView<C> {
    pub known_applications: HashedMapView<C, UserApplicationId, UserApplicationDescription>,
}

Fields

known_applications: HashedMapView<C, UserApplicationId, UserApplicationDescription>

The applications that are known by the chain.

Implementations

impl<C> ApplicationRegistryView<C>

where C: Context + Clone + Send + Sync + 'static,

pub async fn register_application( &mut self, application: UserApplicationDescription, ) -> Result<UserApplicationId, SystemExecutionError>

Registers an existing application.

Keeps track of an existing application that the current chain is seeing for the first time.

pub async fn register_new_application( &mut self, application_id: UserApplicationId, parameters: Vec<u8>, required_application_ids: Vec<UserApplicationId>, ) -> Result<(), SystemExecutionError>

Registers a newly created application.

pub async fn describe_application( &self, id: UserApplicationId, ) -> Result<UserApplicationDescription, SystemExecutionError>

Retrieves an application’s description.

pub async fn find_dependencies( &self, stack: Vec<UserApplicationId>, registered_apps: &HashMap<UserApplicationId, UserApplicationDescription>, ) -> Result<Vec<UserApplicationId>, SystemExecutionError>

Retrieves the recursive dependencies of applications and apply a topological sort.

pub async fn describe_applications_with_dependencies( &self, ids: Vec<UserApplicationId>, extra_registered_apps: &HashMap<UserApplicationId, UserApplicationDescription>, ) -> Result<Vec<UserApplicationDescription>, SystemExecutionError>

Retrieves applications’ descriptions preceded by their recursive dependencies.

Trait Implementations

impl<C> ClonableView<C> for ApplicationRegistryView<C>

where C: Context + Send + Sync + Clone + 'static,

fn clone_unchecked(&mut self) -> Result<Self, ViewError>

Creates a clone of this view, sharing the underlying storage context but prone to data races which can corrupt the view state.

impl<C: Debug> Debug for ApplicationRegistryView<C>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<C> HashableView<C> for ApplicationRegistryView<C>

where C: Context + Send + Sync + Clone + 'static,

type Hasher = CoreWrapper<Sha3_256Core>

How to compute hashes.

fn hash_mut<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<<Self::Hasher as Hasher>::Output, ViewError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Computes the hash of the values.

fn hash<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<<Self::Hasher as Hasher>::Output, ViewError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Computes the hash of the values.

impl<C> View<C> for ApplicationRegistryView<C>

where C: Context + Send + Sync + Clone + 'static,

const NUM_INIT_KEYS: usize = 1usize

The number of keys used for the initialization

fn context(&self) -> &C

Obtains a mutable reference to the internal context.

fn pre_load(context: &C) -> Result<Vec<Vec<u8>>, ViewError>

Creates the keys needed for loading the view

fn post_load(context: C, values: &[Option<Vec<u8>>]) -> Result<Self, ViewError>

Loads a view from the values

fn load<'async_trait>( context: C, ) -> Pin<Box<dyn Future<Output = Result<Self, ViewError>> + Send + 'async_trait>>

where Self: 'async_trait,

Loads a view

fn rollback(&mut self)

Discards all pending changes. After that flush should have no effect to storage.

fn has_pending_changes<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = bool> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns true if flushing this view would result in changes to the persistent storage.

fn flush(&mut self, batch: &mut Batch) -> Result<bool, ViewError>

Persists changes to storage. This leaves the view still usable and is essentially neutral to the program running. Crash-resistant storage implementations are expected to accumulate the desired changes in the batch variable first. If the view is dropped without calling flush, staged changes are simply lost. The returned boolean indicates whether the operation removes the view or not.

fn clear(&mut self)

Clears the view. That can be seen as resetting to default. If the clear is followed by a flush then all the relevant data is removed on the storage.

fn new(context: C) -> Result<Self, ViewError>

Builds a trivial view that is already deleted