Struct sequoia_openpgp::packet::key::Key4

pub struct Key4<P, R> where
    P: KeyParts,
    R: KeyRole,  { /* fields omitted */ }

Holds a public key, public subkey, private key or private subkey packet.

Use Key4::generate_rsa or Key4::generate_ecc to create a new key.

Existing key material can be turned into an OpenPGP key using Key4::new, Key4::with_secret, Key4::import_public_cv25519, Key4::import_public_ed25519, Key4::import_public_rsa, Key4::import_secret_cv25519, Key4::import_secret_ed25519, and Key4::import_secret_rsa.

Whether you create a new key or import existing key material, you still need to create a binding signature, and, for signing keys, a back signature before integrating the key into a certificate.

Normally, you won’t directly use Key4, but Key, which is a relatively thin wrapper around Key4.

See Section 5.5 of RFC 4880 and the documentation for Key for more details.

Implementations

impl<R> Key4<SecretParts, R> where
    R: KeyRole, 

pub fn import_secret_cv25519<H, S, T>(
    private_key: &[u8],
    hash: H,
    sym: S,
    ctime: T
) -> Result<Self> where
    H: Into<Option<HashAlgorithm>>,
    S: Into<Option<SymmetricAlgorithm>>,
    T: Into<Option<SystemTime>>, 

Creates a new OpenPGP secret key packet for an existing X25519 key.

The ECDH key will use hash algorithm hash and symmetric algorithm sym. If one or both are None secure defaults will be used. The key will have it’s creation date set to ctime or the current time if None is given.

pub fn import_secret_ed25519<T>(private_key: &[u8], ctime: T) -> Result<Self> where
    T: Into<Option<SystemTime>>, 

Creates a new OpenPGP secret key packet for an existing Ed25519 key.

The ECDH key will use hash algorithm hash and symmetric algorithm sym. If one or both are None secure defaults will be used. The key will have it’s creation date set to ctime or the current time if None is given.

pub fn import_secret_rsa<T>(
    d: &[u8],
    p: &[u8],
    q: &[u8],
    ctime: T
) -> Result<Self> where
    T: Into<Option<SystemTime>>, 

Creates a new OpenPGP public key packet for an existing RSA key.

The RSA key will use public exponent e and modulo n. The key will have it’s creation date set to ctime or the current time if None is given.

pub fn generate_rsa(bits: usize) -> Result<Self>

Generates a new RSA key with a public modulos of size bits.

pub fn generate_ecc(for_signing: bool, curve: Curve) -> Result<Self>

Generates a new ECC key over curve.

If for_signing is false a ECDH key, if it’s true either a EdDSA or ECDSA key is generated. Giving for_signing == true and curve == Cv25519 will produce an error. Likewise for_signing == false and curve == Ed25519 will produce an error.

impl<P, R> Key4<P, R> where
    P: KeyParts,
    R: KeyRole, 

pub fn parts_into_public(self) -> Key4<PublicParts, R>

Changes the key’s parts tag to PublicParts.

pub fn parts_as_public(&self) -> &Key4<PublicParts, R>

Changes the key’s parts tag to PublicParts.

pub fn parts_into_secret(self) -> Result<Key4<SecretParts, R>>

Changes the key’s parts tag to SecretParts.

pub fn parts_as_secret(&self) -> Result<&Key4<SecretParts, R>>

Changes the key’s parts tag to SecretParts.

pub fn parts_into_unspecified(self) -> Key4<UnspecifiedParts, R>

Changes the key’s parts tag to UnspecifiedParts.

pub fn parts_as_unspecified(&self) -> &Key4<UnspecifiedParts, R>

Changes the key’s parts tag to UnspecifiedParts.

impl<P, R> Key4<P, R> where
    P: KeyParts,
    R: KeyRole, 

pub fn role_into_primary(self) -> Key4<P, PrimaryRole>

Changes the key’s role tag to PrimaryRole.

pub fn role_as_primary(&self) -> &Key4<P, PrimaryRole>

Changes the key’s role tag to PrimaryRole.

