Struct holochain::prelude::PreflightRequest
source · pub struct PreflightRequest {
pub app_entry_hash: HoloHash<Entry>,
pub signing_agents: Vec<(HoloHash<Agent>, Vec<Role>)>,
pub optional_signing_agents: Vec<(HoloHash<Agent>, Vec<Role>)>,
pub minimum_optional_signing_agents: u8,
pub enzymatic: bool,
pub session_times: CounterSigningSessionTimes,
pub action_base: ActionBase,
pub preflight_bytes: PreflightBytes,
}
Expand description
The same PreflightRequest is sent to every agent. Each agent signs this data as part of their PreflightResponse. Every preflight must be identical and signed by every agent for a session to be valid.
Fields§
§app_entry_hash: HoloHash<Entry>
The hash of the app entry, as if it were not countersigned. The final entry hash will include the countersigning session.
signing_agents: Vec<(HoloHash<Agent>, Vec<Role>)>
The agents that are participating in this countersignature session.
optional_signing_agents: Vec<(HoloHash<Agent>, Vec<Role>)>
The optional additional M of N signers. If there are additional signers then M MUST be the majority of N. If there are additional signers then the enzyme MUST be used and is the first signer in BOTH signing_agents and optional_signing_agents.
minimum_optional_signing_agents: u8
The M in the M of N signers. M MUST be strictly greater than than N / 2 and NOT larger than N.
enzymatic: bool
The first signing agent (index 0) is acting as an enzyme. If true AND optional_signing_agents are set then the first agent MUST be the same in both signing_agents and optional_signing_agents.
session_times: CounterSigningSessionTimes
The session times. Session actions must all have the same timestamp, which is the session offset.
action_base: ActionBase
The action information that is shared by all agents. Contents depend on the action type, create, update, etc.
preflight_bytes: PreflightBytes
The preflight bytes for session.
Implementations§
source§impl PreflightRequest
impl PreflightRequest
sourcepub fn try_new(
app_entry_hash: HoloHash<Entry>,
signing_agents: Vec<(HoloHash<Agent>, Vec<Role>)>,
optional_signing_agents: Vec<(HoloHash<Agent>, Vec<Role>)>,
minimum_optional_signing_agents: u8,
enzymatic: bool,
session_times: CounterSigningSessionTimes,
action_base: ActionBase,
preflight_bytes: PreflightBytes
) -> Result<PreflightRequest, CounterSigningError>
pub fn try_new( app_entry_hash: HoloHash<Entry>, signing_agents: Vec<(HoloHash<Agent>, Vec<Role>)>, optional_signing_agents: Vec<(HoloHash<Agent>, Vec<Role>)>, minimum_optional_signing_agents: u8, enzymatic: bool, session_times: CounterSigningSessionTimes, action_base: ActionBase, preflight_bytes: PreflightBytes ) -> Result<PreflightRequest, CounterSigningError>
Fallible constructor.
sourcepub fn check_integrity(&self) -> Result<(), CounterSigningError>
pub fn check_integrity(&self) -> Result<(), CounterSigningError>
Combined integrity checks.
sourcepub fn check_agents_dupes(&self) -> Result<(), CounterSigningError>
pub fn check_agents_dupes(&self) -> Result<(), CounterSigningError>
Verify there are no duplicate agents to sign.
sourcepub fn check_agents_len(&self) -> Result<(), CounterSigningError>
pub fn check_agents_len(&self) -> Result<(), CounterSigningError>
Verify the number of signing agents is within the correct range.
sourcepub fn check_agents_optional(&self) -> Result<(), CounterSigningError>
pub fn check_agents_optional(&self) -> Result<(), CounterSigningError>
Verify the optional signing agents.
sourcepub fn check_agents(&self) -> Result<(), CounterSigningError>
pub fn check_agents(&self) -> Result<(), CounterSigningError>
Verify the preflight request agents.
sourcepub fn check_enzyme(&self) -> Result<(), CounterSigningError>
pub fn check_enzyme(&self) -> Result<(), CounterSigningError>
Verify everything about the enzyme.
Trait Implementations§
source§impl<'arbitrary> Arbitrary<'arbitrary> for PreflightRequest
impl<'arbitrary> Arbitrary<'arbitrary> for PreflightRequest
source§fn arbitrary(
u: &mut Unstructured<'arbitrary>
) -> Result<PreflightRequest, Error>
fn arbitrary( u: &mut Unstructured<'arbitrary> ) -> Result<PreflightRequest, Error>
Self
from the given unstructured data. Read moresource§fn arbitrary_take_rest(
u: Unstructured<'arbitrary>
) -> Result<PreflightRequest, Error>
fn arbitrary_take_rest( u: Unstructured<'arbitrary> ) -> Result<PreflightRequest, Error>
Self
from the entirety of the given
unstructured data. Read moresource§impl Clone for PreflightRequest
impl Clone for PreflightRequest
source§fn clone(&self) -> PreflightRequest
fn clone(&self) -> PreflightRequest
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for PreflightRequest
impl Debug for PreflightRequest
source§impl<'de> Deserialize<'de> for PreflightRequest
impl<'de> Deserialize<'de> for PreflightRequest
source§fn deserialize<__D>(
__deserializer: __D
) -> Result<PreflightRequest, <__D as Deserializer<'de>>::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(
__deserializer: __D
) -> Result<PreflightRequest, <__D as Deserializer<'de>>::Error>where
__D: Deserializer<'de>,
source§impl Hash for PreflightRequest
impl Hash for PreflightRequest
source§impl PartialEq for PreflightRequest
impl PartialEq for PreflightRequest
source§fn eq(&self, other: &PreflightRequest) -> bool
fn eq(&self, other: &PreflightRequest) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl Serialize for PreflightRequest
impl Serialize for PreflightRequest
source§fn serialize<__S>(
&self,
__serializer: __S
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
__S: Serializer,
fn serialize<__S>(
&self,
__serializer: __S
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
__S: Serializer,
impl Eq for PreflightRequest
impl StructuralPartialEq for PreflightRequest
Auto Trait Implementations§
impl RefUnwindSafe for PreflightRequest
impl Send for PreflightRequest
impl Sync for PreflightRequest
impl Unpin for PreflightRequest
impl UnwindSafe for PreflightRequest
Blanket Implementations§
source§impl<T> ArchivePointee for T
impl<T> ArchivePointee for T
§type ArchivedMetadata = ()
type ArchivedMetadata = ()
source§fn pointer_metadata(
_: &<T as ArchivePointee>::ArchivedMetadata
) -> <T as Pointee>::Metadata
fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata ) -> <T as Pointee>::Metadata
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CallHasher for T
impl<T> CallHasher for T
source§impl<F, W, T, D> Deserialize<With<T, W>, D> for F
impl<F, W, T, D> Deserialize<With<T, W>, D> for F
source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§impl<T> FutureExt for T
impl<T> FutureExt for T
source§fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ
fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ
source§fn with_current_context(self) -> WithContext<Self> ⓘ
fn with_current_context(self) -> WithContext<Self> ⓘ
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
source§impl<T> LayoutRaw for T
impl<T> LayoutRaw for T
source§fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>
fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>
source§impl<T> Pointable for T
impl<T> Pointable for T
source§impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
source§fn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
self
from the equivalent element of its
superset. Read moresource§fn is_in_subset(&self) -> bool
fn is_in_subset(&self) -> bool
self
is actually part of its subset T
(and can be converted to it).source§fn to_subset_unchecked(&self) -> SS
fn to_subset_unchecked(&self) -> SS
self.to_subset
but without any property checks. Always succeeds.source§fn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
self
to the equivalent element of its superset.