Skip to main content

SessionState

Struct SessionState 

Source
pub struct SessionState {
    pub sid: SessionId,
    pub roles: Vec<String>,
    pub local_types: BTreeMap<Endpoint, TypeEntry>,
    pub buffers: BTreeMap<Edge, SignedBuffer<Signature>>,
    pub auth_leaves: BTreeMap<Edge, Vec<Hash>>,
    pub auth_trees: BTreeMap<Edge, AuthTree>,
    pub auth_roots: BTreeMap<Edge, Hash>,
    pub edge_handlers: BTreeMap<Edge, HandlerId>,
    pub default_handler: HandlerId,
    pub edge_traces: BTreeMap<Edge, Vec<ValType>>,
    pub status: SessionStatus,
    pub epoch: usize,
    /* private fields */
}
Expand description

State of a single session.

Stores per-endpoint local types (the type truth), message buffers, and lifecycle status. Matches Lean SessionState.

Fields§

§sid: SessionId

Session identifier.

§roles: Vec<String>

Role names in this session.

§local_types: BTreeMap<Endpoint, TypeEntry>

Per-endpoint local type state. This IS the type truth.

Matches Lean localTypes : List (Endpoint × LocalType).

§buffers: BTreeMap<Edge, SignedBuffer<Signature>>

Message buffers keyed by directed edge.

§auth_leaves: BTreeMap<Edge, Vec<Hash>>

Per-edge authenticated leaves for Merkle-auth tracking.

§auth_trees: BTreeMap<Edge, AuthTree>

Per-edge Merkle trees for incremental authenticated updates.

§auth_roots: BTreeMap<Edge, Hash>

Per-edge Merkle roots for signed-buffer history.

§edge_handlers: BTreeMap<Edge, HandlerId>

Optional handler binding per edge.

§default_handler: HandlerId

Session-wide fallback handler id.

§edge_traces: BTreeMap<Edge, Vec<ValType>>

Coherence trace by edge.

§status: SessionStatus

Current status.

§epoch: usize

Epoch counter for draining.

Implementations§

Source§

impl SessionState

Source

pub fn send_signed( &mut self, from: &str, to: &str, signed: &SignedValue<Signature>, ) -> Result<EnqueueResult, String>

Send a signed value from one role to another.

§Errors

Returns an error if no buffer exists for the given edge.

Source

pub fn send( &mut self, from: &str, to: &str, val: Value, ) -> Result<EnqueueResult, String>

Send a value from one role to another.

Returns the enqueue result from the buffer.

§Errors

Returns an error if no buffer exists for the given edge.

Source

pub fn send_with_sequence( &mut self, from: &str, to: &str, val: Value, sequence_no: u64, ) -> Result<EnqueueResult, String>

Send a value from one role to another with explicit sequence number.

§Errors

Returns an error if no buffer exists for the given edge.

Source

pub fn recv_signed( &mut self, from: &str, to: &str, ) -> Option<SignedValue<Signature>>

Receive a signed value destined for a role from a specific sender.

Source

pub fn recv_verified_signed( &mut self, from: &str, to: &str, ) -> Result<Option<SignedValue<Signature>>, String>

Receive and verify a value destined for a role from a specific sender.

§Errors

Returns an error if signature verification fails.

Source

pub fn recv_verified( &mut self, from: &str, to: &str, ) -> Result<Option<Value>, String>

Receive and verify a value destined for a role from a specific sender.

§Errors

Returns an error if signature verification fails.

Source

pub fn recv(&mut self, from: &str, to: &str) -> Option<Value>

Receive a value destined for a role from a specific sender.

Source

pub fn has_message(&self, from: &str, to: &str) -> bool

Check if there is a message available on an edge.

Source

pub fn lookup_handler_for_roles( &self, from: &str, to: &str, ) -> Option<&HandlerId>

Lookup an edge-bound handler by role pair using the internal numeric path.

Source

pub fn default_handler_binding(&self) -> Option<&HandlerId>

Lookup the session-wide fallback handler using the internal numeric path.

Source

pub fn has_bound_handler(&self) -> bool

Whether the session currently has any handler binding configured.

Trait Implementations§

Source§

impl Clone for SessionState

Source§

fn clone(&self) -> SessionState

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for SessionState

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for SessionState

Source§

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Serialize for SessionState

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Az for T

Source§

fn az<Dst>(self) -> Dst
where T: Cast<Dst>,

Casts the value.
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<Src, Dst> CastFrom<Src> for Dst
where Src: Cast<Dst>,

Source§

fn cast_from(src: Src) -> Dst

Casts the value.
Source§

impl<T> CheckedAs for T

Source§

fn checked_as<Dst>(self) -> Option<Dst>
where T: CheckedCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> CheckedCastFrom<Src> for Dst
where Src: CheckedCast<Dst>,

Source§

fn checked_cast_from(src: Src) -> Option<Dst>

Casts the value.
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<Src, Dst> LosslessTryInto<Dst> for Src
where Dst: LosslessTryFrom<Src>,

Source§

fn lossless_try_into(self) -> Option<Dst>

Performs the conversion.
Source§

impl<Src, Dst> LossyInto<Dst> for Src
where Dst: LossyFrom<Src>,

Source§

fn lossy_into(self) -> Dst

Performs the conversion.
Source§

impl<T> OverflowingAs for T

Source§

fn overflowing_as<Dst>(self) -> (Dst, bool)
where T: OverflowingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> OverflowingCastFrom<Src> for Dst
where Src: OverflowingCast<Dst>,

Source§

fn overflowing_cast_from(src: Src) -> (Dst, bool)

Casts the value.
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> SaturatingAs for T

Source§

fn saturating_as<Dst>(self) -> Dst
where T: SaturatingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> SaturatingCastFrom<Src> for Dst
where Src: SaturatingCast<Dst>,

Source§

fn saturating_cast_from(src: Src) -> Dst

Casts the value.
Source§

impl<T> StrictAs for T

Source§

fn strict_as<Dst>(self) -> Dst
where T: StrictCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> StrictCastFrom<Src> for Dst
where Src: StrictCast<Dst>,

Source§

fn strict_cast_from(src: Src) -> Dst

Casts the value.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> UnwrappedAs for T

Source§

fn unwrapped_as<Dst>(self) -> Dst
where T: UnwrappedCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> UnwrappedCastFrom<Src> for Dst
where Src: UnwrappedCast<Dst>,

Source§

fn unwrapped_cast_from(src: Src) -> Dst

Casts the value.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WrappingAs for T

Source§

fn wrapping_as<Dst>(self) -> Dst
where T: WrappingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> WrappingCastFrom<Src> for Dst
where Src: WrappingCast<Dst>,

Source§

fn wrapping_cast_from(src: Src) -> Dst

Casts the value.
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,