Skip to main content

Crate guise

Crate guise 

Source
Expand description

guise: canonical stealth substrate for the Santh fleet.

guise consolidates the fleet’s previously-duplicated stealth implementations (captchaforge, archived golemn-browser, wafrift, see MASTER_PLAN/02_stealth.md) into one lib with four orthogonal primitives: browser-fingerprint profiles, human-behavior timing, TLS-profile re-exports, and a runtime stealth-probe that verifies the disguise actually defeats detection at runtime (not just that the override is present in source).

§Vocabulary (one naming convention)

  • StealthProfile is the canonical selector: the one enum naming a coherent (browser, OS, GPU) identity. Everything derives from it.
  • profile_facts(StealthProfile) -> ProfileFacts is the source data.
  • A <Domain>Profile is a pure, derived projection of that data for one domain (e.g. HeaderProfile (HTTP headers), and the TLS / geo facets). There is exactly one type per projection; no per-module duplicates.
  • Applied / runtime instances are named for what they are, never *Profile (e.g. http::RequestHeaders (a materialized header set)).
  • Home-rule: fingerprint/ owns fingerprint DATA; http/ and cdp/ APPLY it.

§Features

FeatureEnables
fingerprint (default)fingerprint profile bundles + JS overrides
human (default)human keystroke / mouse / behavioral-grammar timing
http-headers (default via http)http browser header templates without TLS deps
http (default)http browser headers + TLS profile re-exports
pacing (default)pacing jitter + retry backoff policies
rotation (default)rotation profile cycling + config-name resolution
config (default)config Tier-A defaults→TOML→CLI configuration
tls-impersonate[http::StealthClient] (wreq / BoringSSL)
browser[browser] BiDi stealth application, human timing, and the [probe] runtime self-test
tier-b-toml[ProfileBundle::from_toml] community profiles

§Safe defaults

  • Input size: No cap enforced. All inputs are in-memory Rust values (&str, typed structs). The only I/O is ProfileBundle::from_toml (the tier-b-toml feature), which reads a TOML file entirely into a String via std::fs::read_to_string - the limit is the OS file-size limit; no internal byte cap is applied. All other APIs operate on already-loaded in-memory data with no size constraint.
  • Recursion depth: No recursive algorithms are present in this crate. All iteration is flat (loops over slices and hash-map look-ups); stack depth is bounded by the call chain depth alone.
  • Outbound network: None. This crate emits no outbound connections of any kind. The http feature re-exports type definitions from scanclient but does not initiate requests; the optional tls-impersonate feature’s StealthClient is owned by scanclient and is only forwarded here.
  • Process spawning: The browser feature delegates process spawning to the runtime-foxdriver crate (Firefox BiDi launch). guise itself does not call std::process::Command directly.
  • Filesystem writes: None. The only filesystem access is the read in ProfileBundle::from_toml (tier-b-toml feature). No file is written, created, or truncated anywhere in this crate.
  • Credential exposure: None. This crate holds no credentials, API keys, or secrets and does not log, serialize, or transmit caller-supplied data outside the process. Profile bundles contain only synthetic browser fingerprint constants (UA strings, screen sizes, WebGL strings).

Re-exports§

pub use fingerprint::ProfileBundle;
pub use fingerprint::ProfileError;
pub use human::Keystroke;
pub use human::TypingPlan;
pub use human::keystroke::bigram_gap;
pub use human::keystroke::hold_envelope;
pub use human::keystroke::plan_keystrokes;
pub use human::keystroke::qwerty_neighbour;
pub use fingerprint::profile_js;
pub use fingerprint::profile_to_overrides;
pub use fingerprint::ProfileOverrides;

Modules§

choice
Re-exported random choice primitives.
config
Tier-A configuration for the guise persona lifecycle.
fingerprint
Coherent browser fingerprint profile bundles (lifted from captchaforge).
http
HTTP stealth profile helpers.
human
Human-behavior emulation: timing and motion drawn from real human data so an automated session is indistinguishable from a person at the input layer.
pacing
Compatibility re-export for the canonical pacing crate.
persona_pool
Persona lifecycle pool: select → assemble → bind transport → behavior → rotate.
rotation
Canonical profile rotation for cross-plane stealth identity.

Enums§

StealthProfile
Named browser fingerprint variants. Each one identifies a coherent (browser, OS, GPU class) tuple used by higher-level stealth crates.

Constants§

DEFAULT_STEALTH_PROFILE
Canonical default stealth identity for fleet-owned browser and HTTP launches.