pub fn role_into_subordinate(self) -> Key4<P, SubordinateRole>

Changes the key’s role tag to SubordinateRole.

pub fn role_as_subordinate(&self) -> &Key4<P, SubordinateRole>

Changes the key’s role tag to SubordinateRole.

pub fn role_into_unspecified(self) -> Key4<P, UnspecifiedRole>

Changes the key’s role tag to UnspecifiedRole.

pub fn role_as_unspecified(&self) -> &Key4<P, UnspecifiedRole>

Changes the key’s role tag to UnspecifiedRole.

impl<P, R> Key4<P, R> where
    P: KeyParts,
    R: KeyRole, 

pub fn hash_algo_security(&self) -> HashAlgoSecurity

The security requirements of the hash algorithm for self-signatures.

A cryptographic hash algorithm usually has three security properties: pre-image resistance, second pre-image resistance, and collision resistance. If an attacker can influence the signed data, then the hash algorithm needs to have both second pre-image resistance, and collision resistance. If not, second pre-image resistance is sufficient.

In general, an attacker may be able to influence third-party signatures. But direct key signatures, and binding signatures are only over data fully determined by signer. And, an attacker’s control over self signatures over User IDs is limited due to their structure.

These observations can be used to extend the life of a hash algorithm after its collision resistance has been partially compromised, but not completely broken. For more details, please refer to the documentation for HashAlgoSecurity.

pub fn public_cmp<PB, RB>(&self, b: &Key4<PB, RB>) -> Ordering where
    PB: KeyParts,
    RB: KeyRole, 

Compares the public bits of two keys.

This returns Ordering::Equal if the public MPIs, creation time, and algorithm of the two Key4s match. This does not consider the packets’ encodings, packets’ tags or their secret key material.

pub fn public_eq<PB, RB>(&self, b: &Key4<PB, RB>) -> bool where
    PB: KeyParts,
    RB: KeyRole, 

Tests whether two keys are equal modulo their secret key material.

This returns true if the public MPIs, creation time and algorithm of the two Key4s match. This does not consider the packets’ encodings, packets’ tags or their secret key material.

pub fn public_hash<H>(&self, state: &mut H) where
    H: Hasher, 

Hashes everything but any secret key material into state.

This is an alternate implementation of Hash, which never hashes the secret key material.

impl<R> Key4<PublicParts, R> where
    R: KeyRole, 

pub fn new<T>(
    creation_time: T,
    pk_algo: PublicKeyAlgorithm,
    mpis: PublicKey
) -> Result<Self> where
    T: Into<SystemTime>, 

Creates an OpenPGP public key from the specified key material.

pub fn import_public_cv25519<H, S, T>(
    public_key: &[u8],
    hash: H,
    sym: S,
    ctime: T
) -> Result<Self> where
    H: Into<Option<HashAlgorithm>>,
    S: Into<Option<SymmetricAlgorithm>>,
    T: Into<Option<SystemTime>>, 

Creates an OpenPGP public key packet from existing X25519 key material.

The ECDH key will use hash algorithm hash and symmetric algorithm sym. If one or both are None secure defaults will be used. The key will have its creation date set to ctime or the current time if None is given.

pub fn import_public_ed25519<T>(public_key: &[u8], ctime: T) -> Result<Self> where
    T: Into<Option<SystemTime>>, 

Creates an OpenPGP public key packet from existing Ed25519 key material.

The ECDH key will use hash algorithm hash and symmetric algorithm sym. If one or both are None secure defaults will be used. The key will have its creation date set to ctime or the current time if None is given.

pub fn import_public_rsa<T>(e: &[u8], n: &[u8], ctime: T) -> Result<Self> where
    T: Into<Option<SystemTime>>, 

Creates an OpenPGP public key packet from existing RSA key material.

The RSA key will use the public exponent e and the modulo n. The key will have its creation date set to ctime or the current time if None is given.

impl<R> Key4<SecretParts, R> where
    R: KeyRole, 

