Struct BlockExecutionContext 

#[repr(C)]
pub struct BlockExecutionContext {
    pub block_height: BlockHeight,
    pub block_timepoint: TimePoint,
}

The contract-visible facts about the block an executor is running.

Passed to both executor open-block calls so that a block looks identical to the executor whether it is being proposed or validated, and so that everything a contract can observe about “the current block” comes from one place rather than being inferred from the parent tip.

This is deliberately not ProposalContext (its protocol and proposer are scheduler concerns, and protocol is not recoverable from a ProposalHeader when validating) and not ProposalHeader (whose txs, storage, events and config hashes are outputs of executing the block, so they do not exist when it is opened).

Does not travel on network: the scheduler builds it per block, from the coordinator’s ProposalContext when proposing and from the proposal’s ProposalHeader when validating. A validator must take these values from the proposal it is validating rather than regenerating them, or its execution diverges from the proposer’s and consensus splits.

Fields

block_height: BlockHeight

Height of the block being executed – the parent tip’s height plus one. Supplied rather than derived so that height and timepoint have a single source; the executor is expected to check it against the tip it reads.

block_timepoint: TimePoint

The block’s timepoint, fixed before execution begins. Unlike the height there is no way to recover this from the parent tip: the parent’s timepoint is the previous block’s.

Trait Implementations

impl Clone for BlockExecutionContext

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ConstMaxSize for BlockExecutionContext

const MAX_SIZE: Option<usize>

Worst-case CXS encoded size in bytes, or None if unbounded.

impl ConstMaxSize for BlockExecutionContext

const MAX_SIZE: Option<usize>

Worst-case TXS encoded size in bytes, or None if unbounded.

impl Debug for BlockExecutionContext

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BlockExecutionContext

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl EncodesAs<BlockExecutionContext> for BlockExecutionContext

impl Eq for BlockExecutionContext

impl Hash for BlockExecutionContext

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl JsonSchema for BlockExecutionContext

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Ord for BlockExecutionContext

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for BlockExecutionContext

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for BlockExecutionContext

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'_r> ReadXDR<'_r> for BlockExecutionContext

fn read_xdr<R: Reader<'_r>>(r: &mut R) -> ReadResult<Self>

Reads an XDR value from the reader.

fn read_xdr_in_place<'__xdrs_s, R: Reader<'_r>>( r: &mut R, __xdrs_slot: Slot<'__xdrs_s, Self>, ) -> ReadResult<Init<'__xdrs_s, Self>>

Reads an XDR value directly into slot, without first building it on the stack.

impl Serialize for BlockExecutionContext

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for BlockExecutionContext

impl WriteXDR for BlockExecutionContext

fn write_xdr<F, W: Writer<F>>(&self, w: &mut W) -> WriteResult<()>

Writes this value as XDR data to the writer.

unsafe fn write_xdr_unchecked<F, W: WriterUnchecked<F>>(&self, w: &mut W)

Writes this value as XDR data to the writer, without runtime checks.