ghostwire 1.1.0

A Rust library to bypass Cloudflare anti-bot protections
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

//! Error types for ghostwire.

use thiserror::Error;

/// Top-level error type.
#[derive(Debug, Error)]
pub enum GhostwireError {
    // ── Cloudflare challenge errors ───────────────────────────────────────────
    #[error("Cloudflare loop protection: tried to solve {0} time(s) in a row")]
    LoopProtection(usize),

    #[error("Cloudflare IUAM error: {0}")]
    IUAMError(String),

    #[error("Cloudflare challenge error: {0}")]
    ChallengeError(String),

    #[error("Cloudflare solve error: {0}")]
    SolveError(String),

    #[error("Cloudflare code 1020 – request blocked by firewall")]
    FirewallBlocked,

    #[error("Cloudflare captcha error: {0}")]
    CaptchaError(String),

    #[error("No captcha provider configured: {0}")]
    CaptchaProviderMissing(String),

    #[error("Cloudflare Turnstile error: {0}")]
    TurnstileError(String),

    #[error("Cloudflare v3 error: {0}")]
    V3Error(String),

    // ── Captcha solver errors ─────────────────────────────────────────────────
    #[error("Captcha service unavailable: {0}")]
    CaptchaServiceUnavailable(String),

    #[error("Captcha API error: {0}")]
    CaptchaAPIError(String),

    #[error("Captcha account error: {0}")]
    CaptchaAccountError(String),

    #[error("Captcha timeout: {0}")]
    CaptchaTimeout(String),

    #[error("Captcha parameter error: {0}")]
    CaptchaParameter(String),

    #[error("Bad captcha job ID: {0}")]
    CaptchaBadJobID(String),

    #[error("Captcha report error: {0}")]
    CaptchaReportError(String),

    // ── Network / HTTP errors ─────────────────────────────────────────────────
    #[error("HTTP error: {0}")]
    HttpError(#[from] reqwest::Error),

    #[error("URL parse error: {0}")]
    UrlParseError(#[from] url::ParseError),

    #[error("JSON error: {0}")]
    JsonError(#[from] serde_json::Error),

    #[error("Regex error: {0}")]
    RegexError(#[from] regex::Error),

    // ── Proxy errors ──────────────────────────────────────────────────────────
    #[error("Proxy error: {0}")]
    ProxyError(String),

    // ── Generic ───────────────────────────────────────────────────────────────
    #[error("{0}")]
    Other(String),
}

pub type Result<T> = std::result::Result<T, GhostwireError>;