Struct Signed

pub struct Signed<T, Sig = Signature> { /* private fields */ }

A transaction with a signature and hash seal.

Implementations

impl<T, Sig> Signed<T, Sig>

pub fn new_unchecked(tx: T, signature: Sig, hash: B256) -> Self

Instantiate from a transaction and signature. Does not verify the signature.

pub const fn new_unhashed(tx: T, signature: Sig) -> Self

Instantiate from a transaction and signature. Does not verify the signature.

pub const fn tx(&self) -> &T

Returns a reference to the transaction.

pub fn tx_mut(&mut self) -> &mut T

Returns a mutable reference to the transaction.

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

Returns a reference to the signature.

pub fn strip_signature(self) -> T

Returns the transaction without signature.

pub fn convert<U>(self) -> Signed<U, Sig>

where U: From<T>,

Converts the transaction type to the given alternative that is From<T>

Caution: This is only intended for converting transaction types that are structurally equivalent (produce the same hash).

pub fn try_convert<U>(self) -> Result<Signed<U, Sig>, U::Error>

where U: TryFrom<T>,

Converts the transaction to the given alternative that is TryFrom<T>

Returns the transaction with the new transaction type if all conversions were successful.

Caution: This is only intended for converting transaction types that are structurally equivalent (produce the same hash).

pub fn map<Tx>(self, f: impl FnOnce(T) -> Tx) -> Signed<Tx, Sig>

Applies the given closure to the inner transaction type.

Caution: This is only intended for converting transaction types that are structurally equivalent (produce the same hash).

pub fn try_map<Tx, E>( self, f: impl FnOnce(T) -> Result<Tx, E>, ) -> Result<Signed<Tx, Sig>, E>

Applies the given fallible closure to the inner transactions.

Caution: This is only intended for converting transaction types that are structurally equivalent (produce the same hash).

impl<T: SignableTransaction<Sig>, Sig> Signed<T, Sig>

pub fn signature_hash(&self) -> B256

Calculate the signing hash for the transaction.

impl<T> Signed<T>

where T: RlpEcdsaEncodableTx,

pub fn hash(&self) -> &B256

Returns a reference to the transaction hash.

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

Splits the transaction into parts.

pub fn rlp_encoded_length(&self) -> usize

Get the length of the transaction when RLP encoded.

pub fn rlp_encode(&self, out: &mut dyn BufMut)

RLP encode the signed transaction.

pub fn eip2718_encoded_length(&self) -> usize

Get the length of the transaction when EIP-2718 encoded.

pub fn eip2718_encode_with_type(&self, ty: u8, out: &mut dyn BufMut)

EIP-2718 encode the signed transaction with a specified type flag.

pub fn eip2718_encode(&self, out: &mut dyn BufMut)

EIP-2718 encode the signed transaction.

pub fn network_encoded_length(&self) -> usize

Get the length of the transaction when network encoded.

pub fn network_encode_with_type(&self, ty: u8, out: &mut dyn BufMut)

Network encode the signed transaction with a specified type flag.

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

Network encode the signed transaction.

impl<T> Signed<T>

where T: RlpEcdsaDecodableTx,

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

RLP decode the signed transaction.

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

EIP-2718 decode the signed transaction with a specified type flag.

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

EIP-2718 decode the signed transaction.

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

Network decode the signed transaction with a specified type flag.

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

Network decode the signed transaction.

Trait Implementations

impl<T: Clone, Sig: Clone> Clone for Signed<T, Sig>

fn clone(&self) -> Signed<T, Sig>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug, Sig: Debug> Debug for Signed<T, Sig>

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

Formats the value using the given formatter.

impl<T> Decodable2718 for Signed<T>

where T: RlpEcdsaDecodableTx + Typed2718 + Send + Sync,

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 first byte is 0x7f or lower.

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

Decode 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<'de, T, Sig> Deserialize<'de> for Signed<T, Sig>

where T: Clone + DeserializeOwned, Sig: Clone + DeserializeOwned,

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Encodable2718 for Signed<T>

where T: RlpEcdsaEncodableTx + Typed2718 + Send + Sync,

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 type_flag(&self) -> Option<u8>

Return the type flag (if any).

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<Eip4844: RlpEcdsaEncodableTx> From<EthereumTxEnvelope<Eip4844>> for Signed<EthereumTypedTransaction<Eip4844>>

where EthereumTypedTransaction<Eip4844>: From<Eip4844>,

fn from(value: EthereumTxEnvelope<Eip4844>) -> Self

Converts to this type from the input type.

impl<T, Eip4844> From<Signed<T>> for EthereumTxEnvelope<Eip4844>

where EthereumTypedTransaction<Eip4844>: From<T>, T: RlpEcdsaEncodableTx,

fn from(v: Signed<T>) -> Self

Converts to this type from the input type.

impl<T> From<Signed<TxEip4844>> for Signed<TxEip4844Variant<T>>

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

Converts to this type from the input type.

impl<T: Encodable7594> From<Signed<TxEip4844WithSidecar<T>>> for Signed<TxEip4844Variant<T>>

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

Converts to this type from the input type.

impl<T> Hash for Signed<T>

where T: RlpEcdsaDecodableTx + Hash,

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<T: RlpEcdsaEncodableTx + PartialEq> PartialEq for Signed<T>

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<T> Serialize for Signed<T>

where T: Clone + RlpEcdsaEncodableTx + Serialize,

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: Encodable7594> TryFrom<Signed<TxEip4844Variant<T>>> for EthereumTxEnvelope<TxEip4844WithSidecar<T>>

type Error = ValueError<Signed<TxEip4844Variant<T>>>

The type returned in the event of a conversion error.

fn try_from(value: Signed<TxEip4844Variant<T>>) -> Result<Self, Self::Error>

Performs the conversion.

impl<T> Typed2718 for Signed<T>

where T: RlpEcdsaEncodableTx + Send + Sync + Typed2718,

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<T: RlpEcdsaEncodableTx + PartialEq> Eq for Signed<T>