Struct GasFiller

pub struct GasFiller;

A TxFiller that populates gas related fields in transaction requests if unset.

Gas related fields are gas_price, gas_limit, max_fee_per_gas max_priority_fee_per_gas and max_fee_per_blob_gas.

The layer fetches the estimations for these via the Provider::get_gas_price, Provider::estimate_gas and Provider::estimate_eip1559_fees methods.

Note:

The layer will populate gas fields based on the following logic:

• if gas_price is set, it will process as a legacy tx and populate the gas_limit field if unset.
• if access_list is set, it will process as a 2930 tx and populate the gas_limit and gas_price field if unset.
• if blob_sidecar is set, it will process as a 4844 tx and populate the gas_limit, max_fee_per_gas, max_priority_fee_per_gas and max_fee_per_blob_gas fields if unset.
• Otherwise, it will process as a EIP-1559 tx and populate the gas_limit, max_fee_per_gas and max_priority_fee_per_gas fields if unset.
• If the network does not support EIP-1559, it will fallback to the legacy tx and populate the gas_limit and gas_price fields if unset.

Example

let provider = ProviderBuilder::new()
    .with_gas_estimation()
    .wallet(wallet)
    .on_http(url);

provider.send_transaction(TransactionRequest::default()).await;

Trait Implementations

impl Clone for GasFiller

fn clone(&self) -> GasFiller

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for GasFiller

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

Formats the value using the given formatter.

impl Default for GasFiller

fn default() -> GasFiller

Returns the “default value” for a type.

impl<N: Network> TxFiller<N> for GasFiller

type Fillable = GasFillable

The properties that this filler retrieves from the RPC. to fill in the TransactionRequest.

fn status(&self, tx: &<N as Network>::TransactionRequest) -> FillerControlFlow

Return a control-flow enum indicating whether the filler is ready to fill in the transaction request, or if it is missing required properties.

fn fill_sync(&self, _tx: &mut SendableTx<N>)

Performs any synchronous filling. This should be called before TxFiller::prepare and TxFiller::fill to fill in any properties that can be filled synchronously.

async fn prepare<P, T>( &self, provider: &P, tx: &<N as Network>::TransactionRequest, ) -> TransportResult<Self::Fillable>

where P: Provider<T, N>, T: Transport + Clone,

Prepares fillable properties, potentially by making an RPC request.

async fn fill( &self, fillable: Self::Fillable, tx: SendableTx<N>, ) -> TransportResult<SendableTx<N>>

Fills in the transaction request with the fillable properties.

fn join_with<T>(self, other: T) -> JoinFill<Self, T>

where T: TxFiller<N>,

Joins this filler with another filler to compose multiple fillers.

fn continue_filling(&self, tx: &SendableTx<N>) -> bool

Returns true if the filler is should continue filling.

fn ready(&self, tx: &N::TransactionRequest) -> bool

Returns true if the filler is ready to fill in the transaction request.

fn finished(&self, tx: &N::TransactionRequest) -> bool

Returns true if the filler is finished filling in the transaction request.

fn prepare_and_fill<P, T>( &self, provider: &P, tx: SendableTx<N>, ) -> impl Send + Future<Output = TransportResult<SendableTx<N>>>

where P: Provider<T, N>, T: Transport + Clone,

Prepares and fills the transaction request with the fillable properties.

impl Copy for GasFiller