near-primitives-core 0.37.3

This crate provides the core set of primitives used by other nearcore crates including near-primitives
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

use std::fmt::{Display, Formatter};

/// Indicates the phase of block production the apply-chunk operation is invoked.
/// This is used to differentiate the logics in the chunk application, as well as analyzing and comparing
/// the metrics collected while applying the receipts for different purposes, eg. while updating state of
/// a tracked shard vs. validating a chunk.
/// TODO: Consider combining ApplyChunkReason, ApplyChunkBlockContext, and ApplyChunkBlockContext
/// under a common wrapper struct such as ApplyChunkContext.
#[derive(Clone, Debug, PartialEq, Eq)]
pub enum ApplyChunkReason {
    /// Apply-chunk is invoked to update the state of a shards being tracked.
    UpdateTrackedShard,
    /// Apply-chunk is invoked to validate the state witness for a shard in the context of stateless validation.
    ValidateChunkStateWitness,
    /// Apply-chunk is invoked to view the state of a tracked shard (eg. calling a function from a specific state).
    ViewTrackedShard,
}

impl ApplyChunkReason {
    /// Returns a static, short string representation of the reason, to be used for metrics.
    pub fn as_str(&self) -> &'static str {
        match self {
            ApplyChunkReason::UpdateTrackedShard => "update_shard",
            ApplyChunkReason::ValidateChunkStateWitness => "validate_chunk",
            ApplyChunkReason::ViewTrackedShard => "view_shard",
        }
    }
}

impl Display for ApplyChunkReason {
    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), std::fmt::Error> {
        f.write_str(self.as_str())
    }
}