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)
StealthProfileis the canonical selector: the one enum naming a coherent (browser, OS, GPU) identity. Everything derives from it.profile_facts(StealthProfile) -> ProfileFactsis the source data.- A
<Domain>Profileis 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/andcdp/APPLY it.
§Features
| Feature | Enables |
|---|---|
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 isProfileBundle::from_toml(thetier-b-tomlfeature), which reads a TOML file entirely into aStringviastd::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
httpfeature re-exports type definitions fromscanclientbut does not initiate requests; the optionaltls-impersonatefeature’sStealthClientis owned byscanclientand is only forwarded here. - Process spawning: The
browserfeature delegates process spawning to theruntime-foxdrivercrate (Firefox BiDi launch).guiseitself does not callstd::process::Commanddirectly. - Filesystem writes: None. The only filesystem access is the read in
ProfileBundle::from_toml(tier-b-tomlfeature). 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§
- Stealth
Profile - 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.