Struct TransactionSigned

pub struct TransactionSigned { /* private fields */ }

Signed Ethereum transaction.

Implementations

impl TransactionSigned

pub const fn signature(&self) -> &Signature

Returns the signature of the transaction

impl TransactionSigned

pub fn new(transaction: Transaction, signature: Signature, hash: B256) -> Self

Creates a new signed transaction from the given transaction, signature and hash.

pub fn into_transaction(self) -> Transaction

Consumes the type and returns the transaction.

pub const fn transaction(&self) -> &Transaction

Returns the transaction.

pub fn hash(&self) -> &B256

Returns the transaction hash.

pub fn new_unhashed(transaction: Transaction, signature: Signature) -> Self

Creates a new signed transaction from the given transaction and signature without the hash.

Note: this only calculates the hash on the first TransactionSigned::hash call.

pub fn split(self) -> (Transaction, Signature)

Splits the TransactionSigned into its transaction and signature.

pub fn try_into_pooled_eip4844( self, sidecar: BlobTransactionSidecar, ) -> Result<PooledTransaction, Self>

Converts from an EIP-4844 transaction to a PooledTransaction with the given sidecar.

Returns an Err containing the original TransactionSigned if the transaction is not EIP-4844.

pub const fn as_eip4844(&self) -> Option<&TxEip4844>

Returns the [TxEip4844] if the transaction is an EIP-4844 transaction.

pub const fn transaction_mut(&mut self) -> &mut Transaction

Available on crate feature test-utils only.

Provides mutable access to the transaction.

pub fn into_parts(self) -> (Transaction, Signature, B256)

Splits the transaction into parts.

Methods from Deref<Target = Transaction>

pub fn tx_type(&self) -> TxType

Returns TxType of the transaction.

pub fn set_nonce(&mut self, nonce: u64)

This sets the transaction’s nonce.

Trait Implementations

impl<'a> Arbitrary<'a> for TransactionSigned

Available on crate feature arbitrary only.

