2021-03-02 11:09:29 +05:30
|
|
|
/*
|
|
|
|
* mCaptcha - A proof of work based DoS protection system
|
|
|
|
* Copyright © 2021 Aravinth Manivannan <realravinth@batsense.net>
|
|
|
|
*
|
|
|
|
* This program is free software: you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU Affero General Public License as
|
|
|
|
* published by the Free Software Foundation, either version 3 of the
|
|
|
|
* License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU Affero General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Affero General Public License
|
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
*/
|
|
|
|
|
|
|
|
//! Errors and Result module
|
2021-02-28 15:05:39 +05:30
|
|
|
use derive_more::{Display, Error};
|
|
|
|
|
2021-03-02 11:09:29 +05:30
|
|
|
/// Error datatype
|
2021-02-28 15:05:39 +05:30
|
|
|
#[derive(Debug, PartialEq, Display, Clone, Error)]
|
|
|
|
#[cfg(not(tarpaulin_include))]
|
|
|
|
pub enum CaptchaError {
|
2021-03-02 11:09:29 +05:30
|
|
|
/// When configuring m_captcha, [DefenseBuilder][crate::defense::DefenseBuilder]
|
|
|
|
/// must be passed atleast one `LevelConfig` if not this error will arise
|
2021-02-28 15:05:39 +05:30
|
|
|
#[display(fmt = "LevelBuilder should have atleaset one level configured")]
|
|
|
|
LevelEmpty,
|
2021-02-28 23:26:32 +05:30
|
|
|
|
2021-03-02 11:09:29 +05:30
|
|
|
/// Visitor count must be a whole number(zero and above).
|
|
|
|
/// When configuring m_captcha, [LevelBuilder][crate::defense::LevelBuilder].
|
|
|
|
/// difficulty_factor must be set to greater than zero.
|
2021-02-28 15:05:39 +05:30
|
|
|
#[display(fmt = "difficulty factor must be greater than zero")]
|
|
|
|
DifficultyFactorZero,
|
2021-02-28 23:26:32 +05:30
|
|
|
|
2021-02-28 15:05:39 +05:30
|
|
|
/// Difficulty factor must be set
|
|
|
|
#[display(fmt = "Set difficulty factor")]
|
|
|
|
SetDifficultyFactor,
|
2021-02-28 23:26:32 +05:30
|
|
|
|
2021-03-02 12:01:15 +05:30
|
|
|
/// Visitor threshold must be set
|
|
|
|
#[display(fmt = "Set visitor threshold")]
|
|
|
|
SetVisitorThreshold,
|
2021-02-28 15:05:39 +05:30
|
|
|
|
|
|
|
/// Visitor count must be Unique
|
|
|
|
#[display(fmt = "Duplicate visitor count")]
|
|
|
|
DuplicateVisitorCount,
|
|
|
|
|
|
|
|
/// Difficulty factor should increase with level
|
|
|
|
#[display(fmt = "Difficulty factor should increase with level")]
|
|
|
|
DecreaseingDifficultyFactor,
|
2021-03-05 21:52:41 +05:30
|
|
|
|
|
|
|
/// Difficulty factor should increase with level
|
|
|
|
#[display(fmt = "Actor mailbox error")]
|
|
|
|
MailboxError,
|
2021-03-08 18:14:34 +05:30
|
|
|
|
|
|
|
/// Happens when submitted work doesn't satisfy the required
|
|
|
|
/// difficulty factor
|
|
|
|
#[display(fmt = "Insuffiencient Difficulty")]
|
|
|
|
InsuffiencientDifficulty,
|
|
|
|
|
|
|
|
/// Happens when submitted work is computed over string that
|
|
|
|
/// isn't in cache
|
|
|
|
#[display(fmt = "String now found")]
|
|
|
|
StringNotFound,
|
|
|
|
|
|
|
|
/// Catcha all default error
|
|
|
|
/// used for development, must remove before production
|
|
|
|
#[display(fmt = "TODO remove before prod")]
|
|
|
|
Default,
|
2021-02-28 15:05:39 +05:30
|
|
|
}
|
|
|
|
|
|
|
|
/// [Result] datatype for m_captcha
|
|
|
|
pub type CaptchaResult<V> = std::result::Result<V, CaptchaError>;
|