radix-transactions 1.3.1

Various Radix transaction models and the manifest compiler/decompiler, from the Radix DLT project.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

use radix_substate_store_interface::interface::SubstateDatabase;

use crate::internal_prelude::*;

#[derive(Debug, Copy, Clone, PartialEq, Eq)]
pub struct TransactionValidator {
    pub(super) config: TransactionValidationConfig,
    pub(super) required_network_id: Option<u8>,
}

impl TransactionValidator {
    /// This is the best constructor to use, as it reads the configuration dynamically
    /// Note that the validator needs recreating every time a protocol update runs,
    /// as the config can get updated then.
    pub fn new(database: &impl SubstateDatabase, network_definition: &NetworkDefinition) -> Self {
        Self::new_with_static_config(
            TransactionValidationConfig::load(database),
            network_definition.id,
        )
    }

    pub fn new_for_latest_simulator() -> Self {
        Self::new_with_static_config(
            TransactionValidationConfig::latest(),
            NetworkDefinition::simulator().id,
        )
    }

    pub fn new_with_latest_config(network_definition: &NetworkDefinition) -> Self {
        Self::new_with_static_config(TransactionValidationConfig::latest(), network_definition.id)
    }

    pub fn new_with_static_config(config: TransactionValidationConfig, network_id: u8) -> Self {
        Self {
            config,
            required_network_id: Some(network_id),
        }
    }

    pub fn new_with_latest_config_network_agnostic() -> Self {
        Self::new_with_static_config_network_agnostic(TransactionValidationConfig::latest())
    }

    pub fn new_with_static_config_network_agnostic(config: TransactionValidationConfig) -> Self {
        Self {
            config,
            required_network_id: None,
        }
    }

    /// Will typically be [`Some`], but [`None`] if the validator is network-independent.
    pub fn network_id(&self) -> Option<u8> {
        self.required_network_id
    }

    pub fn config(&self) -> &TransactionValidationConfig {
        &self.config
    }

    pub fn preparation_settings(&self) -> &PreparationSettings {
        &self.config.preparation_settings
    }
}

// Concrete methods on `TransactionValidator` are implemented across
// other modules, such as `transaction_validator_v1`, to avoid this
// file growing to an unmanagable size.