pub struct LinkHost { /* private fields */ }Expand description
This liminal as a machine Lys knows (ACCESS-002 R1): the identity its links are keyed from, its own pass’s link rights, and the machine keys Lys recorded for the holders that may open links to it.
The recorded keys are the operator’s mirror of Lys’s directory
([auth.lys.machine] machines) until liminal reads the directory itself;
a holder with no recorded key cannot open a link, and an offered key that
is not the recorded one is refused by name.
Implementations§
Source§impl LinkHost
impl LinkHost
Sourcepub const fn new(
local: LocalMachine,
rights: Box<dyn LinkRights>,
recorded: BTreeMap<String, MachineIdentity>,
) -> Self
pub const fn new( local: LocalMachine, rights: Box<dyn LinkRights>, recorded: BTreeMap<String, MachineIdentity>, ) -> Self
This machine, its own link rights, and the recorded keys by holder.
Sourcepub const fn local(&self) -> &LocalMachine
pub const fn local(&self) -> &LocalMachine
The identity this machine’s links are keyed from.
Sourcepub fn rights(&self) -> &dyn LinkRights
pub fn rights(&self) -> &dyn LinkRights
This machine’s own pass answering its end of every crossing.
Sourcepub fn recorded_machine(&self, holder: &str) -> Option<MachineIdentity>
pub fn recorded_machine(&self, holder: &str) -> Option<MachineIdentity>
The machine key Lys recorded for holder, if one is recorded.
Sourcepub fn with_peer_security(
self,
peers: PeersConfig,
service_key: [u8; 32],
) -> Result<Self, &'static str>
pub fn with_peer_security( self, peers: PeersConfig, service_key: [u8; 32], ) -> Result<Self, &'static str>
Installs the service-key trust anchor and explicit device-link bounds.
§Errors
A configured allocation bound or subject prefix is invalid.
Sourcepub const fn peers(&self) -> Option<&PeersConfig>
pub const fn peers(&self) -> Option<&PeersConfig>
Configured bounds; absence preserves the original stream-only path.
Sourcepub const fn far(&self) -> Option<&Arc<FarTopology>>
pub const fn far(&self) -> Option<&Arc<FarTopology>>
The generation-bound far index shared by all views.
Sourcepub const fn service_key(&self) -> Option<&[u8; 32]>
pub const fn service_key(&self) -> Option<&[u8; 32]>
The service key fetched from the issuer API, never the pass JWKS.
Sourcepub const fn standing(&self) -> Option<&Arc<Standing>>
pub const fn standing(&self) -> Option<&Arc<Standing>>
The issuer’s existing certified-agent route supplies current standing.
Sourcepub fn with_standing(self, standing: Arc<Standing>) -> Self
pub fn with_standing(self, standing: Arc<Standing>) -> Self
Installs the issuer’s standing verifier built from this host’s pass adapter.
Sourcepub fn install_call_executor(
&self,
executor: &Arc<dyn CallExecutor>,
) -> Result<(), CallError>
pub fn install_call_executor( &self, executor: &Arc<dyn CallExecutor>, ) -> Result<(), CallError>
Installs the full far connection executor once, after its supervisor exists.
§Errors
A second executor would split the ownership of pending calls.
Sourcepub fn call_executor(&self) -> Option<Arc<dyn CallExecutor>>
pub fn call_executor(&self) -> Option<Arc<dyn CallExecutor>>
The full far admission route, when its startup hook has installed it.