Struct EdgeConfig 

pub struct EdgeConfig {
    pub enabled: bool,
    pub role: EdgeRole,
    pub home_url: String,
    pub auth_token: String,
    pub allow_insecure_home_url: bool,
    pub default_ttl_secs: u64,
    pub max_entries: usize,
    pub max_edges: usize,
    pub liveness_window_secs: u64,
    pub subscribe_gc_secs: u64,
    pub region: String,
    pub edge_id: String,
}

Edge-mode runtime config ([edge] in proxy.toml). Every field is serde-defaulted so a partial — or absent — section parses on any build; the machinery only runs when enabled and the edge-proxy feature is compiled in (validate() rejects the former without the latter).

Fields

enabled: bool

Master switch. Off (default) = the edge cache/registry wiring is skipped entirely and this section is inert.

role: EdgeRole

“edge” or “home” mode. Edges forward writes + cache reads; home is authoritative.

home_url: String

For edge: home proxy admin URL (e.g. “https://proxy.home.svc:9090”). Empty when role = home.

auth_token: String

For edge: bearer token presented to home’s admin API for the invalidation subscription. Empty when role = home. When set, home_url must be https:// (or allow_insecure_home_url opted into) — the token is the home’s ADMIN bearer and must not cross an untrusted network in cleartext.

allow_insecure_home_url: bool

For edge: allow presenting auth_token to a plain-http home_url. Only for provably private links (VPN/WireGuard/ service mesh, loopback dev setups) — mirrors admin_allow_insecure on the home side.

default_ttl_secs: u64

Default TTL in seconds applied to cache entries when the home doesn’t supply one explicitly. Reads expire after this elapses. (Integer seconds, like every other *_secs duration knob.)

max_entries: usize

Maximum cache entries before LRU eviction kicks in.

max_edges: usize

For home: maximum simultaneous registered edge nodes.

liveness_window_secs: u64

For home: edges not seen within this window are pruned from the registry by the GC sweep (a pruned edge just re-registers on its next reconnect). Liveness is refreshed by successful SSE heartbeat writes (every 15s), so keep this comfortably above ~45s (3 heartbeats) or healthy-but-idle edges will churn.

subscribe_gc_secs: u64

For home: cadence of the registry GC sweep.

region: String

For edge: region label reported when subscribing to the home (shows up in the home’s /api/edge listing).

edge_id: String

For edge: stable id this proxy registers under. Empty (default) = the runtime falls back to “edge-”.

Implementations

impl EdgeConfig

pub fn default_ttl(&self) -> Duration

The entry TTL as a Duration (config carries integer seconds, matching every other *_secs knob).

Trait Implementations

impl Clone for EdgeConfig

fn clone(&self) -> EdgeConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EdgeConfig

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

Formats the value using the given formatter.

impl Default for EdgeConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EdgeConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for EdgeConfig

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for EdgeConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for EdgeConfig