p2panda-core 0.7.1

Extensible data-types for secure, distributed and efficient exchange of data
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

// SPDX-License-Identifier: MIT OR Apache-2.0

use thiserror::Error;

use crate::logs::SeqNum;
use crate::operation::Version;

#[derive(Debug, Error)]
pub enum HeaderError {
    #[error("failed decoding CBOR byte string for header: {0}")]
    DecodingHeader(cbor_core::Error),

    #[error("failed decoding CBOR byte string for extensions: {0}")]
    DecodingExtensions(cbor_core::SerdeError),

    #[error("expected CBOR array for header: {0}")]
    UnexpectedHeaderType(cbor_core::Error),

    #[error("missing \"{0}\" field in header")]
    MissingField(&'static str),

    #[error("unexpected \"{0}\" field type for \"{0}\"")]
    UnexpectedFieldType(cbor_core::Error, &'static str),

    #[error("invalid verifying key: {0}")]
    InvalidVerifyingKey(crate::identity::IdentityError),

    #[error("invalid bytes length for \"{0}\", expected {1}, got {2} bytes")]
    InvalidBytesLen(&'static str, usize, usize),

    #[error("operation version {0} is not supported, needs to be <= {1}")]
    UnsupportedVersion(Version, Version),

    #[error("invalid signature")]
    InvalidSignature,

    #[error("unexpected excessive fields in header")]
    ExcessiveFields,

    #[error("didn't expect extensions but header contained excessive field")]
    UnexpectedExtensions,

    #[error("expected extensions but header didn't contain any")]
    MissingExtensions,

    #[error("failed encoding CBOR byte string for extensions: {0}")]
    EncodingExtensions(cbor_core::SerdeError),
}

#[derive(Clone, Debug, Error)]
pub enum OperationError {
    #[error("operation version {0} is not supported, needs to be <= {1}")]
    UnsupportedVersion(Version, Version),

    #[error("operation needs to be signed")]
    MissingSignature,

    #[error("signature does not match claimed public key")]
    SignatureMismatch,

    #[error("sequence number can't be 0 when backlink is given")]
    SeqNumMismatch,

    #[error("payload hash and -size need to be defined together")]
    InconsistentPayloadInfo,

    #[error("needs payload hash in header when body is given")]
    MissingPayloadHash,

    #[error("payload hash and size do not match given body")]
    PayloadMismatch,

    #[error("logs can not contain operations of different authors")]
    TooManyAuthors,

    #[error("expected sequence number {0} but found {1}")]
    SeqNumNonIncremental(SeqNum, SeqNum),

    #[error("expected backlink but none was given")]
    BacklinkMissing,

    #[error("given backlink did not match previous operation")]
    BacklinkMismatch,
}