Struct SigningKey 

pub struct SigningKey {
    pub(crate) secret: ExpandedSecretKey,
}

Signing key for Ed448

Fields

secret: ExpandedSecretKey

Implementations

impl SigningKey

pub fn to_bytes(&self) -> SecretKey

Serialize this SigningKey as bytes.

pub fn as_bytes(&self) -> &SecretKey

Serialize this SigningKey as a byte reference.

pub fn to_scalar(&self) -> EdwardsScalar

Return the clamped EdwardsScalar for this SigningKey.

This is the scalar that is actually used for signing. Be warned, this is secret material that should be handled with care.

pub fn verifying_key(&self) -> VerifyingKey

Get the VerifyingKey for this SigningKey.

pub fn with_context<'k, 'v>( &'k self, context: &'v [u8], ) -> Context<'k, 'v, Self>

Create a signing context that can be used for Ed448ph with signature::DigestSigner

pub fn sign_raw(&self, message: &[u8]) -> Signature

Sign a message with this SigningKey using the Ed448 algorithm defined in RFC8032 §5.2.

pub fn sign_ctx( &self, context: &[u8], message: &[u8], ) -> Result<Signature, Error>

Sign a message in the given context with this SigningKey using the Ed448ph algorithm defined in RFC8032 §5.2.

pub fn sign_prehashed<D>( &self, context: Option<&[u8]>, prehashed_message: D, ) -> Result<Signature, Error>

where D: PreHash,

Sign a prehashed_message with this SigningKey using the Ed448ph algorithm defined in RFC8032 §5.2.

Trait Implementations

impl Clone for SigningKey

fn clone(&self) -> SigningKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ConstantTimeEq for SigningKey

fn ct_eq(&self, other: &Self) -> Choice

Determine if two items are equal.

fn ct_ne(&self, other: &Self) -> Choice

Determine if two items are NOT equal.

impl Debug for SigningKey

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

Formats the value using the given formatter.

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

where D: Default + FixedOutput + HashMarker + Update,

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

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<D> DigestVerifier<D, Signature> for SigningKey

where D: Default + FixedOutput + HashMarker + Update,

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

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

impl Drop for SigningKey

fn drop(&mut self)

Executes the destructor for this type.

impl DynSignatureAlgorithmIdentifier for SigningKey

Available on crate features alloc and pkcs8 only.

fn signature_algorithm_identifier(&self) -> Result<AlgorithmIdentifierOwned>

AlgorithmIdentifier for the corresponding signature system.

impl EncodePrivateKey for SigningKey

Available on crate features alloc and pkcs8 only.

fn to_pkcs8_der(&self) -> Result<SecretDocument>

Serialize a SecretDocument containing a PKCS#8-encoded private key.

fn to_pkcs8_pem( &self, line_ending: LineEnding, ) -> Result<Zeroizing<String>, Error>

Serialize this private key as PEM-encoded PKCS#8 with the given LineEnding.

fn write_pkcs8_der_file(&self, path: impl AsRef<Path>) -> Result<(), Error>

Write ASN.1 DER-encoded PKCS#8 private key to the given path.

fn write_pkcs8_pem_file( &self, path: impl AsRef<Path>, line_ending: LineEnding, ) -> Result<(), Error>

Write ASN.1 PEM-encoded PKCS#8 private key to the given path.

impl From<&Array<u8, <Ed448 as CurveWithScalar>::ReprSize>> for SigningKey

fn from(secret_scalar: &SecretKey) -> Self

Converts to this type from the input type.

impl From<&SigningKey> for KeypairBytes

Available on crate feature pkcs8 only.

fn from(signing_key: &SigningKey) -> Self

Converts to this type from the input type.

impl From<Array<u8, <Ed448 as CurveWithScalar>::ReprSize>> for SigningKey

fn from(secret_scalar: SecretKey) -> Self

Converts to this type from the input type.

impl Generate for SigningKey

fn try_generate_from_rng<R: TryCryptoRng + ?Sized>( rng: &mut R, ) -> Result<Self, R::Error>

Generate random key using the provided TryCryptoRng.

fn generate_from_rng<R>(rng: &mut R) -> Self

where R: CryptoRng + ?Sized,

Generate random key using the provided CryptoRng.

fn try_generate() -> Result<Self, Error>

Randomly generate a value of this type using the system’s ambient cryptographically secure random number generator.

fn generate() -> Self

Randomly generate a value of this type using the system’s ambient cryptographically secure random number generator.

impl PartialEq for SigningKey

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 PrehashSigner<Signature> for SigningKey

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

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

impl Signer<Signature> for SigningKey

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

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 TryFrom<&[u8]> for SigningKey

type Error = &'static str

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<&KeypairBytes> for SigningKey

Available on crate feature pkcs8 only.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: &KeypairBytes) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Vec<u8>> for SigningKey

Available on crate feature alloc only.

type Error = &'static str

The type returned in the event of a conversion error.

fn try_from(value: &Vec<u8>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Box<[u8]>> for SigningKey

Available on crate feature alloc only.

type Error = &'static str

The type returned in the event of a conversion error.

fn try_from(value: Box<[u8]>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<KeypairBytes> for SigningKey

Available on crate feature pkcs8 only.

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<PrivateKeyInfo<AnyRef<'_>, &OctetStringRef, BitStringRef<'_>>> for SigningKey

Available on crate feature pkcs8 only.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: PrivateKeyInfoRef<'_>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Vec<u8>> for SigningKey

Available on crate feature alloc only.

type Error = &'static str

The type returned in the event of a conversion error.

fn try_from(value: Vec<u8>) -> Result<Self, Self::Error>

Performs the conversion.

impl Verifier<Signature> for SigningKey

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

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

impl Zeroize for SigningKey

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.

impl Eq for SigningKey

impl ZeroizeOnDrop for SigningKey