Struct alloy_zksync::network::transaction_request::TransactionRequest

pub struct TransactionRequest { /* private fields */ }

Transaction request supporting ZKsync’s EIP-712 transaction types.

Unlike TransactionRequest for Ethereum network, it would try to use ZKsync-native EIP712 transaction type by default, unless explicitly overridden. The reason for that is that EIP712 transactions have the same capabilities as type 0 and EIP1559 transactions, while being cheaper to process.

Implementations

impl TransactionRequest

pub fn gas_per_pubdata(&self) -> Option<U256>

Get the gas per pubdata for the transaction.

pub fn set_gas_per_pubdata(&mut self, gas_per_pubdata: U256)

Set the gas per pubdata for the transaction.

pub fn with_gas_per_pubdata(self, gas_per_pubdata: U256) -> Self

Builder-pattern method for setting gas per pubdata.

pub fn factory_deps(&self) -> Option<&Vec<Bytes>>

Get the factory deps for the transaction.

pub fn set_factory_deps(&mut self, factory_deps: Vec<Bytes>)

Set the factory deps for the transaction.

pub fn with_factory_deps(self, factory_deps: Vec<Bytes>) -> Self

Builder-pattern method for setting factory deps.

pub fn custom_signature(&self) -> Option<&Bytes>

Get the custom signature for the transaction.

pub fn set_custom_signature(&mut self, custom_signature: Bytes)

Set the custom signature for the transaction.

pub fn with_custom_signature(self, custom_signature: Bytes) -> Self

Builder-pattern method for setting custom signature.

pub fn paymaster_params(&self) -> Option<&PaymasterParams>

Get the paymaster params for the transaction.

pub fn set_paymaster_params(&mut self, paymaster_params: PaymasterParams)

Set the paymaster params for the transaction.

pub fn with_paymaster_params(self, paymaster_params: PaymasterParams) -> Self

Builder-pattern method for setting paymaster params.

pub fn with_create2_params( self, salt: B256, code: Vec<u8>, constructor_data: Vec<u8>, factory_deps: Vec<Vec<u8>>, ) -> Result<Self, BytecodeHashError>

Builder-pattern method for building a ZKsync EIP-712 create2 transaction.

pub fn with_create_params( self, code: Vec<u8>, constructor_data: Vec<u8>, factory_deps: Vec<Vec<u8>>, ) -> Result<Self, BytecodeHashError>

Builder-pattern method for building a ZKsync EIP-712 create transaction.

impl TransactionRequest

pub fn set_paymaster(&mut self, paymaster_params: PaymasterParams)

👎Deprecated: use set_paymaster_params instead

pub fn with_paymaster(self, paymaster_params: PaymasterParams) -> Self

👎Deprecated: use with_paymaster_params instead

pub fn zksync_deploy( self, code: Vec<u8>, constructor_data: Vec<u8>, factory_deps: Vec<Vec<u8>>, ) -> Result<Self, BytecodeHashError>

👎Deprecated: use with_create_params instead

pub fn zksync_deploy_with_salt( self, salt: B256, code: Vec<u8>, constructor_data: Vec<u8>, factory_deps: Vec<Vec<u8>>, ) -> Result<Self, BytecodeHashError>

👎Deprecated: use with_create2_params instead

Trait Implementations

impl Clone for TransactionRequest

fn clone(&self) -> TransactionRequest

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TransactionRequest

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

Formats the value using the given formatter.

impl Default for TransactionRequest

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TransactionRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<TransactionRequest> for TransactionRequest

fn from(value: TransactionRequest) -> Self

Converts to this type from the input type.

impl From<TxEnvelope> for TransactionRequest

fn from(value: TxEnvelope) -> Self

Converts to this type from the input type.

impl From<TypedTransaction> for TransactionRequest

fn from(value: TypedTransaction) -> Self

Converts to this type from the input type.

impl Serialize for TransactionRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TransactionBuilder<Zksync> for TransactionRequest

fn chain_id(&self) -> Option<ChainId>

Get the chain ID for the transaction.

fn set_chain_id(&mut self, chain_id: ChainId)

Set the chain ID for the transaction.

fn nonce(&self) -> Option<u64>

Get the nonce for the transaction.

fn set_nonce(&mut self, nonce: u64)

Set the nonce for the transaction.

fn input(&self) -> Option<&Bytes>

Get the input data for the transaction.

fn set_input<T: Into<Bytes>>(&mut self, input: T)

Set the input data for the transaction.

fn from(&self) -> Option<Address>

Get the sender for the transaction.

fn set_from(&mut self, from: Address)

Set the sender for the transaction.

fn kind(&self) -> Option<TxKind>

Get the kind of transaction.

fn clear_kind(&mut self)

Clear the kind of transaction.

fn set_kind(&mut self, kind: TxKind)

Set the kind of transaction.

fn value(&self) -> Option<U256>

Get the value for the transaction.

fn set_value(&mut self, value: U256)

Set the value for the transaction.

fn gas_price(&self) -> Option<u128>

Get the legacy gas price for the transaction.

fn set_gas_price(&mut self, gas_price: u128)

Set the legacy gas price for the transaction.

fn max_fee_per_gas(&self) -> Option<u128>

