Struct hdk::prelude::countersigning::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 Clone for PreflightRequest
impl Clone for PreflightRequest
fn clone(&self) -> PreflightRequest
fn clone(&self) -> PreflightRequest
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from 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>,
Deserialize this value from the given Serde deserializer. Read more
impl PartialEq<PreflightRequest> for PreflightRequest
impl PartialEq<PreflightRequest> for PreflightRequest
fn eq(&self, other: &PreflightRequest) -> bool
fn eq(&self, other: &PreflightRequest) -> bool
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
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,
Serialize this value into the given Serde serializer. Read more
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> ArchivePointee for T
impl<T> ArchivePointee for T
type ArchivedMetadata = ()
type ArchivedMetadata = ()
The archived version of the pointer metadata for this type.
fn pointer_metadata(
&<T as ArchivePointee>::ArchivedMetadata
) -> <T as Pointee>::Metadata
fn pointer_metadata(
&<T as ArchivePointee>::ArchivedMetadata
) -> <T as Pointee>::Metadata
Converts some archived metadata to the pointer metadata for itself.
sourceimpl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
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>
Deserializes using the given deserializer
sourceimpl<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,
sourcefn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
Compare self to key
and return true
if they are equal.
sourceimpl<T> Instrument for T
impl<T> Instrument for T
sourcefn instrument(self, span: Span) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>impl<T> Future for Instrumented<T>where
T: Future, type Output = <T as Future>::Output;
fn instrument(self, span: Span) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>impl<T> Future for Instrumented<T>where
T: Future, type Output = <T as Future>::Output;
T: Future, type Output = <T as Future>::Output;
sourcefn in_current_span(self) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>impl<T> Future for Instrumented<T>where
T: Future, type Output = <T as Future>::Output;
fn in_current_span(self) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>impl<T> Future for Instrumented<T>where
T: Future, type Output = <T as Future>::Output;
T: Future, type Output = <T as Future>::Output;
sourceimpl<T> WithSubscriber for T
impl<T> WithSubscriber for T
sourcefn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>ⓘNotable traits for WithDispatch<T>impl<T> Future for WithDispatch<T>where
T: Future, type Output = <T as Future>::Output;
where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>ⓘNotable traits for WithDispatch<T>impl<T> Future for WithDispatch<T>where
T: Future, type Output = <T as Future>::Output;
where
S: Into<Dispatch>,
T: Future, type Output = <T as Future>::Output;
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
sourcefn with_current_subscriber(self) -> WithDispatch<Self>ⓘNotable traits for WithDispatch<T>impl<T> Future for WithDispatch<T>where
T: Future, type Output = <T as Future>::Output;
fn with_current_subscriber(self) -> WithDispatch<Self>ⓘNotable traits for WithDispatch<T>impl<T> Future for WithDispatch<T>where
T: Future, type Output = <T as Future>::Output;
T: Future, type Output = <T as Future>::Output;
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more