pub fn with_secret<T>(
    creation_time: T,
    pk_algo: PublicKeyAlgorithm,
    mpis: PublicKey,
    secret: SecretKeyMaterial
) -> Result<Self> where
    T: Into<SystemTime>, 

Creates an OpenPGP key packet from the specified secret key material.

impl<P, R> Key4<P, R> where
    P: KeyParts,
    R: KeyRole, 

pub fn creation_time(&self) -> SystemTime

Gets the Key’s creation time.

pub fn set_creation_time<T>(&mut self, timestamp: T) -> Result<SystemTime> where
    T: Into<SystemTime>, 

Sets the Key’s creation time.

timestamp is converted to OpenPGP’s internal format, Timestamp: a 32-bit quantity containing the number of seconds since the Unix epoch.

timestamp is silently rounded to match the internal resolution. An error is returned if timestamp is out of range.

pub fn pk_algo(&self) -> PublicKeyAlgorithm

Gets the public key algorithm.

pub fn set_pk_algo(&mut self, pk_algo: PublicKeyAlgorithm) -> PublicKeyAlgorithm

Sets the public key algorithm.

Returns the old public key algorithm.

pub fn mpis(&self) -> &PublicKey

Returns a reference to the Key’s MPIs.

pub fn mpis_mut(&mut self) -> &mut PublicKey

Returns a mutable reference to the Key’s MPIs.

pub fn set_mpis(&mut self, mpis: PublicKey) -> PublicKey

Sets the Key’s MPIs.

This function returns the old MPIs, if any.

pub fn has_secret(&self) -> bool

Returns whether the Key contains secret key material.

pub fn has_unencrypted_secret(&self) -> bool

Returns whether the Key contains unencrypted secret key material.

This returns false if the Key doesn’t contain any secret key material.

pub fn optional_secret(&self) -> Option<&SecretKeyMaterial>

Returns Key’s secret key material, if any.

pub fn key_handle(&self) -> KeyHandle

Computes and returns the Key’s Fingerprint and returns it as a KeyHandle.

See Section 12.2 of RFC 4880.

pub fn fingerprint(&self) -> Fingerprint

Computes and returns the Key’s Fingerprint.

See Section 12.2 of RFC 4880.

pub fn keyid(&self) -> KeyID

Computes and returns the Key’s Key ID.

See Section 12.2 of RFC 4880.

impl<R> Key4<PublicParts, R> where
    R: KeyRole, 

Secret key material handling.

pub fn take_secret(self) -> (Key4<PublicParts, R>, Option<SecretKeyMaterial>)

Takes the Key’s SecretKeyMaterial, if any.

pub fn add_secret(
    self,
    secret: SecretKeyMaterial
) -> (Key4<SecretParts, R>, Option<SecretKeyMaterial>)

Adds the secret key material to the Key, returning the old secret key material, if any.

impl<R> Key4<UnspecifiedParts, R> where
    R: KeyRole, 

Secret key material handling.

pub fn take_secret(self) -> (Key4<PublicParts, R>, Option<SecretKeyMaterial>)

Takes the Key’s SecretKeyMaterial, if any.

pub fn add_secret(
    self,
    secret: SecretKeyMaterial
) -> (Key4<SecretParts, R>, Option<SecretKeyMaterial>)

Adds the secret key material to the Key, returning the old secret key material, if any.

impl<R> Key4<SecretParts, R> where
    R: KeyRole, 

Secret key handling.

pub fn secret(&self) -> &SecretKeyMaterial

Gets the Key’s SecretKeyMaterial.

pub fn secret_mut(&mut self) -> &mut SecretKeyMaterial

Gets a mutable reference to the Key’s SecretKeyMaterial.

pub fn take_secret(self) -> (Key4<PublicParts, R>, SecretKeyMaterial)

Takes the Key’s SecretKeyMaterial.

pub fn add_secret(
    self,
    secret: SecretKeyMaterial
) -> (Key4<SecretParts, R>, SecretKeyMaterial)

Adds SecretKeyMaterial to the Key.

This function returns the old secret key material, if any.

pub fn decrypt_secret(self, password: &Password) -> Result<Self>

