Struct BundleRequest

pub struct BundleRequest {
    transactions: Vec<BundleTransaction>,
    revertible_transaction_hashes: Vec<TxHash>,
    access_list_hashes: Option<Vec<TxHash>>,
    target_block: Option<U64>,
    min_timestamp: Option<u64>,
    max_timestamp: Option<u64>,
    simulation_block: Option<U64>,
    simulation_timestamp: Option<u64>,
    simulation_basefee: Option<u64>,
}

A bundle that can be submitted to a Flashbots relay.

The bundle can include your own transactions and transactions from the mempool.

Additionally, this bundle can be simulated through a relay if simulation parameters are provided using BundleRequest::set_simulation_block and BundleRequest::set_simulation_timestamp.

Please note that some parameters are required, and submitting a bundle without them will get it rejected pre-flight. The required parameters include:

• At least one transaction (BundleRequest::push_transaction)
• A target block (BundleRequest::set_target_block)

Fields

transactions: Vec<BundleTransaction>

revertible_transaction_hashes: Vec<TxHash>

access_list_hashes: Option<Vec<TxHash>>

target_block: Option<U64>

min_timestamp: Option<u64>

max_timestamp: Option<u64>

simulation_block: Option<U64>

simulation_timestamp: Option<u64>

simulation_basefee: Option<u64>

Implementations

impl BundleRequest

pub fn new() -> Self

Creates an empty bundle request.

pub fn push_transaction<T: Into<BundleTransaction>>(self, tx: T) -> Self

Adds a transaction to the bundle request.

Transactions added to the bundle can either be novel transactions, i.e. transactions that you have crafted, or they can be from one of the mempool APIs.

pub fn add_transaction<T: Into<BundleTransaction>>(&mut self, tx: T)

Adds a transaction to the bundle request.

This function takes a mutable reference to self and adds the specified transaction to the transactions vector. The added transaction can either be a novel transaction that you have crafted, or it can be from one of the mempool APIs.

pub fn push_revertible_transaction<T: Into<BundleTransaction>>( self, tx: T, ) -> Self

Adds a revertible transaction to the bundle request.

This differs from BundleRequest::push_transaction in that the bundle will still be considered valid if the transaction reverts.

pub fn add_revertible_transaction<T: Into<BundleTransaction>>(&mut self, tx: T)

Adds a revertible transaction to the bundle request.

This function takes a mutable reference to self and adds the specified revertible transaction to the transactions vector. The added transaction can either be a novel transaction that you have crafted, or it can be from one of the mempool APIs. Unlike the push_transaction method, the bundle will still be considered valid even if the added transaction reverts.

pub fn transactions(&self) -> &Vec<BundleTransaction>

Get a reference to the transactions currently in the bundle request.

pub fn target_block(&self) -> Option<U64>

Get the target block (if any).

pub fn set_target_block(self, target_block: U64) -> Self

Set the target block of the bundle.

pub fn simulation_block(&self) -> Option<U64>

Get the block that determines the state for bundle simulation (if any).

See eth_callBundle in the Flashbots documentation for more information on bundle simulations.

pub fn set_simulation_block(self, block: U64) -> Self

Set the block that determines the state for bundle simulation.

pub fn set_access_list_hashes(self, hashes: Option<Vec<TxHash>>) -> Self

pub fn simulation_timestamp(&self) -> Option<u64>

Get the UNIX timestamp used for bundle simulation (if any).

See eth_callBundle in the Flashbots documentation for more information on bundle simulations.

pub fn set_simulation_timestamp(self, timestamp: u64) -> Self

Set the UNIX timestamp used for bundle simulation.

pub fn simulation_basefee(&self) -> Option<u64>

Get the base gas fee for bundle simulation (if any).

See eth_callBundle in the Flashbots documentation for more information on bundle simulations.

pub fn set_simulation_basefee(self, basefee: u64) -> Self

Set the base gas fee for bundle simulation (if any). Optional: will default to a value chosen by the node if not specified.

pub fn min_timestamp(&self) -> Option<u64>

Get the minimum timestamp for which this bundle is valid (if any), in seconds since the UNIX epoch.

pub fn set_min_timestamp(self, timestamp: u64) -> Self

Set the minimum timestamp for which this bundle is valid (if any), in seconds since the UNIX epoch.

pub fn max_timestamp(&self) -> Option<u64>

Get the maximum timestamp for which this bundle is valid (if any), in seconds since the UNIX epoch.

pub fn set_max_timestamp(self, timestamp: u64) -> Self

Set the maximum timestamp for which this bundle is valid (if any), in seconds since the UNIX epoch.

Trait Implementations

impl Clone for BundleRequest

fn clone(&self) -> BundleRequest

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BundleRequest

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

Formats the value using the given formatter.

impl Default for BundleRequest

fn default() -> BundleRequest

Returns the “default value” for a type.

impl Serialize for BundleRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 168 bytes