Enum LifecycleEvent 

#[non_exhaustive]
pub enum LifecycleEvent {
    Installed,
    NodeStarted {
        down_since_ms: Option<u64>,
    },
}

A lifecycle event, delivered as InboundDelegateMsg::Lifecycle.

Only sent to a delegate whose manifest lists the matching LifecycleKind. A node that implements delivery also requires the user’s Capability::Background grant for the delegate’s app. The run gets the delegate’s registered parameters and no origin.

Wire format

bincode, nested inside InboundDelegateMsg. Variants are appended, never inserted or reordered (pinned by lifecycle_event_tags_are_pinned). A variant’s fields are frozen once released: WIRE-FORMAT.md rule 1 forbids appending a field to a struct already on the wire, so new information arrives as a new variant.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Installed

This delegate was installed on this node: its first registration here, or the first time its app was granted Capability::Background after that. Delivered at most once per delegate key per node.

A delegate typically uses it to subscribe to the contracts it watches and to do any one-time setup.

NodeStarted

The node started. Delivered once per node start, after the node has finished whatever restore work it does at start-up.

Contract notifications that arrived while the node was down were not delivered and are never replayed, so a delegate should re-read any contract it depends on rather than assume it saw every change.

Fields

down_since_ms: Option<u64>

When the node was last known to be running (milliseconds since the Unix epoch), if it knows. Everything between this and now was missed. None means the node does not know, not that nothing was missed.

Implementations

impl LifecycleEvent

pub fn kind(&self) -> LifecycleKind

The manifest kind that must be listed for this event to be delivered.

Trait Implementations

impl Clone for LifecycleEvent

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 LifecycleEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LifecycleEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for LifecycleEvent

impl PartialEq for LifecycleEvent

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for LifecycleEvent

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 LifecycleEvent