//! Code for constructing and signing certificates.

//!

//! Only available when the crate is built with the `encode` feature.

use crate::{

    CertEncodeError, CertExt, Ed25519Cert, Ed25519CertConstructor, ExtType, SignedWithEd25519Ext,

    UnrecognizedExt,

};

use std::time::{Duration, SystemTime};

use tor_bytes::{EncodeResult, Writeable, Writer};

use tor_llcrypto::pk::ed25519::{self, Ed25519PublicKey, Ed25519SigningKey};

use derive_more::{AsRef, Deref, Into};

/// An encoded ed25519 certificate,

/// created using [`Ed25519CertConstructor::encode_and_sign`].

///

/// The certificate is encoded in the format specified

/// in Tor's cert-spec.txt.

///

/// This certificate has already been validated.

#[derive(Clone, Debug, PartialEq, Into, AsRef, Deref)]

#[cfg_attr(docsrs, doc(cfg(feature = "encode")))]

pub struct EncodedEd25519Cert(Vec<u8>);

impl Ed25519Cert {

    /// Return a new `Ed25519CertConstructor` to create and return a new signed

    /// `Ed25519Cert`.

}

impl EncodedEd25519Cert {

    /// Create an `EncodedEd25519Cert` from a byte slice.

    ///

    /// **Important**: generally you should not use this function.

    /// Instead, prefer using [`Ed25519CertConstructor::encode_and_sign`]

    /// to encode certificates.

    ///

    /// This function should only be used if `cert`

    /// is known to be the byte representation of a valid `EncodedEd25519Cert`

    /// (for example, after parsing the byte slice using [`Ed25519Cert::decode`],

    /// and validating its signature and timeliness).

    #[cfg(feature = "experimental-api")]

}

impl Writeable for CertExt {

    /// As Writeable::WriteOnto, but may return an error.

    ///

    /// TODO: Migrate Writeable to provide this interface.

        }

}

impl Writeable for SignedWithEd25519Ext {

    /// As Writeable::WriteOnto, but may return an error.

}

impl Writeable for UnrecognizedExt {

    /// As Writeable::WriteOnto, but may return an error.

        );

}

impl Ed25519CertConstructor {

    /// Set the approximate expiration time for this certificate.

    ///

    /// (The time will be rounded forward to the nearest hour after the epoch.)

        /// The number of seconds in an hour.

        const SEC_PER_HOUR: u64 = 3600;

    /// Set the signing key to be included with this certificate.

    ///

    /// This is optional: you don't need to include the signing key at all.  If

    /// you do, it must match the key that you actually use to sign the

    /// certificate.

    /// Remove any signing key previously set on this Ed25519CertConstructor.

    /// Encode a certificate into a new vector, signing the result

    /// with `skey`.

    ///

    /// This function exists in lieu of a `build()` function, since we have a rule that

    /// we don't produce an `Ed25519Cert` except if the certificate is known to be

    /// valid.

        // As long as there is no setter for Ed25519Cert::signed_with, this is unreachable

        );

        }

}

#[cfg(test)]

#[allow(clippy::unwrap_used)]

mod test {

    // @@ begin test lint list maintained by maint/add_warning @@

    #![allow(clippy::bool_assert_comparison)]

    #![allow(clippy::clone_on_copy)]

    #![allow(clippy::dbg_macro)]

    #![allow(clippy::mixed_attributes_style)]

    #![allow(clippy::print_stderr)]

    #![allow(clippy::print_stdout)]

    #![allow(clippy::single_char_pattern)]

    #![allow(clippy::unwrap_used)]

    #![allow(clippy::unchecked_duration_subtraction)]

    #![allow(clippy::useless_vec)]

    #![allow(clippy::needless_pass_by_value)]

    //! <!-- @@ end test lint list maintained by maint/add_warning @@ -->

    use super::*;

    use crate::CertifiedKey;

    use tor_checkable::{SelfSigned, Timebound};

    #[test]

    fn signed_cert_without_key() {

        let mut rng = rand::rng();

        let keypair = ed25519::Keypair::generate(&mut rng);

        let now = SystemTime::now();

        let day = Duration::from_secs(86400);

        let encoded = Ed25519Cert::constructor()

            .expiration(now + day * 30)

            .cert_key(CertifiedKey::Ed25519(keypair.verifying_key().into()))

            .cert_type(7.into())

            .encode_and_sign(&keypair)

            .unwrap();

        let decoded = Ed25519Cert::decode(&encoded).unwrap(); // Well-formed?

        let validated = decoded

            .should_be_signed_with(&keypair.verifying_key().into())

            .unwrap()

            .check_signature()

            .unwrap(); // Well-signed?

        let cert = validated.check_valid_at(&(now + day * 20)).unwrap();

        assert_eq!(cert.cert_type(), 7.into());

        if let CertifiedKey::Ed25519(found) = cert.subject_key() {

            assert_eq!(found, &keypair.verifying_key().into());

        } else {

            panic!("wrong key type");

        }

        assert!(cert.signing_key() == Some(&keypair.verifying_key().into()));

    }

    #[test]

    fn unrecognized_ext() {

        use hex_literal::hex;

        use tor_bytes::Reader;

        let mut reader = Reader::from_slice(&hex!("0001 2A 00 2A"));

        let ext: CertExt = reader.extract().unwrap();

        let mut encoded: Vec<u8> = Vec::new();

        encoded.write(&ext).unwrap();

        assert_eq!(encoded, hex!("0001 2A 00 2A"));

    }

}