casper-storage 2.1.1

Storage for a node on the Casper network.
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

use std::sync;

use thiserror::Error;

use casper_types::{bytesrepr, Digest, Key};

use crate::global_state::{state::CommitError, trie::TrieRaw};

use super::trie_store::TrieStoreCacheError;

/// Error enum representing possible errors in global state interactions.
#[derive(Debug, Clone, Error, PartialEq, Eq)]
#[non_exhaustive]
pub enum Error {
    /// LMDB error returned from underlying `lmdb` crate.
    #[error(transparent)]
    Lmdb(#[from] lmdb::Error),

    /// (De)serialization error.
    #[error("{0}")]
    BytesRepr(#[from] bytesrepr::Error),

    /// Concurrency error.
    #[error("Another thread panicked while holding a lock")]
    Poison,

    /// Error committing to execution engine.
    #[error(transparent)]
    Commit(#[from] CommitError),

    /// Invalid state root hash.
    #[error("RootNotFound")]
    RootNotFound,

    /// Failed to put a trie node into global state because some of its children were missing.
    #[error("Failed to put a trie into global state because some of its children were missing")]
    MissingTrieNodeChildren(Digest, TrieRaw, Vec<Digest>),

    /// Failed to prune listed keys.
    #[error("Pruning attempt failed.")]
    FailedToPrune(Vec<Key>),

    /// Cannot provide proofs over working state in a cache (programmer error).
    #[error("Attempt to generate proofs using non-empty cache.")]
    CannotProvideProofsOverCachedData,

    /// Encountered a cache error.
    #[error("Cache error")]
    CacheError(#[from] TrieStoreCacheError),
}

impl<T> From<sync::PoisonError<T>> for Error {
    fn from(_error: sync::PoisonError<T>) -> Self {
        Error::Poison
    }
}