Get the max fee per gas for the transaction.

fn set_max_fee_per_gas(&mut self, max_fee_per_gas: u128)

Set the max fee per gas for the transaction.

fn max_priority_fee_per_gas(&self) -> Option<u128>

Get the max priority fee per gas for the transaction.

fn set_max_priority_fee_per_gas(&mut self, max_priority_fee_per_gas: u128)

Set the max priority fee per gas for the transaction.

fn gas_limit(&self) -> Option<u64>

Get the gas limit for the transaction.

fn set_gas_limit(&mut self, gas_limit: u64)

Set the gas limit for the transaction.

fn access_list(&self) -> Option<&AccessList>

Get the EIP-2930 access list for the transaction.

fn set_access_list(&mut self, access_list: AccessList)

Sets the EIP-2930 access list.

fn complete_type( &self, ty: <Zksync as Network>::TxType, ) -> Result<(), Vec<&'static str>>

Check if all necessary keys are present to build the specified type, returning a list of missing keys.

fn can_submit(&self) -> bool

True if the builder contains all necessary information to be submitted to the eth_sendTransaction endpoint.

fn can_build(&self) -> bool

True if the builder contains all necessary information to be built into a valid transaction.

fn output_tx_type(&self) -> <Zksync as Network>::TxType

Returns the transaction type that this builder will attempt to build. This does not imply that the builder is ready to build.

fn output_tx_type_checked(&self) -> Option<<Zksync as Network>::TxType>

Returns the transaction type that this builder will build. None if the builder is not ready to build.

fn prep_for_submission(&mut self)

Trim any conflicting keys and populate any computed fields (like blob hashes).

fn build_unsigned(self) -> BuildResult<TypedTransaction, Zksync>

Build an unsigned, but typed, transaction.

async fn build<W: NetworkWallet<Zksync>>( self, wallet: &W, ) -> Result<<Zksync as Network>::TxEnvelope, TransactionBuilderError<Zksync>>

Build a signed transaction.

fn with_chain_id(self, chain_id: u64) -> Self

Builder-pattern method for setting the chain ID.

fn with_nonce(self, nonce: u64) -> Self

Builder-pattern method for setting the nonce.

fn with_input<T>(self, input: T) -> Self

where T: Into<Bytes>,

Builder-pattern method for setting the input data.

fn with_from(self, from: Address) -> Self

Builder-pattern method for setting the sender.

fn with_kind(self, kind: TxKind) -> Self

Builder-pattern method for setting the kind of transaction.

fn to(&self) -> Option<Address>

Get the recipient for the transaction.

fn set_to(&mut self, to: Address)

Set the recipient for the transaction.

fn with_to(self, to: Address) -> Self

Builder-pattern method for setting the recipient.

fn set_create(&mut self)

Set the to field to a create call.

fn into_create(self) -> Self

Set the to field to a create call.

fn set_deploy_code<T>(&mut self, code: T)

where T: Into<Bytes>,

Deploy the code by making a create call with data. This will set the to field to [TxKind::Create].

fn with_deploy_code<T>(self, code: T) -> Self

where T: Into<Bytes>,

Deploy the code by making a create call with data. This will set the to field to [TxKind::Create].

fn set_call<T>(&mut self, t: &T)

where T: SolCall,

Set the data field to a contract call. This will clear the to field if it is set to [TxKind::Create].

fn with_call<T>(self, t: &T) -> Self

where T: SolCall,

Make a contract call with data.

fn calculate_create_address(&self) -> Option<Address>

Calculates the address that will be created by the transaction, if any.

fn with_value(self, value: Uint<256, 4>) -> Self

Builder-pattern method for setting the value.

fn with_gas_price(self, gas_price: u128) -> Self

Builder-pattern method for setting the legacy gas price.

fn with_max_fee_per_gas(self, max_fee_per_gas: u128) -> Self

Builder-pattern method for setting max fee per gas .

fn with_max_priority_fee_per_gas(self, max_priority_fee_per_gas: u128) -> Self

Builder-pattern method for setting max priority fee per gas.

fn with_gas_limit(self, gas_limit: u64) -> Self

Builder-pattern method for setting the gas limit.

fn with_access_list(self, access_list: AccessList) -> Self

Builder-pattern method for setting the access list.

fn complete_preferred(&self) -> Result<(), Vec<&'static str>>

Check if all necessary keys are present to build the currently-preferred transaction type, returning a list of missing keys.

fn assert_preferred(&self, ty: <N as Network>::TxType)

Assert that the builder prefers a certain transaction type. This does not indicate that the builder is ready to build. This function uses a dbg_assert_eq! to check the builder status, and will have no affect in release builds.

fn assert_preferred_chained(self, ty: <N as Network>::TxType) -> Self

Assert that the builder prefers a certain transaction type. This does not indicate that the builder is ready to build. This function uses a dbg_assert_eq! to check the builder status, and will have no affect in release builds.

fn apply<F>(self, f: F) -> Self

where F: FnOnce(Self) -> Self,

Apply a function to the builder, returning the modified builder.

fn try_apply<F, E>(self, f: F) -> Result<Self, E>

where F: FnOnce(Self) -> Result<Self, E>,

Apply a fallible function to the builder, returning the modified builder or an error.