Struct Genesis 

pub struct Genesis {
    pub program: String,
    pub requested_address: Address,
    pub args: Vec<String>,
    pub cwd: String,
    pub parent: Option<Guid>,
}

Everything a session is committed to at birth.

Three groups, one per Merkle leaf:

leaf	fields	what it pins
0	program	the image that runs
1	requested_address, args	what the spawn asked for
2	cwd, parent	where, and under whom

There is no field for the session’s current address — see the module docs.

Like Guid and crate::Shutai, Genesis is Serialize but not Deserialize: it is minted from a spawn the daemon is performing, never parsed from a payload a peer sent.

Fields

program: String

The shell or program image that runs the session — the resolved path where one is known (/run/current-system/sw/bin/zsh), the bare name otherwise.

requested_address: Address

The address the spawn asked for. A historical fact about the birth, not the session’s live alias; the live alias is not an input to the hash at all.

args: Vec<String>

Arguments the spawn requested, in order, excluding argv[0].

cwd: String

The working directory the session was born in.

parent: Option<Guid>

The spawning session, when there was one. None is a top-level spawn. Because a Guid can only come from a Genesis, a parent link is unforgeable by construction: you cannot claim a parent you never derived.

Implementations

impl Genesis

pub fn new( program: impl Into<String>, requested_address: Address, cwd: impl Into<String>, ) -> Self

A top-level genesis: program, requested address, cwd. Add args with Genesis::with_args and a parent with Genesis::with_parent.

pub fn with_args<I, S>(self, args: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Set the spawn arguments.

pub fn with_parent(self, parent: Guid) -> Self

Record the spawning session.

pub fn guid(&self) -> Guid

Derive this genesis’s Guid — the only way a Guid comes into existence.

Pure and total: the same Genesis always yields the same Guid, on any host, in any process, forever.

Trait Implementations

impl Clone for Genesis

fn clone(&self) -> Genesis

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Genesis

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

Formats the value using the given formatter.

impl Eq for Genesis

impl PartialEq for Genesis

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Genesis

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 Genesis