Struct diem_sdk::types::contract_event::EventByVersionWithProof [−][src]
pub struct EventByVersionWithProof<T> {
pub lower_bound_incl: Option<EventWithProof<T>>,
pub upper_bound_excl: Option<EventWithProof<T>>,
}
Expand description
The response type for get_event_by_version_with_proof
, which contains lower
and upper bound events surrounding the requested version along with proofs
for each event.
Why do we need two events?
If we could always get the event count at the requested event_version, we
could return only the lower bound event. With the event count we could verify
that the returned event is actually the latest event at the historical ledger
view just by checking that event.sequence_number == event_count
.
Unfortunately, the event count is only (verifiably) accessible via the on-chain state. While we can easily acquire the event count near the chain HEAD, historical event counts (at versions below HEAD for more than the prune window) may be inaccessible after most non-archival fullnodes have pruned past that version.
Including the Upper Bound Event
In contrast, if we also return the upper bound event, then we can always verify the request even if the version is past the prune window and we don’t know the event_count (at event_version). The upper bound event lets us prove that there is no untransmitted event that is actually closer to the requested event_version than the lower bound.
For example, consider the case where there are three events at versions 10, 20, and 30. A client asks for the latest event at or below version 25. If we just returned the lower bound event, then a malicious server could return the event at version 10; the client would not be able to distinguish this response from the correct response without the event count (2) at version 25.
If we also return the upper bound event (the event at version 30), the client can verify that the upper bound is the next event after the lower bound and that the upper bound comes after their requested version. This proves that the lower bound is actually the latest event at or below their requested version.
Fields
lower_bound_incl: Option<EventWithProof<T>>
upper_bound_excl: Option<EventWithProof<T>>
Implementations
pub fn new(
lower_bound_incl: Option<EventWithProof<T>>,
upper_bound_excl: Option<EventWithProof<T>>
) -> EventByVersionWithProof<T>
Verify that the lower_bound_incl
EventWithProof
is the latest event
at or below the requested event_version
.
The ledger_info
is the client’s latest know ledger info (will be near
chain HEAD if the client is synced).
The latest_event_count
is the event count at the ledger_info
version
(not the event_version
) and is needed to verify the empty event stream
and version after last event cases. In some select instances
(e.g. NewBlockEvent
s) we can determine these cases more efficiently
and so this parameter is left optional.
Trait Implementations
pub fn deserialize<__D>(
__deserializer: __D
) -> Result<EventByVersionWithProof<T>, <__D as Deserializer<'de>>::Error> where
__D: Deserializer<'de>,
pub fn deserialize<__D>(
__deserializer: __D
) -> Result<EventByVersionWithProof<T>, <__D as Deserializer<'de>>::Error> where
__D: Deserializer<'de>,
Deserialize this value from the given Serde deserializer. Read more
impl<T> PartialEq<EventByVersionWithProof<T>> for EventByVersionWithProof<T> where
T: PartialEq<T>,
impl<T> PartialEq<EventByVersionWithProof<T>> for EventByVersionWithProof<T> where
T: PartialEq<T>,
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
This method tests for !=
.
pub fn serialize<__S>(
&self,
__serializer: __S
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error> where
__S: Serializer,
pub 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<'_> TryFrom<&'_ EventByVersionWithProof<TransactionInfo>> for EventByVersionWithProofView
impl<'_> TryFrom<&'_ EventByVersionWithProof<TransactionInfo>> for EventByVersionWithProofView
pub fn try_from(
proof: &EventByVersionWithProof<TransactionInfo>
) -> Result<EventByVersionWithProofView, <EventByVersionWithProofView as TryFrom<&'_ EventByVersionWithProof<TransactionInfo>>>::Error>
pub fn try_from(
proof: &EventByVersionWithProof<TransactionInfo>
) -> Result<EventByVersionWithProofView, <EventByVersionWithProofView as TryFrom<&'_ EventByVersionWithProof<TransactionInfo>>>::Error>
Performs the conversion.
impl<'_> TryFrom<&'_ EventByVersionWithProofView> for EventByVersionWithProof<TransactionInfo>
impl<'_> TryFrom<&'_ EventByVersionWithProofView> for EventByVersionWithProof<TransactionInfo>
pub fn try_from(
view: &EventByVersionWithProofView
) -> Result<EventByVersionWithProof<TransactionInfo>, <EventByVersionWithProof<TransactionInfo> as TryFrom<&'_ EventByVersionWithProofView>>::Error>
pub fn try_from(
view: &EventByVersionWithProofView
) -> Result<EventByVersionWithProof<TransactionInfo>, <EventByVersionWithProof<TransactionInfo> as TryFrom<&'_ EventByVersionWithProofView>>::Error>
Performs the conversion.
Auto Trait Implementations
impl<T> RefUnwindSafe for EventByVersionWithProof<T> where
T: RefUnwindSafe,
impl<T> Send for EventByVersionWithProof<T> where
T: Send,
impl<T> Sync for EventByVersionWithProof<T> where
T: Sync,
impl<T> Unpin for EventByVersionWithProof<T> where
T: Unpin,
impl<T> UnwindSafe for EventByVersionWithProof<T> where
T: UnwindSafe,
Blanket Implementations
Mutably borrows from an owned value. Read more
Compare self to key
and return true
if they are equal.
Instruments this type with the provided Span
, returning an
Instrumented
wrapper. Read more
Generates a hash used only for tests.
pub fn vzip(self) -> V
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more