Enum StorageSlotKey 

pub enum StorageSlotKey {
    Plain(FixedBytes<32>),
    Hashed(FixedBytes<32>),
}

A storage slot key that tracks whether it holds a plain (unhashed) EVM slot or a keccak256-hashed slot.

This enum replaces the use_hashed_state: bool parameter pattern by carrying provenance with the key itself. Once tagged at a read/write boundary, downstream code can call Self::to_hashed without risk of double-hashing — hashing a StorageSlotKey::Hashed is a no-op.

The on-disk encoding is unchanged (raw 32-byte B256). The variant is set by the code that knows the context (which table, which storage mode).

Variants

Plain(FixedBytes<32>)

An unhashed EVM storage slot, as produced by REVM execution.

Hashed(FixedBytes<32>)

A keccak256-hashed storage slot, as stored in HashedStorages and in v2-mode StorageChangeSets.

Implementations

impl StorageSlotKey

pub const fn from_u256(slot: Uint<256, 4>) -> StorageSlotKey

Create a plain slot key from a REVM U256 storage index.

pub const fn plain(key: FixedBytes<32>) -> StorageSlotKey

Create a plain slot key from a raw B256.

pub const fn hashed(key: FixedBytes<32>) -> StorageSlotKey

Create a hashed slot key from a raw B256.

pub const fn from_raw( key: FixedBytes<32>, use_hashed_state: bool, ) -> StorageSlotKey

Tag a raw B256 based on the storage mode.

When use_hashed_state is true the key is assumed already hashed. When false it is assumed to be a plain slot.

pub const fn as_b256(&self) -> FixedBytes<32>

Returns the raw B256 regardless of variant.

pub const fn is_hashed(&self) -> bool

Returns true if this key is already hashed.

pub const fn is_plain(&self) -> bool

Returns true if this key is plain (unhashed).

pub fn to_hashed(&self) -> FixedBytes<32>

Produce the keccak256-hashed form of this slot key.

• If already Hashed, returns the inner value as-is (no double-hash).
• If Plain, applies keccak256 and returns the result.

pub fn to_changeset_key(self, use_hashed_state: bool) -> FixedBytes<32>

Convert a plain slot to its changeset representation.

In v2 mode (use_hashed_state = true), the changeset stores hashed keys, so the plain key is hashed. In v1 mode, the plain key is stored as-is.

Panics (debug) if called on an already-hashed key.

pub fn to_changeset(self, use_hashed_state: bool) -> StorageSlotKey

Like to_changeset_key but returns a tagged StorageSlotKey instead of a raw B256.

Panics (debug) if called on an already-hashed key.

Trait Implementations

impl Clone for StorageSlotKey

fn clone(&self) -> StorageSlotKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StorageSlotKey

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

Formats the value using the given formatter.

impl Default for StorageSlotKey

fn default() -> StorageSlotKey

Returns the “default value” for a type.

impl From<StorageSlotKey> for FixedBytes<32>

fn from(key: StorageSlotKey) -> FixedBytes<32>

Converts to this type from the input type.

impl Hash for StorageSlotKey

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 Ord for StorageSlotKey

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

fn eq(&self, other: &StorageSlotKey) -> 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 StorageSlotKey

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

impl Eq for StorageSlotKey

impl StructuralPartialEq for StorageSlotKey

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: 33 bytes

Size for each variant:

• Plain: 32 bytes
• Hashed: 32 bytes