Struct Signature 

pub struct Signature<C>
where
    C: EcdsaCurve,
    MaxSize<C>: ArraySize,
    <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,
{
    bytes: Array<u8, MaxSize<C>>,
    r_range: Range<usize>,
    s_range: Range<usize>,
}

ASN.1 DER-encoded signature as specified in RFC5912 Section 6:

ECDSA-Sig-Value ::= SEQUENCE {
  r  INTEGER,
  s  INTEGER
}

Fields

bytes: Array<u8, MaxSize<C>>

ASN.1 DER-encoded signature data

r_range: Range<usize>

Range of the r value within the signature

s_range: Range<usize>

Range of the s value within the signature

Implementations

impl<C> Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

pub fn from_bytes(input: &[u8]) -> Result<Self>

Parse signature from DER-encoded bytes.

pub(crate) fn from_components(r: &[u8], s: &[u8]) -> Result<Self>

Create an ASN.1 DER encoded signature from big endian r and s scalar components.

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

Borrow this signature as a byte slice

pub fn to_bytes(&self) -> Box<[u8]>

Serialize this signature as a boxed byte slice

pub fn len(&self) -> usize

Get the length of the signature in bytes

pub(crate) fn r(&self) -> &[u8]

Get the r component of the signature (leading zeros removed)

pub(crate) fn s(&self) -> &[u8]

Get the s component of the signature (leading zeros removed)

Trait Implementations

impl<C> AsRef<[u8]> for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

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

Converts this type into a shared reference of the (usually inferred) input type.

impl<C> Clone for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C> Debug for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

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

Formats the value using the given formatter.

impl<'a, C> Decode<'a> for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

type Error = Error

Type returned in the event of a decoding error.

fn decode<R: Reader<'a>>(reader: &mut R) -> Result<Self>

Attempt to decode this TLV message using the provided decoder.

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

Parse Self from the provided DER-encoded byte slice.

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

Parse Self from the provided DER-encoded byte slice.

impl<D, C> DigestSigner<D, Signature<C>> for SigningKey<C>

where C: EcdsaCurve + CurveArithmetic + DigestAlgorithm, D: Digest + FixedOutput, Scalar<C>: Invert<Output = CtOption<Scalar<C>>>, SignatureSize<C>: ArraySize, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate feature der only.

fn try_sign_digest<F: Fn(&mut D) -> Result<()>>( &self, f: F, ) -> Result<Signature<C>>

Attempt to sign a message by updating the received Digest with it, returning a digital signature on success, or an error if something went wrong.

fn sign_digest<F>(&self, f: F) -> S

where F: Fn(&mut D),

Sign a message by updating the received Digest with it, returning a signature.

impl<C, D> DigestVerifier<D, Signature<C>> for VerifyingKey<C>

where C: EcdsaCurve + CurveArithmetic, D: Digest + Update, SignatureSize<C>: ArraySize, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate feature der only.

fn verify_digest<F: Fn(&mut D) -> Result<()>>( &self, f: F, signature: &Signature<C>, ) -> Result<()>

Verify the signature against the received Digest output, by updating it with the message.

impl<C> Encode for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

fn encoded_len(&self) -> Result<Length>

Compute the length of this TLV object in bytes when encoded as ASN.1 DER.

fn encode(&self, writer: &mut impl Writer) -> Result<()>

Encode this TLV object as ASN.1 DER using the provided Writer.

fn encode_to_slice<'a>(&self, buf: &'a mut [u8]) -> Result<&'a [u8], Error>

Encode this TLV object to the provided byte slice, returning a sub-slice containing the encoded message.

fn encode_to_vec(&self, buf: &mut Vec<u8>) -> Result<Length, Error>

Encode this TLV object as ASN.1 DER, appending it to the provided byte vector.

fn to_der(&self) -> Result<Vec<u8>, Error>

Encode this TLV object as ASN.1 DER, returning a byte vector.

impl<C> FixedTag for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

const TAG: Tag = Tag::Sequence

ASN.1 tag

impl<C> From<&SignatureWithOid<C>> for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate features der and digest only.

fn from(sig: &SignatureWithOid<C>) -> Signature<C>

Converts to this type from the input type.

impl<C> From<Signature<C>> for Box<[u8]>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate feature alloc only.

fn from(signature: Signature<C>) -> Box<[u8]>

Converts to this type from the input type.

impl<C> From<Signature<C>> for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

fn from(sig: Signature<C>) -> Signature<C>

Converts to this type from the input type.

impl<C> From<SignatureWithOid<C>> for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate features der and digest only.

fn from(sig: SignatureWithOid<C>) -> Signature<C>

Converts to this type from the input type.

impl<C> Hash for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

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<C> MultipartVerifier<Signature<C>> for VerifyingKey<C>

where C: EcdsaCurve + CurveArithmetic + DigestAlgorithm, SignatureSize<C>: ArraySize, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate feature der only.

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

Equivalent of Verifier::verify() but the message is provided in non-contiguous byte slices.

