Struct StorageCache 

pub struct StorageCache;

Global accessor to persistent storage that relies on VM-level caching.

Trait Implementations

impl GlobalStorage for StorageCache

fn get_word(vm: VM, key: U256) -> B256

Retrieves a 32-byte EVM word from persistent storage.

unsafe fn set_word(vm: VM, key: U256, value: B256)

Stores a 32-byte EVM word to persistent storage.

Safety

May alias storage.

unsafe fn get<const N: usize>( host: VM, key: U256, offset: usize, ) -> FixedBytes<N>

Retrieves N ≤ 32 bytes from persistent storage, performing SLOAD’s only as needed. The bytes are read from slot key, starting offset bytes from the left. Note that the bytes must exist within a single, 32-byte EVM word.

unsafe fn get_uint<const B: usize, const L: usize>( host: VM, key: U256, offset: usize, ) -> Uint<B, L>

Retrieves a Uint from persistent storage, performing SLOAD’s only as needed. The integer’s bytes are read from slot key, starting offset bytes from the left. Note that the bytes must exist within a single, 32-byte EVM word.

unsafe fn get_signed<const B: usize, const L: usize>( host: VM, key: U256, offset: usize, ) -> Signed<B, L>

Retrieves a Signed from persistent storage, performing SLOAD’s only as needed. The integer’s bytes are read from slot key, starting offset bytes from the left. Note that the bytes must exist within a single, 32-byte EVM word.

unsafe fn get_byte(host: VM, key: U256, offset: usize) -> u8

Retrieves a u8 from persistent storage, performing SLOAD’s only as needed. The byte is read from slot key, starting offset bytes from the left.

unsafe fn set<const N: usize>( host: VM, key: U256, offset: usize, value: FixedBytes<N>, )

Writes N ≤ 32 bytes to persistent storage, performing SSTORE’s only as needed. The bytes are written to slot key, starting offset bytes from the left. Note that the bytes must be written to a single, 32-byte EVM word.

unsafe fn set_uint<const B: usize, const L: usize>( host: VM, key: U256, offset: usize, value: Uint<B, L>, )

Writes a Uint to persistent storage, performing SSTORE’s only as needed. The integer’s bytes are written to slot key, starting offset bytes from the left. Note that the bytes must be written to a single, 32-byte EVM word.

unsafe fn set_signed<const B: usize, const L: usize>( host: VM, key: U256, offset: usize, value: Signed<B, L>, )

Writes a Signed to persistent storage, performing SSTORE’s only as needed. The bytes are written to slot key, starting offset bytes from the left. Note that the bytes must be written to a single, 32-byte EVM word.

unsafe fn set_byte(host: VM, key: U256, offset: usize, value: u8)

Writes a u8 to persistent storage, performing SSTORE’s only as needed. The byte is written to slot key, starting offset bytes from the left.

unsafe fn clear_word(host: VM, key: U256)

Clears the 32-byte word at the given key, performing SSTORE’s only as needed.