Struct GasParams 

pub struct GasParams { /* private fields */ }

Gas table for dynamic gas constants.

Implementations

impl GasParams

pub const fn new(table: Arc<[u64; 256]>) -> Self

Creates a new GasParams with the given table.

pub fn override_gas(&mut self, values: impl IntoIterator<Item = (GasId, u64)>)

Overrides the gas cost for the given gas id.

It will clone underlying table and override the values.

Use to override default gas cost

use revm_context_interface::cfg::gas_params::{GasParams, GasId};
use primitives::hardfork::SpecId;

let mut gas_table = GasParams::new_spec(SpecId::default());
gas_table.override_gas([(GasId::memory_linear_cost(), 2), (GasId::memory_quadratic_reduction(), 512)].into_iter());
assert_eq!(gas_table.get(GasId::memory_linear_cost()), 2);
assert_eq!(gas_table.get(GasId::memory_quadratic_reduction()), 512);

pub fn table(&self) -> &[u64; 256]

Returns the table.

pub fn new_spec(spec: SpecId) -> Self

Creates a new GasParams for the given spec.

pub fn get(&self, id: GasId) -> u64

Gets the gas cost for the given gas id.

pub fn exp_cost(&self, power: U256) -> u64

EXP opcode cost calculation.

pub fn selfdestruct_refund(&self) -> i64

Selfdestruct refund.

pub fn selfdestruct_cold_cost(&self) -> u64

Selfdestruct cold cost is calculated differently from other cold costs. and it contains both cold and warm costs.

pub fn selfdestruct_cost(&self, should_charge_topup: bool, is_cold: bool) -> u64

Selfdestruct cost.

pub fn extcodecopy(&self, len: usize) -> u64

EXTCODECOPY gas cost

pub fn mcopy_cost(&self, len: usize) -> u64

MCOPY gas cost

pub fn sstore_static_gas(&self) -> u64

Static gas cost for SSTORE opcode

pub fn sstore_set_without_load_cost(&self) -> u64

SSTORE set cost

pub fn sstore_reset_without_cold_load_cost(&self) -> u64

SSTORE reset cost

pub fn sstore_clearing_slot_refund(&self) -> u64

SSTORE clearing slot refund

pub fn sstore_set_refund(&self) -> u64

SSTORE set refund. Used in sstore_refund for SSTORE_SET_GAS - SLOAD_GAS.

pub fn sstore_reset_refund(&self) -> u64

SSTORE reset refund. Used in sstore_refund for SSTORE_RESET_GAS - SLOAD_GAS.

pub fn sstore_dynamic_gas( &self, is_istanbul: bool, vals: &SStoreResult, is_cold: bool, ) -> u64

Dynamic gas cost for SSTORE opcode.

Dynamic gas cost is gas that needs input from SSTORE operation to be calculated.

pub fn sstore_refund(&self, is_istanbul: bool, vals: &SStoreResult) -> i64

SSTORE refund calculation.

pub fn log_cost(&self, n: u8, len: u64) -> u64

LOG opcode cost calculation.

pub fn keccak256_cost(&self, len: usize) -> u64

KECCAK256 gas cost per word

pub fn memory_cost(&self, len: usize) -> u64

Memory gas cost

pub fn initcode_cost(&self, len: usize) -> u64

Initcode word cost

pub fn create_cost(&self) -> u64

Create gas cost

pub fn create2_cost(&self, len: usize) -> u64

Create2 gas cost.

pub fn call_stipend(&self) -> u64

Call stipend.

pub fn call_stipend_reduction(&self, gas_limit: u64) -> u64

Call stipend reduction. Call stipend is reduced by 1/64 of the gas limit.

pub fn transfer_value_cost(&self) -> u64

Transfer value cost

pub fn cold_account_additional_cost(&self) -> u64

Additional cold cost. Additional cold cost is added to the gas cost if the account is cold loaded.

pub fn cold_storage_additional_cost(&self) -> u64

Cold storage additional cost.

pub fn cold_storage_cost(&self) -> u64

Cold storage cost.

pub fn new_account_cost( &self, is_spurious_dragon: bool, transfers_value: bool, ) -> u64

New account cost. New account cost is added to the gas cost if the account is empty.