impl<C> PrehashSigner<Signature<C>> for SigningKey<C>

where C: EcdsaCurve + CurveArithmetic + DigestAlgorithm, Scalar<C>: Invert<Output = CtOption<Scalar<C>>>, SignatureSize<C>: ArraySize, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate feature der only.

fn sign_prehash(&self, prehash: &[u8]) -> Result<Signature<C>>

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

impl<C> PrehashVerifier<Signature<C>> for VerifyingKey<C>

where C: EcdsaCurve + CurveArithmetic, SignatureSize<C>: ArraySize, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate feature der only.

fn verify_prehash(&self, prehash: &[u8], signature: &Signature<C>) -> Result<()>

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

impl<C, D> RandomizedDigestSigner<D, Signature<C>> for SigningKey<C>

where C: EcdsaCurve + CurveArithmetic + DigestAlgorithm, D: Digest + FixedOutput, Scalar<C>: Invert<Output = CtOption<Scalar<C>>>, SignatureSize<C>: ArraySize, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate feature der only.

fn try_sign_digest_with_rng<R: TryCryptoRng + ?Sized, F: Fn(&mut D) -> Result<()>>( &self, rng: &mut R, f: F, ) -> Result<Signature<C>>

Attempt to sign a message by updating the received Digest with it, returning a digital signature on success, or an error if something went wrong.

fn sign_digest_with_rng<R, F>(&self, rng: &mut R, f: F) -> S

where R: CryptoRng + ?Sized, F: Fn(&mut D),

Sign a message by updating the received Digest with it, returning a signature.

impl<C> RandomizedMultipartSigner<Signature<C>> for SigningKey<C>

where C: EcdsaCurve + CurveArithmetic + DigestAlgorithm, Scalar<C>: Invert<Output = CtOption<Scalar<C>>>, SignatureSize<C>: ArraySize, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate feature der only.

fn try_multipart_sign_with_rng<R: TryCryptoRng + ?Sized>( &self, rng: &mut R, msg: &[&[u8]], ) -> Result<Signature<C>>

Equivalent of RandomizedSigner::try_sign_with_rng() but the message is provided in non-contiguous byte slices.

fn multipart_sign_with_rng<R>(&self, rng: &mut R, msg: &[&[u8]]) -> S

where R: CryptoRng + ?Sized,

Equivalent of RandomizedSigner::sign_with_rng() but the message is provided in non-contiguous byte slices.

impl<C> RandomizedPrehashSigner<Signature<C>> for SigningKey<C>

where C: EcdsaCurve + CurveArithmetic + DigestAlgorithm, Scalar<C>: Invert<Output = CtOption<Scalar<C>>>, SignatureSize<C>: ArraySize, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate feature der only.

fn sign_prehash_with_rng<R: TryCryptoRng + ?Sized>( &self, rng: &mut R, prehash: &[u8], ) -> Result<Signature<C>>

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

impl<C> RandomizedSigner<Signature<C>> for SigningKey<C>

where C: EcdsaCurve + CurveArithmetic + DigestAlgorithm, Scalar<C>: Invert<Output = CtOption<Scalar<C>>>, SignatureSize<C>: ArraySize, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate feature der only.

fn try_sign_with_rng<R: TryCryptoRng + ?Sized>( &self, rng: &mut R, msg: &[u8], ) -> Result<Signature<C>>

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

fn sign_with_rng<R>(&self, rng: &mut R, msg: &[u8]) -> S

where R: CryptoRng + ?Sized,

Sign the given message and return a digital signature

impl<C> SignatureBitStringEncoding for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate feature alloc only.

fn to_bitstring(&self) -> Result<BitString>

BitString encoding for this signature.

impl<C> SignatureEncoding for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate feature alloc only.

type Repr = Box<[u8]>

Byte representation of a signature.

fn to_vec(&self) -> Vec<u8>

Encode signature as a byte vector.

fn to_bytes(&self) -> Self::Repr

Encode signature as its byte representation.

fn encoded_len(&self) -> usize

Get the length of this signature when encoded.

impl<C> Signer<Signature<C>> for SigningKey<C>

where C: EcdsaCurve + CurveArithmetic + DigestAlgorithm, Scalar<C>: Invert<Output = CtOption<Scalar<C>>>, SignatureSize<C>: ArraySize, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate feature der only.

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

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

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

Sign the given message and return a digital signature.

impl<C> TryFrom<&[u8]> for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(input: &[u8]) -> Result<Self>

Performs the conversion.

impl<C> TryFrom<Signature<C>> for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(sig: Signature<C>) -> Result<Signature<C>>

Performs the conversion.

impl<C> Verifier<Signature<C>> for VerifyingKey<C>

where C: EcdsaCurve + CurveArithmetic + DigestAlgorithm, SignatureSize<C>: ArraySize, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate feature der only.

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

Use Self (e.g. a verifying key) to verify that the provided signature is authentic for a given message bytestring.