Struct RateLimitState 

pub struct RateLimitState(/* private fields */);

Shared, non-reloadable rate-limit store handle. Lives outside the module so a config hot reload (Fase 6 / Pillar 3) rebuilds the module’s parameters (capacity/refill/action) while the buckets survive — otherwise an attacker could clear their own throttle by triggering a reload. Holds an Arc<dyn StateStore> so the enterprise can inject a distributed store without forking (the seam of BOUNDARY §4).

Implementations

impl RateLimitState

pub fn new() -> Self

In-memory store with the default tracked-key cap.

pub fn in_memory(max_tracked_keys: usize) -> Self

In-memory store with an explicit tracked-key cap (system clock).

pub fn in_memory_with_clock( clock: Arc<dyn Clock>, max_tracked_keys: usize, ) -> Self

In-memory store with a custom clock + cap (deterministic tests).

pub fn with_store(store: Arc<dyn StateStore>) -> Self

Wrap an arbitrary store (the enterprise injection point).

pub fn try_acquire( &self, key: &str, cost: f64, params: BucketParams, ) -> Acquired

Delegate one atomic acquire to the underlying store. Exists so consumers in other crates (the rate-limit module) reach the store without touching the private handle — the store stays the single owner of the bucket state.

Trait Implementations

impl Clone for RateLimitState

fn clone(&self) -> RateLimitState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for RateLimitState

fn default() -> Self

Returns the “default value” for a type.