Struct Signed

pub struct Signed<T, Sig = PrimitiveSignature> { /* 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.

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

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

Available on crate feature k256 only.

Recover the signer of the transaction

pub fn try_into_recovered(self) -> Result<Recovered<T>, SignatureError>

Available on crate feature k256 only.

Attempts to recover signer and constructs a crate::transaction::Recovered object.

Trait Implementations

impl<'a, T: SignableTransaction<PrimitiveSignature> + Arbitrary<'a>> Arbitrary<'a> for Signed<T, PrimitiveSignature>

Available on crate features arbitrary and k256 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<T: Clone, Sig: Clone> Clone for Signed<T, Sig>

fn clone(&self) -> Self

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

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

Available on crate feature serde only.

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

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

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

Converts to this type from the input type.

impl From<Signed<TxEip1559>> for PooledTransaction

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

Converts to this type from the input type.

impl From<Signed<TxEip1559>> for TxEnvelope

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

Converts to this type from the input type.

impl From<Signed<TxEip2930>> for PooledTransaction

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

Converts to this type from the input type.

impl From<Signed<TxEip2930>> for TxEnvelope

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

impl From<Signed<TxEip4844>> for TxEnvelope

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

Converts to this type from the input type.

impl From<Signed<TxEip4844Variant>> for TxEnvelope

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

Converts to this type from the input type.

impl From<Signed<TxEip4844WithSidecar>> for PooledTransaction

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

Converts to this type from the input type.

impl From<Signed<TxEip4844WithSidecar>> for Signed<TxEip4844Variant>

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

Converts to this type from the input type.

impl From<Signed<TxEip4844WithSidecar>> for TxEnvelope

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

Converts to this type from the input type.

impl From<Signed<TxEip7702>> for PooledTransaction

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

Converts to this type from the input type.

impl From<Signed<TxEip7702>> for TxEnvelope

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

Converts to this type from the input type.

impl From<Signed<TxLegacy>> for PooledTransaction

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

Converts to this type from the input type.

impl From<Signed<TxLegacy>> for TxEnvelope

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

Converts to this type from the input type.

impl From<TxEnvelope> for Signed<TypedTransaction>

fn from(value: TxEnvelope) -> Self

Converts to this type from the input type.

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,

Available on crate feature serde only.

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<Signed<TxEip4844Variant>> for PooledTransaction

type Error = ValueError<Signed<TxEip4844Variant>>

The type returned in the event of a conversion error.

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

Performs the conversion.

impl<T: RlpEcdsaEncodableTx + PartialEq> Eq for Signed<T>

Layout

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.