Struct web3_signature::Signature

pub struct Signature {
    pub r: U256,
    pub s: U256,
    pub v: u64,
}

An ECDSA signature with a recovery identifier.

The recovery identifier may be normalized, in Electrum notation or have EIP155 chain replay protection applied.

Fields

r: U256

R value

s: U256

S value

v: u64

V value for the recovery identifier

Implementations

impl Signature

pub fn new_normalized(r: U256, s: U256, v: u64) -> Self

Create a signature with normalized recovery identifier.

pub fn new_electrum(r: U256, s: U256, v: u64) -> Self

Create a signature with electrum recovery identifier.

pub fn new_eip155(r: U256, s: U256, v: u64) -> Self

Create a signature with EIP155 chain replay protection.

pub fn is_normalized(&self) -> bool

Is the recovery identifier for this signature in the normalized form (0 or 1).

pub fn is_electrum(&self) -> bool

Is the recovery identifier for this signature in the electrum form (27 or 28).

pub fn is_eip155(&self) -> bool

Is the recovery identifier for this signature in the EIP155 form.

pub fn normalize(self) -> Self

Converts this signature into normalized form from an Electrum signature.

Panics if this signature is not in Electrum format.

pub fn normalize_eip155(self, chain_id: u64) -> Self

Converts this signature into normalized form from an EIP155 signature.

Panics if the signature could not be safely normalized for example if a chain_id was supplied that would cause the existing v value to become negative.

pub fn into_electrum(self) -> Self

Converts this signature into Electrum form.

Panics if this signature is not in it’s normalized form.

pub fn into_eip155(self, chain_id: u64) -> Self

Converts this signature applying EIP155 chain replay protection.

Panics if this signature is not in it’s normalized form.

pub fn to_bytes(&self) -> [u8; 65]

Get the bytes for the r, s and v values.

Panics if this signature is not normalized.

Trait Implementations

impl Clone for Signature

fn clone(&self) -> Signature

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Signature

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

Formats the value using the given formatter.

impl Default for Signature

fn default() -> Signature

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Signature

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<[u8; 65]> for Signature

fn from(value: [u8; 65]) -> Self

Converts to this type from the input type.

impl FromStr for Signature

type Err = SignatureError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq<Signature> for Signature

fn eq(&self, other: &Signature) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Signature

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

Serialize this value into the given Serde serializer.

impl<'a> TryFrom<&'a [u8]> for Signature

fn try_from(bytes: &'a [u8]) -> Result<Self, Self::Error>

Parses a raw signature which is expected to be 65 bytes long where the first 32 bytes is the r value, the second 32 bytes the s value and the final byte is the v value in ‘Electrum’ notation.

type Error = SignatureError

The type returned in the event of a conversion error.

impl Copy for Signature

impl Eq for Signature

impl StructuralEq for Signature

impl StructuralPartialEq for Signature