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

//! Captcha solver trait and built-in provider implementations.

use async_trait::async_trait;
use serde::{Deserialize, Serialize};

use crate::error::Result;

// ── Captcha type ──────────────────────────────────────────────────────────────

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum CaptchaKind {
    ReCaptcha,
    HCaptcha,
    Turnstile,
}

// ── Provider config ───────────────────────────────────────────────────────────

/// Configuration passed to a captcha solver.
#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct CaptchaConfig {
    /// Which provider to use (e.g. "2captcha", "anticaptcha", "capsolver").
    pub provider: String,
    /// Provider API key (field name varies by provider but stored here uniformly).
    pub api_key: Option<String>,
    /// clientKey for anticaptcha-style APIs.
    pub client_key: Option<String>,
    /// Optional proxy to pass to the captcha service.
    pub proxy: Option<String>,
    /// If true, don't forward the proxy to the captcha service.
    pub no_proxy: bool,
}

// ── Solver trait ──────────────────────────────────────────────────────────────

/// Any struct implementing this trait can solve captcha challenges.
#[async_trait]
pub trait CaptchaSolver: Send + Sync {
    /// Submit the captcha and return the solved token.
    async fn solve(
        &self,
        kind: CaptchaKind,
        page_url: &str,
        site_key: &str,
        config: &CaptchaConfig,
    ) -> Result<String>;
}

// ── Built-in providers ────────────────────────────────────────────────────────

pub mod anticaptcha;
pub mod capsolver;
pub mod twocaptcha;

pub use anticaptcha::AntiCaptchaSolver;
pub use capsolver::CapsolverSolver;
pub use twocaptcha::TwoCaptchaSolver;

/// Create a solver from a `CaptchaConfig`.
pub fn make_solver(config: &CaptchaConfig) -> Option<Box<dyn CaptchaSolver>> {
    match config.provider.to_lowercase().as_str() {
        "2captcha" => Some(Box::new(TwoCaptchaSolver::new())),
        "anticaptcha" => Some(Box::new(AntiCaptchaSolver::new())),
        "capsolver" => Some(Box::new(CapsolverSolver::new())),
        _ => None,
    }
}