Struct MachineRegistration 

pub struct MachineRegistration {
    pub hostkey_fingerprint: Option<String>,
    pub mesh_ipv4: Option<String>,
    pub joined_at: Option<String>,
}

[registration] — facts observed about a running box, written by the fleet rather than declared by an operator (R707-T1).

The rest of machine.toml is declaration: intent, operator-authored, reviewed and diffed like any other source. This block is the other half — what the box turned out to be once it booted and joined. Keeping the two apart is what lets the published fleet index (R707-F3) say which half it is carrying; publishing them under one schema would bake the confusion into a permanent record.

The split is a provenance boundary, not a trust or reach one:

• Declaration answers “what did we ask for” — name, region, arch, mesh_tags, [allocatable], and the declared reach in ConnectSpec.
• Registration answers “what did we observe” — the hostkey TOFU’d at attach, the mesh address headscale assigned at join.

It stays in the git-tracked TOML on purpose. Registration is not local scratch state: every consumer needs the mesh address to dial a node, so it has to travel with the declaration. (.yah/infra/state/machines/<name>.json — crate::state::MachineState — remains the gitignored sidecar for provider-side derivatives that nobody but this camp needs.)

Fields

hostkey_fingerprint: Option<String>

Yubaba’s ed25519 /identity fingerprint, TOFU-recorded by yah cloud machine attach on first contact (SHA256:…). An observed property of a running process — not the operator’s intent — which is why it moved out of the top level here.

mesh_ipv4: Option<String>

Mesh (headscale/tailnet) IPv4 assigned at join, e.g. "100.64.0.1". Bare address, not a URL: the port is declared reach and lives on ConnectSpec::yubaba_port. MachineConfig::yubaba_url composes the two. Absent until the node has joined the mesh.

joined_at: Option<String>

RFC3339 timestamp of the mesh join that produced mesh_ipv4. Free-form audit; nothing keys off it.

Implementations

impl MachineRegistration

pub fn is_empty(&self) -> bool

True when nothing has been observed yet — used to omit the whole [registration] table from a serialized machine TOML.

Trait Implementations

impl Clone for MachineRegistration

fn clone(&self) -> MachineRegistration

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MachineRegistration

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

Formats the value using the given formatter.

impl Default for MachineRegistration

fn default() -> MachineRegistration

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MachineRegistration

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for MachineRegistration

impl PartialEq for MachineRegistration

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for MachineRegistration

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 MachineRegistration