Struct ethers::signers::yubihsm::ecdsa::secp256k1::recoverable::Signature

pub struct Signature { /* fields omitted */ }

Ethereum-style “recoverable signatures” which allow for the recovery of the signer’s VerifyingKey from the signature itself.

This format consists of Signature followed by a 1-byte recovery Id (65-bytes total):

• r: 32-byte integer, big endian
• s: 32-byte integer, big endian
• v: 1-byte recovery Id

Implementations

impl Signature

pub fn new(
    signature: &Signature<Secp256k1>,
    recovery_id: Id
) -> Result<Signature, Error>

Create a new recoverable ECDSA/secp256k1 signature from a regular fixed-size signature and an associated recovery Id.

This is an “unchecked” conversion and assumes the provided Id is valid for this signature.

pub fn recovery_id(self) -> Id

Get the recovery Id for this signature

pub fn from_trial_recovery(
    public_key: &VerifyingKey,
    msg: &[u8],
    signature: &Signature<Secp256k1>
) -> Result<Signature, Error>

Given a public key, message, and signature, use trial recovery to determine if a suitable recovery ID exists, or return an error otherwise.

Assumes Keccak256 as the message digest function. Use Signature::from_digest_trial_recovery to support other digest functions.

pub fn from_digest_trial_recovery<D>(
    public_key: &VerifyingKey,
    digest: D,
    signature: &Signature<Secp256k1>
) -> Result<Signature, Error> where
    D: Clone + Digest<OutputSize = UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>>, 

Given a public key, message digest, and signature, use trial recovery to determine if a suitable recovery ID exists, or return an error otherwise.

pub fn recover_verify_key(&self, msg: &[u8]) -> Result<VerifyingKey, Error>

Recover the public key used to create the given signature as a VerifyingKey.

pub fn recover_verify_key_from_digest<D>(
    &self,
    msg_digest: D
) -> Result<VerifyingKey, Error> where
    D: Digest<OutputSize = UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>>, 

Recover the public key used to create the given signature as a VerifyingKey from the provided precomputed Digest.

pub fn recover_verify_key_from_digest_bytes(
    &self,
    digest_bytes: &GenericArray<u8, <<Secp256k1 as Curve>::UInt as ArrayEncoding>::ByteSize>
) -> Result<VerifyingKey, Error>

Recover the public key used to create the given signature as a VerifyingKey from the raw bytes of a message digest.

pub fn r(&self) -> NonZeroScalar<Secp256k1>

Parse the r component of this signature to a NonZeroScalar

pub fn s(&self) -> NonZeroScalar<Secp256k1>

Parse the s component of this signature to a NonZeroScalar

Trait Implementations

impl AsRef<[u8]> for Signature

pub fn as_ref(&self) -> &[u8]

Performs the conversion.

impl Clone for Signature

pub 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

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

Formats the value using the given formatter.

impl<D> DigestSigner<D, Signature> for SigningKey where
    D: BlockInput + FixedOutput<OutputSize = UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>> + Clone + Default + Reset + Update, 

pub fn try_sign_digest(&self, digest: D) -> Result<Signature, Error>

Attempt to sign the given prehashed message Digest, returning a digital signature on success, or an error if something went wrong.

fn sign_digest(&self, digest: D) -> S

Sign the given prehashed message Digest, returning a signature.

impl<D> DigestSigner<D, Signature> for XPriv where
    D: BlockInput + FixedOutput<OutputSize = UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>> + Clone + Default + Reset + Update, 

pub fn try_sign_digest(&self, digest: D) -> Result<Signature, Error>

Attempt to sign the given prehashed message Digest, returning a digital signature on success, or an error if something went wrong.

fn sign_digest(&self, digest: D) -> S

Sign the given prehashed message Digest, returning a signature.

impl<D> DigestSigner<D, Signature> for DerivedXPriv where
    D: BlockInput + FixedOutput<OutputSize = UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>> + Clone + Default + Reset + Update, 

pub fn try_sign_digest(&self, digest: D) -> Result<Signature, Error>

Attempt to sign the given prehashed message Digest, returning a digital signature on success, or an error if something went wrong.

fn sign_digest(&self, digest: D) -> S

Sign the given prehashed message Digest, returning a signature.

impl<D> DigestSigner<D, Signature> for Signer<Secp256k1> where
    D: Digest<OutputSize = UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>> + Clone + Default, 

pub fn try_sign_digest(&self, digest: D) -> Result<Signature, Error>

Compute an Ethereum-style ECDSA/secp256k1 signature of the given digest

fn sign_digest(&self, digest: D) -> S

Sign the given prehashed message Digest, returning a signature.

impl<D> DigestVerifier<D, Signature> for VerifyingKey where
    D: Digest<OutputSize = UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>>, 

pub fn verify_digest(
    &self,
    digest: D,
    signature: &Signature
) -> Result<(), Error>

Verify the signature against the given Digest output.

impl<D> DigestVerifier<D, Signature> for DerivedXPub where
    D: Digest<OutputSize = UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>>, 

pub fn verify_digest(
    &self,
    digest: D,
    signature: &Signature
) -> Result<(), Error>

Verify the signature against the given Digest output.

impl<D> DigestVerifier<D, Signature> for DerivedPubkey where
    D: Digest<OutputSize = UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>>, 

pub fn verify_digest(
    &self,
    digest: D,
    signature: &Signature
) -> Result<(), Error>

Verify the signature against the given Digest output.

impl<D> DigestVerifier<D, Signature> for XPub where
    D: Digest<OutputSize = UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>>, 

pub fn verify_digest(
    &self,
    digest: D,
    signature: &Signature
) -> Result<(), Error>

Verify the signature against the given Digest output.

impl From<Signature> for Signature<Secp256k1>

pub fn from(sig: Signature) -> Signature<Secp256k1>

Performs the conversion.

impl PartialEq<Signature> for Signature

pub 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 !=.

impl PrehashSignature for Signature

type Digest = Keccak256

Preferred Digest algorithm to use when computing this signature type.

impl<D> RandomizedDigestSigner<D, Signature> for SigningKey where
    D: BlockInput + FixedOutput<OutputSize = UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>> + Clone + Default + Reset + Update, 

pub fn try_sign_digest_with_rng(
    &self,
    rng: impl CryptoRng + RngCore,
    digest: D
) -> Result<Signature, Error>

Attempt to sign the given prehashed message Digest, returning a digital signature on success, or an error if something went wrong.

fn sign_digest_with_rng(&self, rng: impl CryptoRng + RngCore, digest: D) -> S

Sign the given prehashed message Digest, returning a signature.

impl Signature for Signature

pub fn from_bytes(bytes: &[u8]) -> Result<Signature, Error>

Parse a signature from its byte representation

fn as_bytes(&self) -> &[u8]

Borrow a byte slice representing the serialized form of this signature

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

type Error = Error

The type returned in the event of a conversion error.

pub fn try_from(bytes: &[u8]) -> Result<Signature, Error>

Performs the conversion.

impl Copy for Signature

impl Eq for Signature