# Class BSV::Network::Services::TokenBucket <a id="class-BSV-Network-Services-TokenBucket"></a>

**Inherits:** `Object`

Simple token bucket rate limiter. One per provider. Refills at `rate` tokens
per second. Burst capacity is max(rate, 1) so that sub-1 rates (e.g. 0.5
req/sec) can still acquire a token.

## Public Instance Methods
### `acquire!()` <a id="method-i-acquire-21"></a> <a id="acquire!-instance_method"></a>
Block until a token is available, then consume it.

### `initialize(rate)` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
- **@raise** [ArgumentError]
- **@return** [TokenBucket] a new instance of TokenBucket