Struct holochain::prelude::prelude::dependencies::holochain_integrity_types::prelude::PreflightRequest
pub struct PreflightRequest {
pub app_entry_hash: HoloHash<Entry>,
pub signing_agents: Vec<(HoloHash<Agent>, Vec<Role, Global>), Global>,
pub optional_signing_agents: Vec<(HoloHash<Agent>, Vec<Role, Global>), Global>,
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, Global>), Global>
The agents that are participating in this countersignature session.
optional_signing_agents: Vec<(HoloHash<Agent>, Vec<Role, Global>), Global>
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§
§impl PreflightRequest
impl PreflightRequest
pub fn try_new(
app_entry_hash: HoloHash<Entry>,
signing_agents: Vec<(HoloHash<Agent>, Vec<Role, Global>), Global>,
optional_signing_agents: Vec<(HoloHash<Agent>, Vec<Role, Global>), Global>,
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, Global>), Global>,
optional_signing_agents: Vec<(HoloHash<Agent>, Vec<Role, Global>), Global>,
minimum_optional_signing_agents: u8,
enzymatic: bool,
session_times: CounterSigningSessionTimes,
action_base: ActionBase,
preflight_bytes: PreflightBytes
) -> Result<PreflightRequest, CounterSigningError>
Fallible constructor.
pub fn check_integrity(&self) -> Result<(), CounterSigningError>
pub fn check_integrity(&self) -> Result<(), CounterSigningError>
Combined integrity checks.
pub fn check_agents_dupes(&self) -> Result<(), CounterSigningError>
pub fn check_agents_dupes(&self) -> Result<(), CounterSigningError>
Verify there are no duplicate agents to sign.
pub 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.
pub fn check_agents_optional(&self) -> Result<(), CounterSigningError>
pub fn check_agents_optional(&self) -> Result<(), CounterSigningError>
Verify the optional signing agents.
pub fn check_agents(&self) -> Result<(), CounterSigningError>
pub fn check_agents(&self) -> Result<(), CounterSigningError>
Verify the preflight request agents.
pub fn check_enzyme(&self) -> Result<(), CounterSigningError>
pub fn check_enzyme(&self) -> Result<(), CounterSigningError>
Verify everything about the enzyme.
Trait Implementations§
§impl<'arbitrary> Arbitrary<'arbitrary> for PreflightRequest
impl<'arbitrary> Arbitrary<'arbitrary> for PreflightRequest
§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 more§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 more§impl Clone for PreflightRequest
impl Clone for PreflightRequest
§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 more§impl Debug for PreflightRequest
impl Debug for PreflightRequest
§impl<'de> Deserialize<'de> for PreflightRequest
impl<'de> Deserialize<'de> for PreflightRequest
§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>,
§impl PartialEq<PreflightRequest> for PreflightRequest
impl PartialEq<PreflightRequest> for PreflightRequest
§fn eq(&self, other: &PreflightRequest) -> bool
fn eq(&self, other: &PreflightRequest) -> bool
self
and other
values to be equal, and is used
by ==
.§impl Serialize for PreflightRequest
impl Serialize for PreflightRequest
§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 StructuralEq 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§
§impl<T> Any for Twhere
T: Any + ?Sized,
impl<T> Any for Twhere
T: Any + ?Sized,
§fn type_id_compat(&self) -> TypeId
fn type_id_compat(&self) -> TypeId
§impl<T> ArchivePointee for T
impl<T> ArchivePointee for T
§type ArchivedMetadata = ()
type ArchivedMetadata = ()
§fn pointer_metadata(
_: &<T as ArchivePointee>::ArchivedMetadata
) -> <T as Pointee>::Metadata
fn pointer_metadata(
_: &<T as ArchivePointee>::ArchivedMetadata
) -> <T as Pointee>::Metadata
§impl<F, W, T, D> Deserialize<With<T, W>, D> for Fwhere
W: DeserializeWith<F, T, D>,
D: Fallible + ?Sized,
F: ?Sized,
impl<F, W, T, D> Deserialize<With<T, W>, D> for Fwhere
W: DeserializeWith<F, T, D>,
D: Fallible + ?Sized,
F: ?Sized,
§fn deserialize(
&self,
deserializer: &mut D
) -> Result<With<T, W>, <D as Fallible>::Error>
fn deserialize(
&self,
deserializer: &mut D
) -> Result<With<T, W>, <D as Fallible>::Error>
source§impl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.§impl<T> FutureExt for T
impl<T> FutureExt for T
§fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ
fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ
§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> ⓘ
§impl<T> Pointable for T
impl<T> Pointable for T
§impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
§fn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
self
from the equivalent element of its
superset. Read more§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).§fn to_subset_unchecked(&self) -> SS
fn to_subset_unchecked(&self) -> SS
self.to_subset
but without any property checks. Always succeeds.§fn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
self
to the equivalent element of its superset.