ave-core 0.11.0

Averiun Ledger core runtime and node API
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

use thiserror::Error;

use ave_actors::ActorError;
use ave_common::identity::DigestIdentifier;

#[derive(Debug, Error, Clone)]
pub enum DistributorError {
    #[error("governance is not authorized")]
    GovernanceNotAuthorized,

    #[error("we are not witness for this subject")]
    NotWitness,

    #[error(
        "subject not found: we do not have the subject that we have been asked for"
    )]
    SubjectNotFound,

    #[error("sender '{sender}' is not a member of governance")]
    SenderNotMember { sender: String },

    #[error("sender does not have access to the subject")]
    SenderNoAccess,

    #[error("missing governance_id for tracker subject {subject_id}")]
    MissingGovernanceId { subject_id: DigestIdentifier },

    #[error(
        "missing governance_id in create event for tracker subject {subject_id}"
    )]
    MissingGovernanceIdInCreate { subject_id: DigestIdentifier },

    #[error("updating subject, need to fetch first event")]
    UpdatingSubject,

    #[error(
        "actual_sn ({actual_sn}) is greater than or equal to witness sn ({witness_sn})"
    )]
    ActualSnBiggerThanWitness { actual_sn: u64, witness_sn: u64 },

    #[error("sender is not the expected one")]
    UnexpectedSender,

    #[error("events list is empty")]
    EmptyEvents,

    #[error("missing create event in create ledger for subject {subject_id}")]
    MissingCreateEventInCreateLedger { subject_id: DigestIdentifier },

    #[error(
        "our governance version ({our_version}) is less than theirs ({their_version})"
    )]
    GovernanceVersionMismatch {
        our_version: u64,
        their_version: u64,
    },

    #[error("failed to get governance data: {details}")]
    GetGovernanceFailed { details: String },

    #[error("failed to up tracker: {details}")]
    UpTrackerFailed { details: String },

    #[error("failed to update subject ledger: {details}")]
    UpdateLedgerFailed { details: String },
}

impl From<DistributorError> for ActorError {
    fn from(error: DistributorError) -> Self {
        match error {
            DistributorError::GovernanceNotAuthorized
            | DistributorError::NotWitness
            | DistributorError::SubjectNotFound
            | DistributorError::SenderNotMember { .. }
            | DistributorError::SenderNoAccess
            | DistributorError::UpdatingSubject
            | DistributorError::ActualSnBiggerThanWitness { .. }
            | DistributorError::UnexpectedSender
            | DistributorError::EmptyEvents
            | DistributorError::MissingCreateEventInCreateLedger { .. }
            | DistributorError::GetGovernanceFailed { .. }
            | DistributorError::GovernanceVersionMismatch { .. } => {
                Self::Functional {
                    description: error.to_string(),
                }
            }
            DistributorError::MissingGovernanceId { .. }
            | DistributorError::MissingGovernanceIdInCreate { .. }
            | DistributorError::UpTrackerFailed { .. }
            | DistributorError::UpdateLedgerFailed { .. } => {
                Self::FunctionalCritical {
                    description: error.to_string(),
                }
            }
        }
    }
}