Struct CacheConfig 

pub struct CacheConfig {
    pub path: Option<String>,
    pub cmn_ttl_s: u64,
    pub key_trust_ttl_s: u64,
    pub key_trust_refresh_mode: KeyTrustRefreshMode,
    pub key_trust_synapse_witness_mode: SynapseWitnessMode,
    pub max_download_bytes: u64,
    pub max_extract_bytes: u64,
    pub max_extract_files: u64,
    pub max_extract_file_bytes: u64,
    pub clock_skew_tolerance_s: u64,
    pub require_domain_first_key: bool,
}

Fields

path: Option<String>

Custom cache directory path (default: $CMN_HOME/hypha/cache/)

cmn_ttl_s: u64

cmn.json cache TTL in seconds (default: 300 = 5 minutes)

key_trust_ttl_s: u64

Key trust cache TTL in seconds (default: 604800 = 7 days)

key_trust_refresh_mode: KeyTrustRefreshMode

Key trust refresh strategy (default: expired)

key_trust_synapse_witness_mode: SynapseWitnessMode

Key trust fallback policy when domain is unreachable (default: allow)

max_download_bytes: u64

Maximum HTTP response body size in bytes (default: 1 GB)

max_extract_bytes: u64

Maximum total bytes to extract from an archive (default: 512 MB)

max_extract_files: u64

Maximum number of files to extract from an archive (default: 100_000)

max_extract_file_bytes: u64

Maximum size of a single file in an archive in bytes (default: 256 MB)

clock_skew_tolerance_s: u64

Clock skew tolerance in seconds for key trust TTL checks (default: 300 = 5 minutes). Adds a grace period to prevent false “key_untrusted” errors caused by clock drift between the local machine and the publishing domain.

require_domain_first_key: bool

Whether the initial key for a domain must come from the domain itself (TOFU). true = more secure, first contact requires domain to be online. false = allows synapse to provide initial key (less secure).

Trait Implementations

impl Debug for CacheConfig

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

Formats the value using the given formatter.

impl Default for CacheConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CacheConfig

where CacheConfig: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CacheConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.