Struct Cooldown

pub struct Cooldown {
    pub last_event_ns: Option<u64>,
    pub interval_ns: u64,
}

Tracks cooldown state for rate-limited operations.

A cooldown enforces a minimum interval between operations. It tracks when the last operation occurred and the required interval before the next operation is allowed.

Fields

last_event_ns: Option<u64>

Timestamp of the last operation (nanoseconds), if any.

interval_ns: u64

Required interval between operations (nanoseconds). Zero means no cooldown (always ready).

Implementations

impl Cooldown

pub fn new(interval_ns: u64) -> Self

pub fn unlimited() -> Self

pub fn is_unlimited(&self) -> bool

pub fn is_ready(&self, current_ns: u64) -> bool

Check if an operation is allowed at the given timestamp.

Returns true if:

• No cooldown is configured (interval_ns == 0), or
• No previous operation has occurred, or
• Sufficient time has elapsed since the last operation

pub fn check(&self, current_ns: u64) -> Result<(), CooldownError>

Check cooldown and return an error if not ready.

pub fn record(&self, timestamp_ns: u64) -> Self

pub fn ready_at(&self) -> Option<u64>

pub fn remaining(&self, current_ns: u64) -> u64

Trait Implementations

impl BorshDeserialize for Cooldown

fn deserialize_reader<__R: Read>(reader: &mut __R) -> Result<Self, Error>

fn deserialize(buf: &mut &[u8]) -> Result<Self, Error>

Deserializes this instance from a given slice of bytes. Updates the buffer to point at the remaining bytes.

fn try_from_slice(v: &[u8]) -> Result<Self, Error>

Deserialize this instance from a slice of bytes.

fn try_from_reader<R>(reader: &mut R) -> Result<Self, Error>

where R: Read,

impl BorshSerialize for Cooldown

fn serialize<__W: Write>(&self, writer: &mut __W) -> Result<(), Error>

impl Clone for Cooldown

fn clone(&self) -> Cooldown

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Cooldown

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Cooldown

fn default() -> Cooldown

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Cooldown

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Cooldown

fn eq(&self, other: &Cooldown) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Cooldown

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Cooldown

impl StructuralPartialEq for Cooldown