Struct Gasometer 

pub struct Gasometer<'config> { /* private fields */ }

EVM gasometer.

Implementations

impl<'config> Gasometer<'config>

pub const fn new(gas_limit: u64, config: &'config Config) -> Self

Create a new gasometer with given gas limit and config.

pub fn gas_cost(&self, cost: GasCost, gas: u64) -> Result<u64, ExitError>

Returns the numerical gas cost value.

Errors

Return ExitError

pub const fn config(&self) -> &'config Config

Reference of the config.

pub const fn gas_limit(&self) -> u64

Gas limit.

pub fn floor_gas(&self) -> u64

Get floor gas

pub fn gas(&self) -> u64

Remaining gas.

pub const fn total_used_gas(&self) -> u64

Total used gas.

pub fn refunded_gas(&self) -> i64

Refunded gas.

pub fn fail(&mut self) -> ExitError

Explicitly fail the gasometer with out of gas. Return OutOfGas error.

pub fn record_cost(&mut self, cost: u64) -> Result<(), ExitError>

Record an explicit cost.

Errors

Return ExitError

pub fn record_refund(&mut self, refund: i64) -> Result<(), ExitError>

Record an explicit refund.

Errors

Return ExitError that is thrown by gasometer gas calculation errors.

pub fn record_authority_refund( &mut self, refunded_accounts: u64, ) -> Result<(), ExitError>

Record refund for authority - EIP-7702 refunded_accounts represent count of valid authority accounts.

Errors

Return ExitError if record_refund operation fails.

pub fn record_deposit(&mut self, len: usize) -> Result<(), ExitError>

Record CREATE code deposit.

Errors

Return ExitError NOTE: in that context usize->u64 as_conversions is save

pub fn record_dynamic_cost( &mut self, cost: GasCost, memory: Option<MemoryCost>, ) -> Result<(), ExitError>

Record opcode gas cost.

Errors

Return ExitError

pub fn record_stipend(&mut self, stipend: u64) -> Result<(), ExitError>

Record opcode stipend.

Errors

Return ExitError that is thrown by gasometer gas calculation errors.

pub fn calculate_intrinsic_gas_and_gas_floor( data: &[u8], access_list: &[(H160, Vec<H256>)], authorization_list_len: usize, config: &Config, is_contract_creation: bool, ) -> (u64, u64)

Calculate intrinsic gas and gas floor based on transaction data. Returns intrinsic gas cost and gas floor.

pub const fn intrinsic_gas_and_gas_floor( cost: TransactionCost, config: &Config, ) -> (u64, u64)

Calculate intrinsic gas and gas floor based on TransactionCost type and config. Returns intrinsic gas cost and gas floor. Related EIPs:

• EIP-2028
• EIP-7623

pub fn verify_transaction( &mut self, cost: TransactionCost, ) -> Result<(u64, u64), ExitError>

Verify transaction cost against gas limit and gas floor based on TransactionCost type. Returns intrinsic gas cost. For force-debug feature, it will log the transaction cost details. Related EIPs:

• EIP-2028
• EIP-7623

Errors

Return ExitError if gas limit is less than intrinsic gas or gas floor.

pub fn record_transaction( &mut self, cost: TransactionCost, ) -> Result<(), ExitError>

Record transaction cost. Related EIPs:

• EIP-2028
• EIP-7623

Errors

Return ExitError

Trait Implementations

impl<'config> Clone for Gasometer<'config>

fn clone(&self) -> Gasometer<'config>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'config> Debug for Gasometer<'config>

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

Formats the value using the given formatter.