Struct BlockAccessIndex 

#[repr(transparent)]
pub struct BlockAccessIndex(pub u64);

Block access index within a block.

A block’s indices are laid out as:

• 0 — pre-execution (system contract calls, block-level setup, …)
• 1..=tx_len — transaction execution (transaction index i maps to index i + 1)
• tx_len + 1 — post-execution (block rewards, withdrawals, …)

Stored as a u64 internally, but wrapped as a newtype so it cannot be accidentally confused with other u64 indices (for example, an account_id passed alongside it).

RLP, borsh, and arbitrary representations are identical to the wrapped u64. Serde serializes as a hex "quantity" string (e.g. "0x1a"), matching the previous BlockAccessIndex = u64 alias behavior when paired with the crate::quantity module.

Tuple Fields

0: u64

Implementations

impl BlockAccessIndex

pub const PRE_EXECUTION: BlockAccessIndex

Pre-execution slot (index 0).

pub const fn new(value: u64) -> BlockAccessIndex

Constructs a new BlockAccessIndex from a raw u64.

pub const fn from_tx_index(tx_index: u64) -> BlockAccessIndex

Constructs a new BlockAccessIndex from a 0-based transaction index.

Transaction changes start at index 1 in a block access list, so transaction index 0 maps to block access index 1.

pub const fn get(self) -> u64

Returns the raw u64 value.

pub const fn increment(&mut self)

Bumps the index by 1.

pub const fn phase(self, tx_len: usize) -> Option<BlockAccessPhase>

Classifies this index into a BlockAccessPhase, given the number of transactions in the block.

Returns:

• Some(BlockAccessPhase::PreExecution) when the index is 0.
• Some(BlockAccessPhase::Transaction(i)) when the index is in 1..=tx_len, with i = index - 1 as a 0-based transaction index.
• Some(BlockAccessPhase::PostExecution) when the index is exactly tx_len + 1.
• None when the index is strictly greater than tx_len + 1 (out of range for a block with tx_len transactions).

Trait Implementations

impl<'arbitrary> Arbitrary<'arbitrary> for BlockAccessIndex

fn arbitrary( u: &mut Unstructured<'arbitrary>, ) -> Result<BlockAccessIndex, Error>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest( u: Unstructured<'arbitrary>, ) -> Result<BlockAccessIndex, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl Clone for BlockAccessIndex

fn clone(&self) -> BlockAccessIndex

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BlockAccessIndex

impl Debug for BlockAccessIndex

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

Formats the value using the given formatter.

impl Decodable for BlockAccessIndex

fn decode(buf: &mut &[u8]) -> Result<BlockAccessIndex, Error>

Decodes the blob into the appropriate type. buf must be advanced past the decoded object.

impl Default for BlockAccessIndex

fn default() -> BlockAccessIndex

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BlockAccessIndex

Available on crate feature serde only.

fn deserialize<D>( deserializer: D, ) -> Result<BlockAccessIndex, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for BlockAccessIndex

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

Formats the value using the given formatter.

impl Encodable for BlockAccessIndex

fn length(&self) -> usize

Returns the length of the encoding of this type in bytes.

fn encode(&self, out: &mut dyn BufMut)

Encodes the type into the out buffer.

impl Eq for BlockAccessIndex

impl Hash for BlockAccessIndex

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

where __H: Hasher,

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 LowerHex for BlockAccessIndex

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

Formats the value using the given formatter.

impl Ord for BlockAccessIndex

fn cmp(&self, other: &BlockAccessIndex) -> 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.

impl PartialEq for BlockAccessIndex

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for BlockAccessIndex

fn partial_cmp(&self, other: &BlockAccessIndex) -> 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 Serialize for BlockAccessIndex

Available on crate feature serde only.

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.

impl StructuralPartialEq for BlockAccessIndex

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 8 bytes