Struct CachekitConfig 

pub struct CachekitConfig {
    pub api_key: Option<Zeroizing<String>>,
    pub api_url: String,
    pub master_key: Option<Zeroizing<Vec<u8>>>,
    pub previous_master_keys: Vec<Zeroizing<Vec<u8>>>,
    pub default_ttl: Duration,
    pub namespace: Option<String>,
    pub l1_capacity: usize,
    pub max_payload_bytes: usize,
}

Runtime configuration for a crate::client::CacheKit instance.

Fields

api_key: Option<Zeroizing<String>>

API key for cachekit.io authentication.

api_url: String

Base URL of the cachekit.io API.

master_key: Option<Zeroizing<Vec<u8>>>

Master key used for zero-knowledge encryption (AES-256-GCM).

previous_master_keys: Vec<Zeroizing<Vec<u8>>>

Decrypt-only previous master keys retained during a rotation grace window, in attempt order. Writes always use master_key; reads attempt it first, then these, sequentially. At most MAX_PREVIOUS_MASTER_KEYS entries.

default_ttl: Duration

Default TTL for cache entries when none is specified at call site.

namespace: Option<String>

Optional namespace prefix applied to all cache keys.

l1_capacity: usize

Maximum number of entries in the L1 in-process cache.

max_payload_bytes: usize

Maximum allowed payload size in bytes. Larger payloads are rejected.

Implementations

impl CachekitConfig

pub fn from_env() -> Result<Self, CachekitError>

Build configuration from environment variables.

Variable	Description
CACHEKIT_API_KEY	API key for cachekit.io
CACHEKIT_API_URL	Override API base URL (must be HTTPS)
CACHEKIT_MASTER_KEY	Hex-encoded master key (min 32 bytes)
CACHEKIT_PREVIOUS_MASTER_KEYS	Comma-separated hex-encoded decrypt-only previous master keys (max 3; blank value = unset)
CACHEKIT_DEFAULT_TTL	Default TTL in seconds (min 1)

Trait Implementations

impl Debug for CachekitConfig

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

Formats the value using the given formatter.

impl Default for CachekitConfig

fn default() -> Self

Returns the “default value” for a type.