Struct HostContract 

pub struct HostContract {
    pub csi_bind: SocketAddr,
    pub sensor_url: Option<SocketAddr>,
    pub token: SecretString,
    pub ingest_upstream: Option<SocketAddr>,
    pub ingest_url: Option<String>,
    pub expose_token: bool,
}

Host contract for one instance.

Fields

csi_bind: SocketAddr

UDP bind the cog listens on for the sensor feed.

sensor_url: Option<SocketAddr>

HTTP sensor fallback address (host:port), if any.

token: SecretString

Per-instance token.

ingest_upstream: Option<SocketAddr>

The node’s ingest bridge as the instance’s network sees it. A cog always posts to its own 127.0.0.1:80; container adapters relay that port here (super::container_relay). None means the cog’s loopback already reaches the bridge (native, network=host).

ingest_url: Option<String>

Ingest bridge URL injected as ENV_INGEST_URL, if any.

expose_token: bool

False: the instance gets no ENV_TOKEN (and no ingest URL). Set when the node’s ingest bridge is down, so a cog never carries a credential for a bridge that is not there.

Implementations

impl HostContract

pub fn new(csi_bind: SocketAddr) -> Self

Contract binding the feed on csi_bind, with a fresh random token.

pub fn default_feed() -> Self

Default: feed on 0.0.0.0:5006.

pub fn with_sensor(self, addr: SocketAddr) -> Self

Builder: HTTP sensor fallback.

pub fn with_ingest_upstream(self, addr: SocketAddr) -> Self

Builder: ingest bridge address as seen from inside the instance.

pub fn with_ingest_url(self, url: impl Into<String>) -> Self

Builder: bridge URL handed to the cog as ENV_INGEST_URL.

pub fn without_ingest(self) -> Self

Builder: hand the instance no token and no ingest URL.

pub fn fresh_token() -> SecretString

32 random bytes, lower-case hex.

pub fn token_hash(&self) -> String

Short BLAKE3 fingerprint of the token, safe for chain payloads.

pub fn validate(&self) -> Result<(), RuntimeError>

Validate before use.

pub fn env(&self, data_dir: &str) -> Vec<(String, String)>

Environment for the instance. data_dir is where the runtime mounts or creates the instance’s writable directory.

pub fn audit(&self) -> Value

Chain-safe summary (token as hash only).

Trait Implementations

impl Clone for HostContract

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HostContract

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

Formats the value using the given formatter.