Skip to main content

Crate wafrift_strategy

Crate wafrift_strategy 

Source
Expand description

wafrift-strategy — Evasion strategy pipeline.

The orchestrator that wires all WAF Rift modules into a coherent evasion flow: request → fingerprint → grammar → encoding → header → content-type → result.

§Examples

Per-host adaptation: the strategy keeps a HostState for each target. As blocks pile up the engine escalates encoding choices; once a technique consistently bypasses, it gets promoted to a “proven winner” and the engine rotates through the winner pool instead of re-discovering from scratch.

use wafrift_strategy::HostState;
use wafrift_types::technique::Technique;

let mut state = HostState::default();
assert!(!state.waf_confirmed);
assert_eq!(state.blocks, 0);

// Three confirmed blocks — strategy now knows escalation is needed.
state.record_block();
state.record_block();
state.record_block();
assert_eq!(state.blocks, 3);
assert!(state.needs_evasion());

// After a single technique succeeds, last_success is populated and
// the per-technique success rate gets tracked for future rotation.
state.record_success(Technique::HeaderObfuscation("uppercase".into()));
assert!(state.last_success.is_some());

Re-exports§

pub use host_state::HostState;
pub use learning_cache::LearningCache;
pub use pipeline::EvasionPipeline;
pub use pipeline::EvasionPlanOutput;
pub use planner::plan_pipelines;
pub use strategy::*;

Modules§

composition
Pipeline composition grammar.
cost
Cost model for evasion techniques.
explain
Per-finding explanation engine for audit reports.
gene_bank
Cross-target gene bank — persistent WAF evasion memory.
host_state
Per-host evasion state — tracks what works and what doesn’t.
learning_cache
Learning cache — persistent per-WAF, per-payload-type pipeline memory.
mcts_bridge
MCTS bridge for intelligent evasion trajectory optimization. Bridge connecting the abstract Monte Carlo Tree Search framework to WafRift’s concrete HTTP Request types.
pipeline
Evasion pipeline — an ordered sequence of techniques with a cost estimate.
planner
Strategy planner — generates ordered lists of evasion pipelines.
strategy
Evasion strategy engine — the pipeline that wires ALL modules.
waf_presets
WAF-specific evasion presets loaded from TOML rules. WAF-specific evasion presets loaded from TOML rules.