Struct StorageCache 

pub struct StorageCache;

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

Implementations

impl StorageCache

pub fn flush()

👎Deprecated since 0.8.0: Use the .vm() method available on Stylus contracts instead to access host environment methods

Flushes the VM cache, persisting all values to the EVM state trie. Note: this is used at the end of the entrypoint macro and is not typically called by user code.

pub fn clear()

👎Deprecated since 0.8.0: Use the .vm() method available on Stylus contracts instead to access host environment methods

Flushes and clears the VM cache, persisting all values to the EVM state trie. This is useful in cases of reentrancy to ensure cached values from one call context show up in another.

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.