Skip to main content

ThresholdGroup

saorsa_core::threshold

Struct ThresholdGroup

pub struct ThresholdGroup {
    pub group_id: GroupId,
    pub threshold: u16,
    pub participants: u16,
    pub frost_group_key: FrostGroupPublicKey,
    pub active_participants: Vec<ParticipantInfo>,
    pub pending_participants: Vec<ParticipantInfo>,
    pub version: u64,
    pub metadata: GroupMetadata,
    pub audit_log: Vec<GroupAuditEntry>,
    pub created_at: SystemTime,
    pub last_updated: SystemTime,
}

Expand description

Threshold group with dynamic membership

Fields§

§group_id: GroupId

Unique group identifier

§threshold: u16

Current threshold (t in t-of-n)

§participants: u16

Total participants (n in t-of-n)

§frost_group_key: FrostGroupPublicKey

FROST group public key

§active_participants: Vec<ParticipantInfo>

Active participants with their shares

§pending_participants: Vec<ParticipantInfo>

Participants being added

§version: u64

Group version (incremented on changes)

§metadata: GroupMetadata

Group metadata

§audit_log: Vec<GroupAuditEntry>

Audit log of group operations

§created_at: SystemTime

Creation timestamp

§last_updated: SystemTime

Last update timestamp

Implementations§

impl ThresholdGroup

pub fn check_permission( &self, participant_id: &ParticipantId, permission: Permission, ) -> Result<()>

Check if a participant has a specific permission

pub fn get_active_participants(&self) -> Vec<&ParticipantInfo>

Get active participants (not suspended or pending removal)

pub fn active_participant_count(&self) -> u16

Get number of active participants

pub fn has_threshold_participants(&self) -> bool

Check if we have enough participants for threshold operations

pub fn add_pending_participant( &mut self, participant: ParticipantInfo, ) -> Result<()>

Add a new participant (pending until key ceremony)

pub fn mark_for_removal(&mut self, participant_id: &ParticipantId) -> Result<()>

Mark participant for removal

pub fn update_participant_role( &mut self, participant_id: &ParticipantId, new_role: ParticipantRole, ) -> Result<()>

Update participant role

pub fn suspend_participant( &mut self, participant_id: &ParticipantId, reason: String, duration: Duration, ) -> Result<()>

Suspend a participant

pub fn update_threshold(&mut self, new_threshold: u16) -> Result<()>

Update threshold value

pub fn get_participants_by_role( &self, role_filter: RoleFilter, ) -> Vec<&ParticipantInfo>

Get participants by role

pub fn get_hierarchy(&self) -> GroupHierarchy

Get group hierarchy (if part of a larger structure)

pub fn validate(&self) -> Result<()>

Validate group state

pub fn add_audit_entry(&mut self, entry: GroupAuditEntry)

Add audit entry

impl ThresholdGroup

pub fn get_stats(&self) -> GroupStats

Get group statistics

Trait Implementations§

impl Clone for ThresholdGroup

fn clone(&self) -> ThresholdGroup

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

impl Debug for ThresholdGroup

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

Formats the value using the given formatter. Read more

impl<'de> Deserialize<'de> for ThresholdGroup

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

Deserialize this value from the given Serde deserializer. Read more

impl Serialize for ThresholdGroup

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§

impl Freeze for ThresholdGroup

impl RefUnwindSafe for ThresholdGroup

impl Send for ThresholdGroup

impl Sync for ThresholdGroup

impl Unpin for ThresholdGroup

impl UnsafeUnpin for ThresholdGroup

impl UnwindSafe for ThresholdGroup

Blanket Implementations§

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

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

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

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

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

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

Mutably borrows from an owned value. Read more

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

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

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

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

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

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

fn into(self) -> U

Calls U::from(self).

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

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

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more

impl<T> Same for T

type Output = T

Should always be Self

impl<SS, SP> SupersetOf<SS> for SP
where SS: SubsetOf<SP>,

fn to_subset(&self) -> Option<SS>

The inverse inclusion map: attempts to construct self from the equivalent element of its superset. Read more

fn is_in_subset(&self) -> bool

Checks if self is actually part of its subset T (and can be converted to it).

fn to_subset_unchecked(&self) -> SS

Use with care! Same as self.to_subset but without any property checks. Always succeeds.

fn from_subset(element: &SS) -> SP

The inclusion map: converts self to the equivalent element of its superset.

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

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

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

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

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

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

type Error = Infallible

The type returned in the event of a conversion error.

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

Performs the conversion.

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

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

The type returned in the event of a conversion error.

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

Performs the conversion.

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

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more

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

impl<A, B, T> HttpServerConnExec<A, B> for T
where B: Body,