pub fn new_account_cost_for_selfdestruct(&self) -> u64

New account cost for selfdestruct.

pub fn warm_storage_read_cost(&self) -> u64

Warm storage read cost. Warm storage read cost is added to the gas cost if the account is warm loaded.

pub fn copy_cost(&self, len: usize) -> u64

Copy cost

pub fn copy_per_word_cost(&self, word_num: usize) -> u64

Copy per word cost

pub fn code_deposit_cost(&self, len: usize) -> u64

Code deposit cost, calculated per byte as len * code_deposit_cost.

pub fn sstore_state_gas(&self, vals: &SStoreResult, cpsb: u64) -> u64

State gas for SSTORE: charges for new slot creation (zero → non-zero).

pub fn sstore_state_gas_refill(&self, vals: &SStoreResult, cpsb: u64) -> u64

State gas to refill the reservoir on 0→x→0 storage restoration (EIP-8037).

When a storage slot is restored to its original zero value within the same transaction, the state gas originally charged for the 0→x transition is returned directly to the reservoir (not via the capped refund counter). Returns 0 in any other case.

cpsb is the current cost_per_state_byte (see super::Cfg::cpsb).

pub fn new_account_state_gas(&self, cpsb: u64) -> u64

State gas for new account creation.

pub fn code_deposit_state_gas(&self, len: usize, cpsb: u64) -> u64

State gas for code deposit of len bytes.

pub fn create_state_gas(&self, cpsb: u64) -> u64

State gas for contract metadata creation.

pub fn tx_eip7702_per_empty_account_cost(&self, cpsb: u64) -> u64

Used in GasParams::initial_tx_gas to calculate the eip7702 per-auth cost.

Under EIP-8037 this combines a regular portion with a state-bytes portion (new-account + bytecode) multiplied by cpsb. Pre-EIP-8037 the state-bytes portion is zero so this returns the legacy PER_EMPTY_ACCOUNT_COST.

pub fn tx_eip7702_auth_refund(&self, cpsb: u64) -> u64

EIP-7702 authorization refund per existing account.

Pre-Amsterdam this is a fixed regular-gas refund (PER_EMPTY_ACCOUNT_COST - PER_AUTH_BASE_COST). Under EIP-8037 the refund is fully state gas, equal to the per-account state-gas portion (NEW_ACCOUNT_BYTES * cpsb).

pub fn tx_eip7702_state_gas(&self, cpsb: u64) -> u64

EIP-8037: State gas per EIP-7702 authorization (pessimistic).

Sums the new-account and bytecode state-bytes portions and multiplies by cpsb. Used for initial_state_gas tracking. Zero before AMSTERDAM.

pub fn tx_eip7702_state_refund( &self, refunded_accounts: u64, refunded_bytecodes: u64, cpsb: u64, ) -> u64

EIP-7702 total state-gas refund for a transaction.

Combines the per-account refund (NEW_ACCOUNT_BYTES * cpsb per refunded account, when the authorization targets an account that already exists) with the per-bytecode refund (AUTH_BASE_BYTES * cpsb per refunded bytecode, when the delegation target is already deployed). Returns zero before AMSTERDAM.

pub fn tx_eip7702_auth_refund_regular(&self) -> u64

EIP-7702 per-auth refund: regular-gas portion only.

Pre-Amsterdam this is PER_EMPTY_ACCOUNT_COST - PER_AUTH_BASE_COST (12500). Under EIP-8037 it is zero — the refund is entirely state gas.

pub fn tx_token_non_zero_byte_multiplier(&self) -> u64

Used in GasParams::initial_tx_gas to calculate the token non zero byte multiplier.

pub fn tx_token_cost(&self) -> u64

Used in GasParams::initial_tx_gas to calculate the token cost for input data.

pub fn tx_floor_cost_per_token(&self) -> u64

Used in GasParams::initial_tx_gas to calculate the floor gas per token.

pub fn tx_floor_token_zero_byte_multiplier(&self) -> u64

Multiplier for a zero byte in the floor tokens calculation.

Under EIP-7623 this is 1 (zero bytes count as one token), so the floor reuses tokens_in_calldata. Under EIP-7976 it is raised to tx_token_non_zero_byte_multiplier so every calldata byte contributes the same amount (floor_tokens_in_calldata = (zero + nonzero) * 4).

