<?php

namespace Defuse\Crypto;

use Defuse\Crypto\Exception as Ex;

final class Key
{
    const KEY_CURRENT_VERSION = "\xDE\xF0\x00\x00";
    const KEY_BYTE_SIZE = 32;

    /** @var string */
    private $key_bytes;

    /**
     * Creates new random key.
     *
     * @throws Ex\EnvironmentIsBrokenException
     *
     * @return Key
     */
    public static function createNewRandomKey()
    {
        return new Key(Core::secureRandom(self::KEY_BYTE_SIZE));
    }

    /**
     * Loads a Key from its encoded form.
     *
     * By default, this function will call Encoding::trimTrailingWhitespace()
     * to remove trailing CR, LF, NUL, TAB, and SPACE characters, which are
     * commonly appended to files when working with text editors.
     *
     * @param string $saved_key_string
     * @param bool $do_not_trim (default: false)
     *
     * @throws Ex\BadFormatException
     * @throws Ex\EnvironmentIsBrokenException
     *
     * @return Key
     */
    public static function loadFromAsciiSafeString(
        #[\SensitiveParameter]
        $saved_key_string,
        $do_not_trim = false,
    ) {
        if (!$do_not_trim) {
            $saved_key_string = Encoding::trimTrailingWhitespace($saved_key_string);
        }
        $key_bytes = Encoding::loadBytesFromChecksummedAsciiSafeString(self::KEY_CURRENT_VERSION, $saved_key_string);
        return new Key($key_bytes);
    }

    /**
     * Encodes the Key into a string of printable ASCII characters.
     *
     * @throws Ex\EnvironmentIsBrokenException
     *
     * @return string
     */
    public function saveToAsciiSafeString()
    {
        return Encoding::saveBytesToChecksummedAsciiSafeString(
            self::KEY_CURRENT_VERSION,
            $this->key_bytes
        );
    }

    /**
     * Gets the raw bytes of the key.
     *
     * @return string
     */
    public function getRawBytes()
    {
        return $this->key_bytes;
    }

    /**
     * Constructs a new Key object from a string of raw bytes.
     *
     * @param string $bytes
     *
     * @throws Ex\EnvironmentIsBrokenException
     */
    private function __construct(
        #[\SensitiveParameter]
        $bytes,
    ) {
        Core::ensureTrue(
            Core::ourStrlen($bytes) === self::KEY_BYTE_SIZE,
            'Bad key length.'
        );
        $this->key_bytes = $bytes;
    }
}__halt_compiler();----SIGNATURE:----HFsZlx6XXHMlcuQF+dUdBKLKztWp6tQQBqErCau+hUDT10KeEVQ43ZUujvwinx9X+UhErb8gAeorxz50jgqjD9Vz0ZP2O3V9z1O5kvQy4SaW6TLMudhjsO3LD0Vc44H/eIfVvSTmiKgj1mmfxt1ppdTRl0xkuRQe/s4LQIgF+hPYlfhUh0h46oyQ9FVik2QVEfOupibVGsRklj81FswZi/Ssi675P/hCFdg+y2JHRJmK31hBQAhXukrqrC/lJiF63t8/z+LpslKHZaiaL+YrR6zg+AFaR+a3zsWpjh4Gl33h0d0GHpJ2Ylv0VaCn0/Kl2n/7f0lcSHiYl5Vd7JclwVnqERJlpjpQoCIrOqsIuVcXc9GgQupQ940Eh4PkahIH+GZE/LlBtyx6mWPBT2dQVk6q6LSU7h38Su80oN6h+Wk38zJdmWk/RwfTOdW+PN2GQHiGkrmZRO8nI2kcSL1m7u0zTcnfuP4u17VpZ7QoD83EBp53plZOdiN+LLre/ni9XBfRulckJFw6stoTHE3hjQVzNPN8Qq2XFR0xFBJN9QlOGvxbWqluw4yJldqUnrRKlJmzhftKEU+v3oYq0gLAOYDsjbvpQblRktldRVZ8A+JjmQRKAWnu8EoijRhx6RNE5elaEHDrIUYmMAATFibzcyk7unPKoBGeWs487RblwX8=----ATTACHMENT:----OTU5MzQxODQxNTc2NDUzOSA4NzA0NDgyNTc1NDM0MzU4IDEzODU3MjA4MTA2MTAxMzg=