Struct ResultGas 

pub struct ResultGas { /* private fields */ }

Gas accounting result from transaction execution.

Self-contained gas snapshot with all values needed for downstream consumers.

Stored values

Getter	Source	Description
total_gas_spent()	Gas::spent() = limit − remaining	Total gas consumed before refund
inner_refunded()	Gas::refunded() as u64	Gas refunded (capped per EIP-3529)
floor_gas()	InitialAndFloorGas::floor_gas	EIP-7623 floor gas (0 if not applicable)
state_gas_spent()	Gas::state_gas_spent	State gas consumed during execution (EIP-8037)

Derived values

• tx_gas_used() = max(total_gas_spent − refunded, floor_gas) (the value that goes into receipts)
• block_regular_gas_used() = max(total_gas_spent − state_gas_spent, floor_gas)
• block_state_gas_used() = state_gas_spent
• spent_sub_refunded() = total_gas_spent − refunded (before floor gas check)
• final_refunded() = refunded when floor gas is inactive, 0 when floor gas kicks in

Implementations

impl ResultGas

pub const fn new(total_gas_spent: u64, refunded: u64, floor_gas: u64) -> Self

👎Deprecated since 32.0.0:

It can be a footgun as gas limit is removed, use ResultGas::with_* functions instead

Creates a new ResultGas.

pub const fn new_with_state_gas( total_gas_spent: u64, refunded: u64, floor_gas: u64, state_gas_spent: u64, ) -> Self

Creates a new ResultGas with state gas tracking.

pub const fn total_gas_spent(&self) -> u64

Returns the total gas spent inside execution before any refund.

If you want final gas used, use used().

pub const fn state_gas_spent(&self) -> u64

Returns the state gas spent during execution (EIP-8037).

This is same as ResultGas::block_state_gas_used for the transaction.

pub const fn floor_gas(&self) -> u64

Returns the EIP-7623 floor gas.

pub const fn inner_refunded(&self) -> u64

Returns the raw refund from EVM execution, before EIP-7623 floor gas adjustment.

This is the refunded field value (capped per EIP-3529 but not adjusted for floor gas). See final_refunded() for the effective refund.

pub const fn spent(&self) -> u64

👎Deprecated since 32.0.0:

After EIP-8037 gas is split on regular and state gas, this method is no longer valid. Use ResultGas::total_gas_spent instead

Returns the total gas spent.

pub fn set_total_gas_spent(&mut self, total_gas_spent: u64)

Sets the total_gas_spent field by mutable reference.

pub fn set_refunded(&mut self, refunded: u64)

Sets the refunded field by mutable reference.

pub fn set_floor_gas(&mut self, floor_gas: u64)

Sets the floor_gas field by mutable reference.

pub fn set_state_gas_spent(&mut self, state_gas_spent: u64)

Sets the state_gas_spent field by mutable reference.

pub fn set_spent(&mut self, spent: u64)

👎Deprecated since 32.0.0:

After EIP-8037 gas is split on regular and state gas, this method is no longer valid. Use ResultGas::set_total_gas_spent instead

Sets the spent field by mutable reference.

pub const fn with_total_gas_spent(self, total_gas_spent: u64) -> Self

Sets the total_gas_spent field.

pub const fn with_refunded(self, refunded: u64) -> Self

Sets the refunded field.

pub const fn with_floor_gas(self, floor_gas: u64) -> Self

Sets the floor_gas field.

pub const fn with_state_gas_spent(self, state_gas_spent: u64) -> Self

Sets the state_gas_spent field.

pub const fn with_spent(self, spent: u64) -> Self

👎Deprecated since 32.0.0:

After EIP-8037 gas is split on regular and state gas, this method is no longer valid. Use ResultGas::with_total_gas_spent instead

Sets the spent field.

pub const fn tx_gas_used(&self) -> u64

Returns the total gas used by the transaction.

This value is set inside Receipt.

pub const fn block_regular_gas_used(&self) -> u64

Returns the regular gas used by the block.

pub const fn block_state_gas_used(&self) -> u64

Returns the state gas used by the block.

This is same as ResultGas::state_gas_spent for the block.

pub const fn used(&self) -> u64

👎Deprecated since 32.0.0:

Used is not descriptive enough, use ResultGas::tx_gas_used instead

Returns the final gas used: max(spent - refunded, floor_gas).

This is the value used for receipt cumulative_gas_used accumulation and the per-transaction gas charge.

pub const fn spent_sub_refunded(&self) -> u64

Returns the gas spent minus the refunded gas.

This does not take into account EIP-7623 floor gas. If you want to get the gas used in receipt, use used() instead.

pub const fn final_refunded(&self) -> u64

Returns the effective refund after EIP-7623 floor gas adjustment.

When floor gas kicks in (spent - refunded < floor_gas), the refund is zero because the floor gas charge absorbs it entirely. Otherwise returns the raw refund.

Trait Implementations

impl Clone for ResultGas

fn clone(&self) -> ResultGas

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResultGas

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

Formats the value using the given formatter.

impl Default for ResultGas

fn default() -> ResultGas

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ResultGas

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ResultGas

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

Formats the value using the given formatter.

impl Hash for ResultGas

fn hash<__H: Hasher>(&self, state: &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 ResultGas

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for ResultGas

impl Eq for ResultGas

impl StructuralPartialEq for ResultGas