shadowsocks-windows/shadowsocks-csharp/Encryption/CipherInfo.cs

using Shadowsocks.Controller;

namespace Shadowsocks.Encryption
{
    public enum CipherFamily
    {
        Plain,
        Table,

        AesGcm,

        AesCfb,
        AesCtr,

        Chacha20,
        Chacha20Poly1305,
        XChacha20Poly1305,

        Rc4,
        Rc4Md5,
    }

    public enum CipherStandardState
    {
        InUse,
        Deprecated, // popup warning when updated
        Hidden,     // enabled by hidden flag in config file

        Unstable,   // not in standard list or wip, only gui info
    }

    public class CipherParameter
    {
        public int KeySize;
    }
    public class StreamCipherParameter : CipherParameter
    {
        public int IvSize;
        public override string ToString()
        {
            return $"stream (key:{KeySize * 8}, iv:{IvSize * 8})";
        }
    }

    public class AEADCipherParameter : CipherParameter
    {
        public int SaltSize;
        public int TagSize;
        public int NonceSize;
        public override string ToString()
        {
            return $"aead (key:{KeySize * 8}, salt:{SaltSize * 8}, tag:{TagSize * 8}, nonce:{NonceSize * 8})";
        }
    }

    public class CipherInfo
    {
        public string Name;
        public CipherFamily Type;
        public CipherParameter CipherParameter;

        public CipherStandardState StandardState = CipherStandardState.InUse;

        #region Stream ciphers
        public CipherInfo(string name, int keySize, int ivSize, CipherFamily type, CipherStandardState state = CipherStandardState.Hidden)
        {
            Type = type;
            Name = name;
            StandardState = state;

            CipherParameter = new StreamCipherParameter
            {
                KeySize = keySize,
                IvSize = ivSize,
            };
        }

        #endregion

        #region AEAD ciphers
        public CipherInfo(string name, int keySize, int saltSize, int nonceSize, int tagSize, CipherFamily type, CipherStandardState state = CipherStandardState.InUse)
        {
            Type = type;
            Name = name;
            StandardState = state;

            CipherParameter = new AEADCipherParameter
            {
                KeySize = keySize,
                SaltSize = saltSize,
                NonceSize = nonceSize,
                TagSize = tagSize,
            };
        }
        #endregion

        public override string ToString()
        {
            return StandardState == CipherStandardState.InUse ? Name : $"{Name} ({I18N.GetString(StandardState.ToString().ToLower())})";
        }
        public string ToString(bool verbose)
        {
            if (!verbose)
            {
                return ToString();
            }

            return $"{Name} {StandardState} {CipherParameter}";
        }
    }
}