Trait PrecompileStorageProvider 

pub trait PrecompileStorageProvider {
    // Required methods
    fn chain_id(&self) -> u64;
    fn timestamp(&self) -> U256;
    fn beneficiary(&self) -> Address;
    fn block_number(&self) -> u64;
    fn set_code(&mut self, address: Address, code: Bytecode) -> Result<()>;
    fn with_account_info(
        &mut self,
        address: Address,
        f: &mut dyn FnMut(&AccountInfo),
    ) -> Result<()>;
    fn sload(&mut self, address: Address, key: U256) -> Result<U256>;
    fn tload(&mut self, address: Address, key: U256) -> Result<U256>;
    fn sstore(&mut self, address: Address, key: U256, value: U256) -> Result<()>;
    fn tstore(&mut self, address: Address, key: U256, value: U256) -> Result<()>;
    fn emit_event(&mut self, address: Address, event: LogData) -> Result<()>;
    fn deduct_gas(&mut self, gas: u64) -> Result<()>;
    fn refund_gas(&mut self, gas: i64);
    fn gas_limit(&self) -> u64;
    fn gas_used(&self) -> u64;
    fn state_gas_used(&self) -> u64;
    fn gas_refunded(&self) -> i64;
    fn reservoir(&self) -> u64;
    fn spec(&self) -> TempoHardfork;
    fn amsterdam_eip8037_enabled(&self) -> bool;
    fn is_static(&self) -> bool;
    fn checkpoint(&mut self) -> JournalCheckpoint;
    fn checkpoint_commit(&mut self, checkpoint: JournalCheckpoint);
    fn checkpoint_revert(&mut self, checkpoint: JournalCheckpoint);
    fn set_tip1060_storage_credits(&mut self, enabled: bool);

    // Provided methods
    fn keccak256(&mut self, data: &[u8]) -> Result<B256> { ... }
    fn recover_signer(
        &mut self,
        digest: B256,
        v: u8,
        r: B256,
        s: B256,
    ) -> Result<Option<Address>> { ... }
}

Low-level storage provider for interacting with the EVM.

Implementations

• EvmPrecompileStorageProvider - Production EVM storage
• HashMapStorageProvider - Test storage

Sync with [StorageCtx]

StorageCtx mirrors these methods with split mutability for read (staticcall) vs write (call). When adding new methods here, remember to add corresponding methods to StorageCtx.

Required Methods

fn chain_id(&self) -> u64

Returns the chain ID.

fn timestamp(&self) -> U256

Returns the current block timestamp.

fn beneficiary(&self) -> Address

Returns the current block beneficiary (coinbase).

fn block_number(&self) -> u64

Returns the current block number.

fn set_code(&mut self, address: Address, code: Bytecode) -> Result<()>

Sets the bytecode at the given address.

fn with_account_info( &mut self, address: Address, f: &mut dyn FnMut(&AccountInfo), ) -> Result<()>

Executes a closure with access to the account info for the given address.

fn sload(&mut self, address: Address, key: U256) -> Result<U256>

Performs an SLOAD operation (persistent storage read).

fn tload(&mut self, address: Address, key: U256) -> Result<U256>

Performs a TLOAD operation (transient storage read).

fn sstore(&mut self, address: Address, key: U256, value: U256) -> Result<()>

Performs an SSTORE operation (persistent storage write).

fn tstore(&mut self, address: Address, key: U256, value: U256) -> Result<()>

Performs a TSTORE operation (transient storage write).

fn emit_event(&mut self, address: Address, event: LogData) -> Result<()>

Emits an event from the given contract address.

fn deduct_gas(&mut self, gas: u64) -> Result<()>

Deducts gas from the remaining gas and returns an error if insufficient.

fn refund_gas(&mut self, gas: i64)

Add refund to the refund gas counter.

fn gas_limit(&self) -> u64

Returns the gas limit for this precompile call.

fn gas_used(&self) -> u64

Returns the gas used so far.

fn state_gas_used(&self) -> u64

Returns the state-creating gas used so far (cold SSTORE zero->non-zero, code deposit).

fn gas_refunded(&self) -> i64

Returns the gas refunded so far.

fn reservoir(&self) -> u64

Returns the state gas reservoir.

fn spec(&self) -> TempoHardfork

Returns the currently active hardfork.

fn amsterdam_eip8037_enabled(&self) -> bool

Mirrors CfgEnv::enable_amsterdam_eip8037. Used by precompiles to gate the TIP-1016 regular/state gas split independently of the active hardfork.

fn is_static(&self) -> bool

Returns whether the current call context is static.

fn checkpoint(&mut self) -> JournalCheckpoint

Creates a new journal checkpoint so that all subsequent state-changing operations can be atomically committed (checkpoint_commit) or reverted (checkpoint_revert).

Prefer StorageCtx::checkpoint which returns a CheckpointGuard that auto-reverts on drop and is hardfork-aware (no-op pre-T1C).

fn checkpoint_commit(&mut self, checkpoint: JournalCheckpoint)

Commits all state changes since the given checkpoint.

Prefer CheckpointGuard::commit.

fn checkpoint_revert(&mut self, checkpoint: JournalCheckpoint)

Reverts all state changes back to the given checkpoint.

Prefer CheckpointGuard (auto-reverts on drop).

fn set_tip1060_storage_credits(&mut self, enabled: bool)

Enables or disables TIP-1060 storage-credit accounting for subsequent storage writes.

Implementations that do not run TIP-1060 accounting may treat this as a no-op. Production providers must still hardfork-gate enabling so calling this with true before T7 does not activate storage credits early.

Provided Methods

fn keccak256(&mut self, data: &[u8]) -> Result<B256>

Computes keccak256 and charges the appropriate gas.

Implementations should use this over naked keccak256 call to ensure gas is accounted for.

fn recover_signer( &mut self, digest: B256, v: u8, r: B256, s: B256, ) -> Result<Option<Address>>

Recovers the signer address from an ECDSA signature and charges ecrecover gas. As per TIP-1004, it only accepts v values of 27 or 28 (no 0/1 normalization).

Returns Ok(None) on invalid signatures; callers map to domain-specific errors.

Dyn Compatibility

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors

impl PrecompileStorageProvider for HashMapStorageProvider

impl<'a> PrecompileStorageProvider for EvmPrecompileStorageProvider<'a>