blob: 7215da3528205997c51b08ce86527fd607b42785 (
plain)
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
|
//! Error types for the `equix` crate
pub use hashx::Error as HashError;
/// Errors applicable to constructing and verifying Equi-X puzzles
#[derive(Clone, Debug, thiserror::Error)]
#[non_exhaustive]
pub enum Error {
/// Errors inherited from [`hashx`]
///
/// Notably, [`HashError::ProgramConstraints`] needs to be handled
/// by any program which generates new challenge strings, and
/// [`HashError::Compiler`] may show up if you've chosen
/// [`crate::RuntimeOption::CompileOnly`] via [`crate::EquiXBuilder`].
#[error("hash construction error: {0}")]
Hash(#[from] HashError),
/// A solution does not meet Equi-X's ordering requirements.
///
/// This error occurs independently of the specific challenge
/// string. The lexicographic ordering constraints of a well
/// formed Equi-X solution were not met.
#[error("failed order constraint, Equi-X solution is not well formed")]
Order,
/// Failed hash sum verification of a challenge and solution.
///
/// The tree of hash sums computed from the solution and challenge
/// are required to have a number of low bits zeroed on each level.
/// One of these tests failed, and the solution is not valid.
#[error("failed to verify hash sum constraints for a specific Equi-X challenge and solution")]
HashSum,
}
|
