tari_mmr/
error.rs

1// Copyright 2019 The Tari Project
2//
3// Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
4// following conditions are met:
5//
6// 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following
7// disclaimer.
8//
9// 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the
10// following disclaimer in the documentation and/or other materials provided with the distribution.
11//
12// 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote
13// products derived from this software without specific prior written permission.
14//
15// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
16// INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
17// DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
18// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
19// SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
20// WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
21// USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
22
23use thiserror::Error;
24
25#[derive(Debug, Error, PartialEq, Eq, Clone)]
26pub enum MerkleMountainRangeError {
27    #[error("The next position was not a leaf node as expected")]
28    CorruptDataStructure,
29    #[error("A problem has been encountered with the backend: `{0}`")]
30    BackendError(String),
31    #[error("The Merkle tree is not internally consistent. A parent hash isn't equal to the hash of its children")]
32    InvalidMerkleTree,
33    #[error("The tree has reached its maximum size")]
34    MaximumSizeReached,
35    #[error("A node hash was not found for the given node index: `{0}`")]
36    HashNotFound(usize),
37    #[error("A request was out of range")]
38    OutOfRange,
39    #[error("Conflicting or invalid configuration parameters provided.")]
40    InvalidConfig,
41    #[error("Invalid Merkle Mountain Range size")]
42    InvalidMmrSize,
43    #[error("Invalid leaf index")]
44    InvalidLeafIndex,
45}
46
47impl MerkleMountainRangeError {
48    pub fn backend_error<E: ToString>(err: &E) -> Self {
49        Self::BackendError(err.to_string())
50    }
51}