Decrypts the secret key material using password.

In OpenPGP, secret key material can be protected with a password. The password is usually hardened using a KDF.

Refer to the documentation of Key::decrypt_secret for details.

This function returns an error if the secret key material is not encrypted or the password is incorrect.

pub fn encrypt_secret(self, password: &Password) -> Result<Key4<SecretParts, R>>

Encrypts the secret key material using password.

In OpenPGP, secret key material can be protected with a password. The password is usually hardened using a KDF.

Refer to the documentation of Key::encrypt_secret for details.

This returns an error if the secret key material is already encrypted.

impl<R: KeyRole> Key4<SecretParts, R>

pub fn into_keypair(self) -> Result<KeyPair>

Creates a new key pair from a secret Key with an unencrypted secret key.

Errors

Fails if the secret key is encrypted. You can use Key::decrypt_secret to decrypt a key.

Trait Implementations

impl<P: Clone, R: Clone> Clone for Key4<P, R> where
    P: KeyParts,
    R: KeyRole, 

fn clone(&self) -> Key4<P, R>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<P, R> Debug for Key4<P, R> where
    P: KeyParts,
    R: KeyRole, 

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

Formats the value using the given formatter.

impl<P, R> Display for Key4<P, R> where
    P: KeyParts,
    R: KeyRole, 

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

Formats the value using the given formatter.

impl<P> From<&'_ Key4<P, PrimaryRole>> for &Key4<P, SubordinateRole> where
    P: KeyParts, 

fn from(p: &Key4<P, PrimaryRole>) -> Self

Performs the conversion.

impl<P> From<&'_ Key4<P, PrimaryRole>> for &Key4<P, UnspecifiedRole> where
    P: KeyParts, 

fn from(p: &Key4<P, PrimaryRole>) -> Self

Performs the conversion.

impl<P> From<&'_ Key4<P, SubordinateRole>> for &Key4<P, PrimaryRole> where
    P: KeyParts, 

fn from(p: &Key4<P, SubordinateRole>) -> Self

Performs the conversion.

impl<P> From<&'_ Key4<P, SubordinateRole>> for &Key4<P, UnspecifiedRole> where
    P: KeyParts, 

fn from(p: &Key4<P, SubordinateRole>) -> Self

Performs the conversion.

impl<P> From<&'_ Key4<P, UnspecifiedRole>> for &Key4<P, PrimaryRole> where
    P: KeyParts, 

fn from(p: &Key4<P, UnspecifiedRole>) -> Self

Performs the conversion.

impl<P> From<&'_ Key4<P, UnspecifiedRole>> for &Key4<P, SubordinateRole> where
    P: KeyParts, 

