dome-throttle 0.1.0

Token-bucket rate limiting and budget tracking for MCPDome
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

# dome-throttle

Token-bucket rate limiting and budget tracking for MCPDome.

## What it does

- Provides `RateLimiter` with per-identity and per-tool token-bucket rate limiting, using DashMap for lock-free concurrent access.
- Provides `BudgetTracker` for cumulative spend tracking per identity with configurable rolling time windows and caps.
- Returns `DomeError::RateLimited` or `DomeError::BudgetExhausted` on violation, allowing the interceptor chain to block and audit the request.
- Supports configurable bucket sizes, refill rates, and budget limits via `RateLimiterConfig` and `BudgetTrackerConfig`.

## Usage

```toml
[dependencies]
dome-throttle = "0.1"
```

```rust
use dome_throttle::{RateLimiter, RateLimiterConfig};

let limiter = RateLimiter::new(RateLimiterConfig::default());
limiter.check_rate_limit("user:alice", Some("read_file"))?;
```

## Part of MCPDome

This crate is part of [MCPDome](https://github.com/orellius/mcpdome), a security gateway for the Model Context Protocol. See the main repository for full documentation.

## License

Apache-2.0