Struct exonum_configuration::Service

pub struct Service { /* fields omitted */ }

ConfigurationService config.

Trait Implementations

impl Default for Service

fn default() -> Service

Returns the "default value" for a type.

impl Debug for Service

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

Formats the value using the given formatter.

impl Service for Service

fn service_id(&self) -> u16

Service identifier for database schema and service messages. This ID must be unique within the blockchain.

fn service_name(&self) -> &'static str

A comprehensive string service name. This name must be unique within the blockchain.

fn state_hash(&self, snapshot: &dyn Snapshot) -> Vec<Hash>

Returns a list of root hashes of tables that determine the current state of the service database. These hashes are collected from all the services in a common ProofMapIndex accessible in the core schema as [state_hash_aggregator][1].

fn tx_from_raw(
    &self,
    raw: RawTransaction
) -> Result<Box<dyn Transaction>, Error>

Tries to create a Transaction from the given raw message.

fn initialize(&self, _fork: &Fork) -> Value

Invoked for all deployed services during the blockchain initialization on genesis block creation each time a node is started. During the handling of the method the service is able to perform the following activities: - store its own initial state to the storage [&mut Fork] - return an initial [global configuration][doc:global_cfg] of the service in the JSON format, if service has global configuration parameters. This configuration is used to create a genesis block.

fn wire_api(&self, builder: &mut ServiceApiBuilder)

Extends API by handlers of this service. The request handlers are mounted on the /api/services/{service_name} path at the listen address of every full node in the blockchain network.

fn before_commit(&self, fork: &Fork)

A service execution. This method is invoked for each service after execution of all transactions in the block but before after_commit handler.

fn after_commit(&self, context: &ServiceContext)

Handles block commit. This handler is invoked for each service after commit of the block. For example, a service can create one or more transactions if a specific condition has occurred.