fn from(p: &Key4<P, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<PublicParts, PrimaryRole>> for &Key4<SecretParts, SubordinateRole>

fn from(p: &Key4<PublicParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<PublicParts, PrimaryRole>> for &Key4<SecretParts, UnspecifiedRole>

fn from(p: &Key4<PublicParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<PublicParts, PrimaryRole>> for &Key4<UnspecifiedParts, SubordinateRole>

fn from(p: &Key4<PublicParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<PublicParts, PrimaryRole>> for &Key4<UnspecifiedParts, UnspecifiedRole>

fn from(p: &Key4<PublicParts, PrimaryRole>) -> Self

Performs the conversion.

impl<R> From<&'_ Key4<PublicParts, R>> for &Key4<UnspecifiedParts, R> where
    R: KeyRole, 

fn from(p: &Key4<PublicParts, R>) -> Self

Performs the conversion.

impl From<&'_ Key4<PublicParts, SubordinateRole>> for &Key4<SecretParts, PrimaryRole>

fn from(p: &Key4<PublicParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<PublicParts, SubordinateRole>> for &Key4<SecretParts, UnspecifiedRole>

fn from(p: &Key4<PublicParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<PublicParts, SubordinateRole>> for &Key4<UnspecifiedParts, PrimaryRole>

fn from(p: &Key4<PublicParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<PublicParts, SubordinateRole>> for &Key4<UnspecifiedParts, UnspecifiedRole>

fn from(p: &Key4<PublicParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<PublicParts, UnspecifiedRole>> for &Key4<SecretParts, PrimaryRole>

fn from(p: &Key4<PublicParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<PublicParts, UnspecifiedRole>> for &Key4<SecretParts, SubordinateRole>

fn from(p: &Key4<PublicParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<PublicParts, UnspecifiedRole>> for &Key4<UnspecifiedParts, PrimaryRole>

fn from(p: &Key4<PublicParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<PublicParts, UnspecifiedRole>> for &Key4<UnspecifiedParts, SubordinateRole>

fn from(p: &Key4<PublicParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<SecretParts, PrimaryRole>> for &Key4<PublicParts, SubordinateRole>

fn from(p: &Key4<SecretParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<SecretParts, PrimaryRole>> for &Key4<PublicParts, UnspecifiedRole>

fn from(p: &Key4<SecretParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<SecretParts, PrimaryRole>> for &Key4<UnspecifiedParts, SubordinateRole>

fn from(p: &Key4<SecretParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<SecretParts, PrimaryRole>> for &Key4<UnspecifiedParts, UnspecifiedRole>

fn from(p: &Key4<SecretParts, PrimaryRole>) -> Self

Performs the conversion.

impl<R> From<&'_ Key4<SecretParts, R>> for &Key4<PublicParts, R> where
    R: KeyRole, 

fn from(p: &Key4<SecretParts, R>) -> Self

Performs the conversion.

impl<R> From<&'_ Key4<SecretParts, R>> for &Key4<UnspecifiedParts, R> where
    R: KeyRole, 

fn from(p: &Key4<SecretParts, R>) -> Self

Performs the conversion.

impl From<&'_ Key4<SecretParts, SubordinateRole>> for &Key4<PublicParts, PrimaryRole>

fn from(p: &Key4<SecretParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<SecretParts, SubordinateRole>> for &Key4<PublicParts, UnspecifiedRole>

fn from(p: &Key4<SecretParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<SecretParts, SubordinateRole>> for &Key4<UnspecifiedParts, PrimaryRole>

fn from(p: &Key4<SecretParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<SecretParts, SubordinateRole>> for &Key4<UnspecifiedParts, UnspecifiedRole>

fn from(p: &Key4<SecretParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<SecretParts, UnspecifiedRole>> for &Key4<PublicParts, PrimaryRole>

fn from(p: &Key4<SecretParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<SecretParts, UnspecifiedRole>> for &Key4<PublicParts, SubordinateRole>

fn from(p: &Key4<SecretParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<SecretParts, UnspecifiedRole>> for &Key4<UnspecifiedParts, PrimaryRole>

fn from(p: &Key4<SecretParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<SecretParts, UnspecifiedRole>> for &Key4<UnspecifiedParts, SubordinateRole>

fn from(p: &Key4<SecretParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<UnspecifiedParts, PrimaryRole>> for &Key4<PublicParts, SubordinateRole>

fn from(p: &Key4<UnspecifiedParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<UnspecifiedParts, PrimaryRole>> for &Key4<PublicParts, UnspecifiedRole>

fn from(p: &Key4<UnspecifiedParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<UnspecifiedParts, PrimaryRole>> for &Key4<SecretParts, SubordinateRole>

fn from(p: &Key4<UnspecifiedParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<UnspecifiedParts, PrimaryRole>> for &Key4<SecretParts, UnspecifiedRole>

fn from(p: &Key4<UnspecifiedParts, PrimaryRole>) -> Self

Performs the conversion.

impl<R> From<&'_ Key4<UnspecifiedParts, R>> for &Key4<PublicParts, R> where
    R: KeyRole, 

fn from(p: &Key4<UnspecifiedParts, R>) -> Self

Performs the conversion.

impl From<&'_ Key4<UnspecifiedParts, SubordinateRole>> for &Key4<PublicParts, PrimaryRole>

fn from(p: &Key4<UnspecifiedParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<UnspecifiedParts, SubordinateRole>> for &Key4<PublicParts, UnspecifiedRole>

fn from(p: &Key4<UnspecifiedParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<UnspecifiedParts, SubordinateRole>> for &Key4<SecretParts, PrimaryRole>

fn from(p: &Key4<UnspecifiedParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<UnspecifiedParts, SubordinateRole>> for &Key4<SecretParts, UnspecifiedRole>

fn from(p: &Key4<UnspecifiedParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<UnspecifiedParts, UnspecifiedRole>> for &Key4<PublicParts, PrimaryRole>

fn from(p: &Key4<UnspecifiedParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<UnspecifiedParts, UnspecifiedRole>> for &Key4<PublicParts, SubordinateRole>

fn from(p: &Key4<UnspecifiedParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<UnspecifiedParts, UnspecifiedRole>> for &Key4<SecretParts, PrimaryRole>

fn from(p: &Key4<UnspecifiedParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<&'_ Key4<UnspecifiedParts, UnspecifiedRole>> for &Key4<SecretParts, SubordinateRole>

fn from(p: &Key4<UnspecifiedParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl<P> From<Key4<P, PrimaryRole>> for Key4<P, SubordinateRole> where
    P: KeyParts, 

fn from(p: Key4<P, PrimaryRole>) -> Self

Performs the conversion.

impl<P> From<Key4<P, PrimaryRole>> for Key4<P, UnspecifiedRole> where
    P: KeyParts, 

fn from(p: Key4<P, PrimaryRole>) -> Self

Performs the conversion.

impl<P, R> From<Key4<P, R>> for Key<P, R> where
    P: KeyParts,
    R: KeyRole, 

fn from(p: Key4<P, R>) -> Self

Performs the conversion.

impl<P> From<Key4<P, SubordinateRole>> for Key4<P, PrimaryRole> where
    P: KeyParts, 

fn from(p: Key4<P, SubordinateRole>) -> Self

Performs the conversion.

impl<P> From<Key4<P, SubordinateRole>> for Key4<P, UnspecifiedRole> where
    P: KeyParts, 

fn from(p: Key4<P, SubordinateRole>) -> Self

Performs the conversion.

impl<P> From<Key4<P, UnspecifiedRole>> for Key4<P, PrimaryRole> where
    P: KeyParts, 

fn from(p: Key4<P, UnspecifiedRole>) -> Self

Performs the conversion.

impl<P> From<Key4<P, UnspecifiedRole>> for Key4<P, SubordinateRole> where
    P: KeyParts, 

fn from(p: Key4<P, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<Key4<PublicParts, PrimaryRole>> for Key4<SecretParts, SubordinateRole>

fn from(p: Key4<PublicParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<Key4<PublicParts, PrimaryRole>> for Key4<SecretParts, UnspecifiedRole>

fn from(p: Key4<PublicParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<Key4<PublicParts, PrimaryRole>> for Key4<UnspecifiedParts, SubordinateRole>

fn from(p: Key4<PublicParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<Key4<PublicParts, PrimaryRole>> for Key4<UnspecifiedParts, UnspecifiedRole>

fn from(p: Key4<PublicParts, PrimaryRole>) -> Self

Performs the conversion.

impl<R> From<Key4<PublicParts, R>> for Key4<UnspecifiedParts, R> where
    R: KeyRole, 

fn from(p: Key4<PublicParts, R>) -> Self

Performs the conversion.

impl From<Key4<PublicParts, SubordinateRole>> for Key4<SecretParts, PrimaryRole>

fn from(p: Key4<PublicParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<Key4<PublicParts, SubordinateRole>> for Key4<SecretParts, UnspecifiedRole>

fn from(p: Key4<PublicParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<Key4<PublicParts, SubordinateRole>> for Key4<UnspecifiedParts, PrimaryRole>

fn from(p: Key4<PublicParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<Key4<PublicParts, SubordinateRole>> for Key4<UnspecifiedParts, UnspecifiedRole>

fn from(p: Key4<PublicParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<Key4<PublicParts, UnspecifiedRole>> for Key4<SecretParts, PrimaryRole>

fn from(p: Key4<PublicParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<Key4<PublicParts, UnspecifiedRole>> for Key4<SecretParts, SubordinateRole>

fn from(p: Key4<PublicParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<Key4<PublicParts, UnspecifiedRole>> for Key4<UnspecifiedParts, PrimaryRole>

fn from(p: Key4<PublicParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<Key4<PublicParts, UnspecifiedRole>> for Key4<UnspecifiedParts, SubordinateRole>

fn from(p: Key4<PublicParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<Key4<SecretParts, PrimaryRole>> for Key4<PublicParts, SubordinateRole>

fn from(p: Key4<SecretParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<Key4<SecretParts, PrimaryRole>> for Key4<PublicParts, UnspecifiedRole>

fn from(p: Key4<SecretParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<Key4<SecretParts, PrimaryRole>> for Key4<UnspecifiedParts, SubordinateRole>

fn from(p: Key4<SecretParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<Key4<SecretParts, PrimaryRole>> for Key4<UnspecifiedParts, UnspecifiedRole>

fn from(p: Key4<SecretParts, PrimaryRole>) -> Self

Performs the conversion.

impl<R> From<Key4<SecretParts, R>> for Key4<PublicParts, R> where
    R: KeyRole, 

fn from(p: Key4<SecretParts, R>) -> Self

Performs the conversion.

impl<R> From<Key4<SecretParts, R>> for Key4<UnspecifiedParts, R> where
    R: KeyRole, 

fn from(p: Key4<SecretParts, R>) -> Self

Performs the conversion.

impl From<Key4<SecretParts, SubordinateRole>> for Key4<PublicParts, PrimaryRole>

fn from(p: Key4<SecretParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<Key4<SecretParts, SubordinateRole>> for Key4<PublicParts, UnspecifiedRole>

fn from(p: Key4<SecretParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<Key4<SecretParts, SubordinateRole>> for Key4<UnspecifiedParts, PrimaryRole>

fn from(p: Key4<SecretParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<Key4<SecretParts, SubordinateRole>> for Key4<UnspecifiedParts, UnspecifiedRole>

fn from(p: Key4<SecretParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<Key4<SecretParts, UnspecifiedRole>> for Key4<PublicParts, PrimaryRole>

fn from(p: Key4<SecretParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<Key4<SecretParts, UnspecifiedRole>> for Key4<PublicParts, SubordinateRole>

fn from(p: Key4<SecretParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<Key4<SecretParts, UnspecifiedRole>> for Key4<UnspecifiedParts, PrimaryRole>

fn from(p: Key4<SecretParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<Key4<SecretParts, UnspecifiedRole>> for Key4<UnspecifiedParts, SubordinateRole>

fn from(p: Key4<SecretParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<Key4<UnspecifiedParts, PrimaryRole>> for Key4<PublicParts, SubordinateRole>

fn from(p: Key4<UnspecifiedParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<Key4<UnspecifiedParts, PrimaryRole>> for Key4<PublicParts, UnspecifiedRole>

fn from(p: Key4<UnspecifiedParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<Key4<UnspecifiedParts, PrimaryRole>> for Key4<SecretParts, SubordinateRole>

fn from(p: Key4<UnspecifiedParts, PrimaryRole>) -> Self

Performs the conversion.

impl From<Key4<UnspecifiedParts, PrimaryRole>> for Key4<SecretParts, UnspecifiedRole>

fn from(p: Key4<UnspecifiedParts, PrimaryRole>) -> Self

Performs the conversion.

impl<R> From<Key4<UnspecifiedParts, R>> for Key4<PublicParts, R> where
    R: KeyRole, 

fn from(p: Key4<UnspecifiedParts, R>) -> Self

Performs the conversion.

impl From<Key4<UnspecifiedParts, SubordinateRole>> for Key4<PublicParts, PrimaryRole>

fn from(p: Key4<UnspecifiedParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<Key4<UnspecifiedParts, SubordinateRole>> for Key4<PublicParts, UnspecifiedRole>

fn from(p: Key4<UnspecifiedParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<Key4<UnspecifiedParts, SubordinateRole>> for Key4<SecretParts, PrimaryRole>

fn from(p: Key4<UnspecifiedParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<Key4<UnspecifiedParts, SubordinateRole>> for Key4<SecretParts, UnspecifiedRole>

fn from(p: Key4<UnspecifiedParts, SubordinateRole>) -> Self

Performs the conversion.

impl From<Key4<UnspecifiedParts, UnspecifiedRole>> for Key4<PublicParts, PrimaryRole>

fn from(p: Key4<UnspecifiedParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<Key4<UnspecifiedParts, UnspecifiedRole>> for Key4<PublicParts, SubordinateRole>

fn from(p: Key4<UnspecifiedParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<Key4<UnspecifiedParts, UnspecifiedRole>> for Key4<SecretParts, PrimaryRole>

fn from(p: Key4<UnspecifiedParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl From<Key4<UnspecifiedParts, UnspecifiedRole>> for Key4<SecretParts, SubordinateRole>

fn from(p: Key4<UnspecifiedParts, UnspecifiedRole>) -> Self

Performs the conversion.

impl<P, R> Hash for Key4<P, R> where
    P: KeyParts,
    R: KeyRole, 

fn hash(&self, hash: &mut dyn Digest)

Updates the given hash with this object.

impl<P: KeyParts, R: KeyRole> Hash for Key4<P, R>

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, 

Feeds a slice of this type into the given Hasher.

impl<P, R> Marshal for Key4<P, R> where
    P: KeyParts,
    R: KeyRole, 

fn serialize(&self, o: &mut dyn Write) -> Result<()>

Writes a serialized version of the object to o.

fn export(&self, o: &mut dyn Write) -> Result<()>

Exports a serialized version of the object to o.

impl<P, R> MarshalInto for Key4<P, R> where
    P: KeyParts,
    R: KeyRole, 

fn serialized_len(&self) -> usize

Computes the maximal length of the serialized representation.

fn serialize_into(&self, buf: &mut [u8]) -> Result<usize>

Serializes into the given buffer.

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

Serializes the packet to a vector.

fn export_into(&self, buf: &mut [u8]) -> Result<usize>

Exports into the given buffer.

fn export_to_vec(&self) -> Result<Vec<u8>>

Exports to a vector.

impl<P: KeyParts, R: KeyRole> PartialEq<Key4<P, R>> for Key4<P, R>

fn eq(&self, other: &Key4<P, R>) -> bool

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

#[must_use]

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

This method tests for !=.

impl<R> TryFrom<&'_ Key4<PublicParts, R>> for &Key4<SecretParts, R> where
    R: KeyRole, 

type Error = Error

The type returned in the event of a conversion error.

fn try_from(p: &Key4<PublicParts, R>) -> Result<Self>

Performs the conversion.

impl<R> TryFrom<&'_ Key4<UnspecifiedParts, R>> for &Key4<SecretParts, R> where
    R: KeyRole, 

type Error = Error

The type returned in the event of a conversion error.

fn try_from(p: &Key4<UnspecifiedParts, R>) -> Result<Self>

Performs the conversion.

impl<R> TryFrom<Key4<PublicParts, R>> for Key4<SecretParts, R> where
    R: KeyRole, 

type Error = Error

The type returned in the event of a conversion error.

fn try_from(p: Key4<PublicParts, R>) -> Result<Self>

Performs the conversion.

impl<R> TryFrom<Key4<UnspecifiedParts, R>> for Key4<SecretParts, R> where
    R: KeyRole, 

type Error = Error

The type returned in the event of a conversion error.

fn try_from(p: Key4<UnspecifiedParts, R>) -> Result<Self>

Performs the conversion.

impl<P: KeyParts, R: KeyRole> Eq for Key4<P, R>