Struct ring_compat::signature::ecdsa::Signature

pub struct Signature<C> where
    C: Curve + Order,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>,  { /* fields omitted */ }

This is supported on crate feature signature only.

ECDSA signature (fixed-size). Generic over elliptic curve types.

Serialized as fixed-sized big endian scalar values with no added framing:

• r: field element size for the given curve, big-endian
• s: field element size for the given curve, big-endian

For example, in a curve with a 256-bit modulus like NIST P-256 or secp256k1, r and s will both be 32-bytes, resulting in a signature with a total of 64-bytes.

ASN.1 DER-encoded signatures also supported via the Signature::from_der and Signature::to_der methods.

Implementations

impl<C> Signature<C> where
    C: Curve + Order,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>, 

pub fn from_scalars(
    r: impl Into<GenericArray<u8, <C as Curve>::FieldSize>>,
    s: impl Into<GenericArray<u8, <C as Curve>::FieldSize>>
) -> Result<Signature<C>, Error>

Create a Signature from the serialized r and s scalar values which comprise the signature.

pub fn from_der(bytes: &[u8]) -> Result<Signature<C>, Error> where
    <C as Curve>::FieldSize: Add<<C as Curve>::FieldSize>,
    <C as Curve>::FieldSize: ArrayLength<u8>,
    <C as Curve>::FieldSize: NonZero,
    <<<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output as Add<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B1>>>::Output: ArrayLength<u8>,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: Add<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B1>>,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>, 

Parse a signature from ASN.1 DER

pub fn to_der(&self) -> Signature<C> where
    <C as Curve>::FieldSize: Add<<C as Curve>::FieldSize>,
    <C as Curve>::FieldSize: ArrayLength<u8>,
    <C as Curve>::FieldSize: NonZero,
    <<<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output as Add<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B1>>>::Output: ArrayLength<u8>,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: Add<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B1>>,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>, 

Serialize this signature as ASN.1 DER

Trait Implementations

impl<C> AsRef<[u8]> for Signature<C> where
    C: Curve + Order,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>, 

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

Performs the conversion.

impl<C> Clone for Signature<C> where
    C: Clone + Curve + Order,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>, 

pub fn clone(&self) -> Signature<C>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C> Copy for Signature<C> where
    C: Curve + Order,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>,
    <<<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output as ArrayLength<u8>>::ArrayType: Copy, 

impl<C> Debug for Signature<C> where
    C: Curve + Order,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>, 

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

Formats the value using the given formatter.

impl<C> Eq for Signature<C> where
    C: Eq + Curve + Order,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>, 

impl<C> PartialEq<Signature<C>> for Signature<C> where
    C: PartialEq<C> + Curve + Order,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>, 

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

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

pub fn ne(&self, other: &Signature<C>) -> bool

This method tests for !=.

impl<C> Signature for Signature<C> where
    C: Curve + Order,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>, 

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

Parse a signature from its byte representation

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

Borrow a byte slice representing the serialized form of this signature

impl<C> Signer<Signature<C>> for SigningKey<C> where
    C: Curve + CurveAlg + Order,
    SignatureSize<C>: ArrayLength<u8>, 

fn try_sign(&self, msg: &[u8]) -> Result<Signature<C>, Error>

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

pub fn sign(&self, msg: &[u8]) -> S

Sign the given message and return a digital signature

impl<C> StructuralEq for Signature<C> where
    C: Curve + Order,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>, 

impl<C> StructuralPartialEq for Signature<C> where
    C: Curve + Order,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>, 

impl<'_, C> TryFrom<&'_ [u8]> for Signature<C> where
    C: Curve + Order,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>, 

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl<C> TryFrom<Signature<C>> for Signature<C> where
    C: Curve + Order,
    <C as Curve>::FieldSize: Add<<C as Curve>::FieldSize>,
    <C as Curve>::FieldSize: ArrayLength<u8>,
    <C as Curve>::FieldSize: NonZero,
    <<<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output as Add<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B1>>>::Output: ArrayLength<u8>,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: Add<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B1>>,
    <<C as Curve>::FieldSize as Add<<C as Curve>::FieldSize>>::Output: ArrayLength<u8>, 

type Error = Error

The type returned in the event of a conversion error.

pub fn try_from(doc: Signature<C>) -> Result<Signature<C>, Error>

Performs the conversion.

impl<C: Curve> Verifier<Signature<C>> for VerifyingKey<C> where
    C: Curve + CurveAlg + Order,
    SignatureSize<C>: ArrayLength<u8>,
    UntaggedPointSize<C>: Add<U1> + ArrayLength<u8>,
    UncompressedPointSize<C>: ArrayLength<u8>, 

fn verify(&self, msg: &[u8], sig: &Signature<C>) -> Result<(), Error>

Use Self to verify that the provided signature for a given message bytestring is authentic.