Struct BundleRequest

pub struct BundleRequest { /* private fields */ }

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_block)

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 transaction_hashes(&self) -> Vec<TxHash>

Get a list of transaction hashes in the bundle request.

pub fn uuid(&self) -> &Option<Uuid>

Get a reference to the replacement uuid (if any).

pub fn set_uuid(self, uuid: Uuid) -> Self

Set the replacement uuid of the bundle. This is used for bundle replacements or cancellations using eth_cancelBundle

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

Get the target block (if any).

pub fn set_block(self, 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 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.