fn arbitrary(u: &mut Unstructured<'a>) -> Result<Self>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl AsRef<Transaction> for TransactionSigned

fn as_ref(&self) -> &Transaction

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for TransactionSigned

fn clone(&self) -> TransactionSigned

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Compact for TransactionSigned

Available on crate feature reth-codec only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

Takes a buffer which can be written to. Ideally, it returns the length written to.

fn from_compact(buf: &[u8], _len: usize) -> (Self, &[u8])

Takes a buffer which can be read from. Returns the object and buf with its internal cursor advanced (eg..advance(len)).

fn specialized_to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

“Optional”: If there’s no good reason to use it, don’t.

fn specialized_from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

“Optional”: If there’s no good reason to use it, don’t.

impl Debug for TransactionSigned

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

Formats the value using the given formatter.

impl Decodable for TransactionSigned

fn decode(buf: &mut &[u8]) -> Result<Self>

Decodes the blob into the appropriate type. buf must be advanced past the decoded object.

impl Decodable2718 for TransactionSigned

fn typed_decode(ty: u8, buf: &mut &[u8]) -> Eip2718Result<Self>

Decode the appropriate variant, based on the type flag.

fn fallback_decode(buf: &mut &[u8]) -> Eip2718Result<Self>

Decode the default variant.

fn extract_type_byte(buf: &mut &[u8]) -> Option<u8>

Extract the type byte from the buffer, if any. The type byte is the first byte, provided that that first byte is 0x7f or lower.

fn decode_2718(buf: &mut &[u8]) -> Result<Self, Eip2718Error>

Encode the transaction according to EIP-2718 rules. First a 1-byte type flag in the range 0x0-0x7f, then the body of the transaction.

fn network_decode(buf: &mut &[u8]) -> Result<Self, Eip2718Error>

Decode an EIP-2718 transaction in the network format. The network format is used ONLY by the Ethereum p2p protocol. Do not call this method unless you are building a p2p protocol client.

impl Default for TransactionSigned

fn default() -> Self

Returns the “default value” for a type.

impl Deref for TransactionSigned

type Target = Transaction

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for TransactionSigned

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'de> Deserialize<'de> for TransactionSigned

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de> DeserializeAs<'de, TransactionSigned> for TransactionSigned<'de>

Available on crate features serde and serde-bincode-compat only.

fn deserialize_as<D>(deserializer: D) -> Result<TransactionSigned, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encodable for TransactionSigned

fn encode(&self, out: &mut dyn BufMut)

Encodes the type into the out buffer.

fn length(&self) -> usize

Returns the length of the encoding of this type in bytes.

impl Encodable2718 for TransactionSigned

fn type_flag(&self) -> Option<u8>

Return the type flag (if any).

fn encode_2718_len(&self) -> usize

The length of the 2718 encoded envelope. This is the length of the type flag + the length of the inner encoding.

fn encode_2718(&self, out: &mut dyn BufMut)

Encode the transaction according to EIP-2718 rules. First a 1-byte type flag in the range 0x0-0x7f, then the body of the transaction.

fn trie_hash(&self) -> B256

Compute the hash as committed to in the MPT trie. This hash is used ONLY by the Ethereum merkle-patricia trie and associated proofs. Do not call this method unless you are building a full or light client.

fn encoded_2718(&self) -> Vec<u8>

Encode the transaction according to [EIP-2718] rules. First a 1-byte type flag in the range 0x0-0x7f, then the body of the transaction.

fn seal(self) -> Sealed<Self>

Seal the encodable, by encoding and hashing it.

fn network_len(&self) -> usize

The length of the 2718 encoded envelope in network format. This is the length of the header + the length of the type flag and inner encoding.

fn network_encode(&self, out: &mut dyn BufMut)

Encode in the network format. The network format is used ONLY by the Ethereum p2p protocol. Do not call this method unless you are building a p2p protocol client.

impl<'a> From<&'a TransactionSigned> for TransactionSigned<'a>

Available on crate features serde and serde-bincode-compat only.

fn from(value: &'a TransactionSigned) -> Self

Converts to this type from the input type.

impl From<EthereumTxEnvelope<TxEip4844Variant>> for TransactionSigned

fn from(value: TxEnvelope) -> Self

Converts to this type from the input type.

impl From<EthereumTxEnvelope<TxEip4844WithSidecar>> for TransactionSigned

fn from(value: PooledTransaction) -> Self

Converts to this type from the input type.

impl From<Signed<EthereumTypedTransaction<TxEip4844Variant>>> for TransactionSigned

fn from(value: Signed<TypedTransaction>) -> Self

Converts to this type from the input type.

impl From<Signed<Transaction>> for TransactionSigned

fn from(value: Signed<Transaction>) -> Self

Converts to this type from the input type.

impl From<Signed<TxEip1559>> for TransactionSigned

fn from(value: Signed<TxEip1559>) -> Self

Converts to this type from the input type.

impl From<Signed<TxEip2930>> for TransactionSigned

fn from(value: Signed<TxEip2930>) -> Self

Converts to this type from the input type.

impl From<Signed<TxEip4844>> for TransactionSigned

fn from(value: Signed<TxEip4844>) -> Self

Converts to this type from the input type.

impl From<Signed<TxEip4844Variant>> for TransactionSigned

fn from(value: Signed<TxEip4844Variant>) -> Self

Converts to this type from the input type.

impl From<Signed<TxEip4844WithSidecar>> for TransactionSigned

fn from(value: Signed<TxEip4844WithSidecar>) -> Self

Converts to this type from the input type.

impl From<Signed<TxEip7702>> for TransactionSigned

fn from(value: Signed<TxEip7702>) -> Self

Converts to this type from the input type.

impl From<Signed<TxLegacy>> for TransactionSigned

fn from(value: Signed<TxLegacy>) -> Self

Converts to this type from the input type.

impl<T> From<Transaction<T>> for TransactionSigned

where Self: From<T>,

Available on crate feature alloy-compat only.

fn from(value: AlloyRpcTransaction<T>) -> Self

Converts to this type from the input type.

impl<'a> From<TransactionSigned<'a>> for TransactionSigned

Available on crate features serde and serde-bincode-compat only.

fn from(value: TransactionSigned<'a>) -> Self

Converts to this type from the input type.

impl From<TransactionSigned> for EthereumTxEnvelope<TxEip4844>

fn from(value: TransactionSigned) -> Self

Converts to this type from the input type.

impl From<TransactionSigned> for TxEnvelope

fn from(value: TransactionSigned) -> Self

Converts to this type from the input type.

impl From<TransactionSigned> for Signed<Transaction>

fn from(value: TransactionSigned) -> Self

Converts to this type from the input type.

impl FromRecoveredTx<TransactionSigned> for TxEnv

fn from_recovered_tx(tx: &TransactionSigned, sender: Address) -> Self

Builds a TxEnv from a transaction and a sender address.

impl FromTxWithEncoded<TransactionSigned> for TxEnv

fn from_encoded_tx( tx: &TransactionSigned, sender: Address, encoded: Bytes, ) -> Self

Builds a TxEnv from a transaction, its sender, and encoded transaction bytes.

impl Hash for TransactionSigned

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 InMemorySize for TransactionSigned

fn size(&self) -> usize

Returns a heuristic for the in-memory size of a struct.

impl PartialEq for TransactionSigned

fn eq(&self, other: &Self) -> 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 SerdeBincodeCompat for TransactionSigned

Available on crate features serde and serde-bincode-compat only.

type BincodeRepr<'a> = TransactionSigned<'a>

Serde representation of the type for bincode serialization.

fn as_repr(&self) -> Self::BincodeRepr<'_>

Convert this type into its bincode representation

fn from_repr(repr: Self::BincodeRepr<'_>) -> Self

Convert from the bincode representation

impl Serialize for TransactionSigned

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl SerializeAs<TransactionSigned> for TransactionSigned<'_>

Available on crate features serde and serde-bincode-compat only.

fn serialize_as<S>( source: &TransactionSigned, serializer: S, ) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl SignedTransaction for TransactionSigned

fn tx_hash(&self) -> &TxHash

Returns reference to transaction hash.

fn recover_signer(&self) -> Result<Address, RecoveryError>

Recover signer from signature and hash.

fn recover_signer_unchecked_with_buf( &self, buf: &mut Vec<u8>, ) -> Result<Address, RecoveryError>

Same as [Self::recover_signer_unchecked] but receives a buffer to operate on. This is used during batch recovery to avoid allocating a new buffer for each transaction.

fn is_broadcastable_in_full(&self) -> bool

Returns whether this transaction type can be broadcasted as full transaction over the network.

fn try_recover(&self) -> Result<Address, RecoveryError>

Recover signer from signature and hash.

fn recover_signer_unchecked(&self) -> Result<Address, RecoveryError>

Recover signer from signature and hash without ensuring that the signature has a low s value.

fn try_recover_unchecked(&self) -> Result<Address, RecoveryError>

Recover signer from signature and hash without ensuring that the signature has a low s value.

fn recalculate_hash(&self) -> FixedBytes<32>

Calculate transaction hash, eip2728 transaction does not contain rlp header and start with tx type.

fn try_clone_into_recovered(&self) -> Result<Recovered<Self>, RecoveryError>

Tries to recover signer and return [Recovered] by cloning the type.

fn try_into_recovered(self) -> Result<Recovered<Self>, Self>

Tries to recover signer and return [Recovered].

fn into_recovered_unchecked(self) -> Result<Recovered<Self>, RecoveryError>

Consumes the type, recover signer and return [Recovered] without ensuring that the signature has a low s value (EIP-2).

fn with_signer(self, signer: Address) -> Recovered<Self>

Returns the [Recovered] transaction with the given sender.

impl Transaction for TransactionSigned

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

Get chain_id.

fn nonce(&self) -> u64

Get nonce.

fn gas_limit(&self) -> u64

Get gas_limit.

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

Get gas_price.

fn max_fee_per_gas(&self) -> u128

For dynamic fee transactions returns the maximum fee per gas the caller is willing to pay.

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

For dynamic fee transactions returns the Priority fee the caller is paying to the block author.

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

Max fee per blob gas for EIP-4844 transaction.

fn priority_fee_or_price(&self) -> u128

Return the max priority fee per gas if the transaction is an dynamic fee transaction, and otherwise return the gas price.

fn effective_gas_price(&self, base_fee: Option<u64>) -> u128

Returns the effective gas price for the given base fee.

fn is_dynamic_fee(&self) -> bool

Returns true if the transaction supports dynamic fees.

fn kind(&self) -> TxKind

Returns the transaction kind.

fn is_create(&self) -> bool

Returns true if the transaction is a contract creation. We don’t provide a default implementation via kind as it copies the 21-byte [TxKind] for this simple check. A proper implementation shouldn’t allocate.

fn value(&self) -> U256

Get value.

fn input(&self) -> &Bytes

Get data.

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

Returns the EIP-2930 access_list for the particular transaction type. Returns None for older transaction types.

fn blob_versioned_hashes(&self) -> Option<&[B256]>

Blob versioned hashes for eip4844 transaction. For previous transaction types this is None.

fn authorization_list(&self) -> Option<&[SignedAuthorization]>

Returns the [SignedAuthorization] list of the transaction.

fn effective_tip_per_gas(&self, base_fee: u64) -> Option<u128>

Returns the effective tip for this transaction.

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

Get the transaction’s address of the contract that will be called, or the address that will receive the transfer.

fn function_selector(&self) -> Option<&FixedBytes<4>>

Returns the first 4bytes of the calldata for a function call.

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

Returns the number of blobs of this transaction.

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

Returns the total gas for all blobs in this transaction.

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

Returns the number of blobs of [SignedAuthorization] in this transactions

impl TryFrom<AnyRpcTransaction> for TransactionSigned

Available on crate feature alloy-compat only.

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(tx: AnyRpcTransaction) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<TransactionSigned> for PooledTransaction

type Error = TransactionConversionError

The type returned in the event of a conversion error.

fn try_from(tx: TransactionSigned) -> Result<Self, Self::Error>

Performs the conversion.

impl Typed2718 for TransactionSigned

fn ty(&self) -> u8

Returns the EIP-2718 type flag.

fn is_type(&self, ty: u8) -> bool

Returns true if the type matches the given type.

fn is_legacy(&self) -> bool

Returns true if the type is a legacy transaction.

fn is_eip2930(&self) -> bool

Returns true if the type is an EIP-2930 transaction.

fn is_eip1559(&self) -> bool

Returns true if the type is an EIP-1559 transaction.

fn is_eip4844(&self) -> bool

Returns true if the type is an EIP-4844 transaction.

fn is_eip7702(&self) -> bool

Returns true if the type is an EIP-7702 transaction.

impl Eq for TransactionSigned

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: 336 bytes