pub fn tx_floor_cost(&self, input: &[u8]) -> u64

Floor gas cost for a transaction with the given calldata.

Introduced by EIP-7623 and further updated by EIP-7976. Computes tx_floor_cost_per_token * floor_tokens_in_calldata + tx_floor_cost_base_gas, where floor_tokens_in_calldata = zero * tx_floor_token_zero_byte_multiplier + nonzero * tx_token_non_zero_byte_multiplier. When the two multipliers match (EIP-7976), every byte contributes the same amount, so the zero/nonzero split is skipped and input.len() is used directly; otherwise (EIP-7623 path, zero multiplier = 1) the result matches get_tokens_in_calldata(input, nonzero).

pub fn tx_floor_cost_with_tokens(&self, tokens: u64) -> u64

Calculate the floor gas cost for a transaction with the given number of tokens.

pub fn tx_floor_cost_base_gas(&self) -> u64

Used in GasParams::initial_tx_gas to calculate the floor gas base gas.

pub fn tx_access_list_address_cost(&self) -> u64

Used in GasParams::initial_tx_gas to calculate the access list address cost.

pub fn tx_access_list_storage_key_cost(&self) -> u64

Used in GasParams::initial_tx_gas to calculate the access list storage key cost.

pub fn tx_access_list_cost(&self, accounts: u64, storages: u64) -> u64

Calculate the total gas cost for an access list.

This is a helper method that calculates the combined cost of:

• accounts addresses in the access list
• storages storage keys in the access list

Examples

use revm_context_interface::cfg::gas_params::GasParams;
use primitives::hardfork::SpecId;

let gas_params = GasParams::new_spec(SpecId::BERLIN);
// Calculate cost for 2 addresses and 5 storage keys
let cost = gas_params.tx_access_list_cost(2, 5);
assert_eq!(cost, 2 * 2400 + 5 * 1900); // 2 * ACCESS_LIST_ADDRESS + 5 * ACCESS_LIST_STORAGE_KEY

pub fn tx_access_list_floor_byte_multiplier(&self) -> u64

Floor tokens contributed per access-list byte (EIP-7981).

Zero before AMSTERDAM. From AMSTERDAM onward this is 4, so each access-list byte contributes the same 64 gas to the floor as a calldata byte under EIP-7976.

pub fn tx_floor_tokens_in_access_list( &self, accounts: u64, storages: u64, ) -> u64

Floor tokens contributed by an access list with the given address and storage-key counts (EIP-7981). Each address is 20 bytes, each storage key is 32 bytes; tokens per byte come from tx_access_list_floor_byte_multiplier.

pub fn tx_base_stipend(&self) -> u64

Used in GasParams::initial_tx_gas to calculate the base transaction stipend.

pub fn tx_create_cost(&self) -> u64

Used in GasParams::initial_tx_gas to calculate the create cost.

Similar to the Self::create_cost method but it got activated in different fork,

pub fn tx_initcode_cost(&self, len: usize) -> u64

Used in GasParams::initial_tx_gas to calculate the initcode cost per word of len.

pub fn initial_tx_gas( &self, input: &[u8], is_create: bool, access_list_accounts: u64, access_list_storages: u64, authorization_list_num: u64, cpsb: u64, ) -> InitialAndFloorGas

Initial gas that is deducted for transaction to be included. Initial gas contains initial stipend gas, gas for access list and input data.

Under EIP-8037, state gas is tracked separately in initial_state_gas, while regular intrinsic gas accumulates in initial_regular_gas. The state gas components are:

• EIP-7702 auth list state gas (per-auth account creation + metadata costs)
• For CREATE transactions: create_state_gas (account creation + contract metadata)

Note: code_deposit_state_gas is not included since deployed code size is unknown at validation time.

Returns

• Intrinsic gas (including state gas for CREATE)
• Number of tokens in calldata

Trait Implementations

impl Clone for GasParams

fn clone(&self) -> GasParams

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GasParams

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

Formats the value using the given formatter.

impl Default for GasParams

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GasParams

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for GasParams

fn hash<H: Hasher>(&self, hasher: &mut H)

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 PartialEq for GasParams

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

Available on crate feature serde only.

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for GasParams