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

impl Eq for BlockAccessIndex

impl StructuralPartialEq for BlockAccessIndex