Struct MeshGenesis 

pub struct MeshGenesis {
    pub mesh_name: String,
    pub created_at_ms: u64,
    pub policy: MembershipPolicy,
    /* private fields */
}

Genesis event for creating a new mesh

Contains all the cryptographic material needed to bootstrap a mesh. The creator should securely store this for recovery purposes.

Fields

mesh_name: String

Human-readable mesh name

created_at_ms: u64

Timestamp of creation (milliseconds since Unix epoch)

policy: MembershipPolicy

Membership policy for this mesh

Implementations

impl MeshGenesis

pub fn create( mesh_name: &str, creator: &DeviceIdentity, policy: MembershipPolicy, ) -> Self

Create a new mesh as the founding controller

Arguments

• mesh_name - Human-readable name for the mesh
• creator - Device identity of the mesh creator
• policy - Membership policy for the mesh

Returns

A new MeshGenesis with cryptographically secure seed

pub fn with_seed( mesh_name: &str, seed: [u8; 32], creator: &DeviceIdentity, policy: MembershipPolicy, ) -> Self

Create genesis with a specific seed (for testing or deterministic creation)

Safety

Only use with cryptographically random seeds in production.

pub fn mesh_id(&self) -> String

Derive the mesh_id from name and seed

The mesh_id is 8 hex characters derived from BLAKE3 keyed hash. Format: uppercase hex, e.g., “A1B2C3D4”

pub fn encryption_secret(&self) -> [u8; 32]

Derive the mesh-wide encryption secret

Uses BLAKE3 key derivation with a specific context.

pub fn beacon_key_base(&self) -> [u8; 32]

Derive the base key for encrypted beacons

Beacon keys are rotated, but this is the base from which they’re derived.

pub fn mesh_seed(&self) -> &[u8; 32]

Get the mesh seed for secure storage

Security: This is the root secret. Protect it carefully.

pub fn creator(&self) -> &DeviceIdentity

Get the creator’s identity

pub fn creator_public_key(&self) -> [u8; 32]

Get the creator’s public key

pub fn is_creator(&self, identity: &DeviceIdentity) -> bool

Check if a given identity is the mesh creator

pub fn encode(&self) -> Vec<u8>

Encode genesis data for persistence

Format:

• mesh_name length (2 bytes, LE)
• mesh_name (variable)
• mesh_seed (32 bytes)
• creator public key (32 bytes)
• creator private key (32 bytes) - SENSITIVE!
• created_at_ms (8 bytes, LE)
• policy (1 byte)

Total: 107 + mesh_name.len() bytes

pub fn decode(data: &[u8]) -> Option<Self>

Decode genesis data from bytes

Returns None if data is invalid or too short.

Trait Implementations

impl Clone for MeshGenesis

fn clone(&self) -> MeshGenesis

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MeshGenesis

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

Formats the value using the given formatter.