Moved UpdateCrc32 to Compat

Added some xml comment

src/Client.cs

@@ -39,6 +39,9 @@ namespace WTelegram
 		private readonly SemaphoreSlim _sendSemaphore = new(1);
 		private CancellationTokenSource _cts;
 
+		/// <summary>Welcome to WTelegramClient! 😀</summary>
+		/// <param name="configProvider">Config callback, is queried for: api_id, api_hash, session_pathname</param>
+		/// <param name="updateHandler">Handler for Telegram updates messages that are not replies to RPC API calls</param>
 		public Client(Func<string,string> configProvider = null, Func<ITLObject, Task> updateHandler = null)
 		{
 			_config = configProvider ?? DefaultConfigOrAsk;
@@ -98,6 +101,8 @@ namespace WTelegram
 			_session.Reset();
 		}
 
+		/// <summary>Establish connection to Telegram servers. Config callback is queried for: server_address</summary>
+		/// <returns>Most methods of this class are async Task, so please use <see langword="await"/></returns>
 		public async Task ConnectAsync()
 		{
 			if (_reactorTask != null)
@@ -234,7 +239,7 @@ namespace WTelegram
 				var buffer = memStream.GetBuffer();
 				int frameLength = (int)memStream.Length;
 				BinaryPrimitives.WriteInt32LittleEndian(buffer, frameLength + 4); // patch frame_len with correct value
-				uint crc = Helpers.UpdateCrc32(0, buffer, 0, frameLength);
+				uint crc = Compat.UpdateCrc32(0, buffer, 0, frameLength);
 				writer.Write(crc);              // int32 frame_crc
 				//TODO: support Transport obfuscation?
 
@@ -277,8 +282,8 @@ namespace WTelegram
 			var payload = new byte[length];
 			if (await FullReadAsync(_networkStream, payload, length, ct) != length)
 				throw new ApplicationException("Could not read frame data : Connection shut down");
-			uint crc32 = Helpers.UpdateCrc32(0, frame, 0, 8);
+			uint crc32 = Compat.UpdateCrc32(0, frame, 0, 8);
-			crc32 = Helpers.UpdateCrc32(crc32, payload, 0, payload.Length);
+			crc32 = Compat.UpdateCrc32(crc32, payload, 0, payload.Length);
 			if (await FullReadAsync(_networkStream, frame, 4, ct) != 4)
 				throw new ApplicationException("Could not read frame CRC : Connection shut down");
 			if (crc32 != BinaryPrimitives.ReadUInt32LittleEndian(frame))
@@ -621,6 +626,11 @@ namespace WTelegram
 			}
 		}
 
+		/// <summary>
+		/// Login as bot (if not already done).
+		/// Config callback is queried for: bot_token
+		/// </summary>
+		/// <returns>Detail about the logged bot</returns>
 		public async Task<User> BotAuthIfNeeded()
 		{
 			if (_session.User != null)
@@ -633,6 +643,13 @@ namespace WTelegram
 			return user;
 		}
 
+		/// <summary>
+		/// Login as a user (if not already done).
+		/// Config callback is queried for: phone_number, verification_code
+		/// <br/>and eventually first_name, last_name (signup required), password (2FA auth)
+		/// </summary>
+		/// <param name="settings"></param>
+		/// <returns>Detail about the logged user</returns>
 		public async Task<User> UserAuthIfNeeded(CodeSettings settings = null)
 		{
 			if (_session.User != null)

src/Compat.cs

@@ -9,6 +9,12 @@ namespace WTelegram
 {
 	static class Compat
 	{
+		// see also https://github.com/dotnet/runtime/issues/2036 and https://github.com/dotnet/runtime/pull/53623
+		internal static readonly Func<uint, byte[], int, int, uint> UpdateCrc32 = (Func<uint, byte[], int, int, uint>)
+			typeof(System.IO.Compression.ZipArchive).Assembly.GetType("System.IO.Compression.Crc32Helper")
+			.GetMethod("UpdateCrc32", new[] { typeof(uint), typeof(byte[]), typeof(int), typeof(int) })
+			.CreateDelegate(typeof(Func<uint, byte[], int, int, uint>));
+
 #if NETCOREAPP2_1_OR_GREATER
 		internal static IPEndPoint IPEndPoint_Parse(string addr) => IPEndPoint.Parse(addr);
 		internal static BigInteger BigEndianInteger(byte[] value) => new(value, true, true);
@@ -23,7 +29,7 @@ namespace WTelegram
 
 		internal static byte[] ToByteArray(this BigInteger bigInteger, bool isUnsigned = false, bool isBigEndian = false)
 		{
-			if (!isBigEndian || !isUnsigned) throw new ArgumentException("Unexpected parameters to BigInteger");
+			if (!isBigEndian || !isUnsigned) throw new ArgumentException("Unexpected parameters to ToByteArray");
 			var result = bigInteger.ToByteArray();
 			if (result[^1] == 0) result = result[0..^1];
 			Array.Reverse(result);

src/Helpers.TL.cs

@@ -7,6 +7,7 @@ namespace TL
 	partial class InputChannel { public static InputPeerChannel Empty => new(); }
 	partial class InputDocument { public static InputDocumentEmpty Empty => new(); }
 	partial class InputPeer { public static InputPeerEmpty Empty => new(); }
+	partial class InputPeer { public static InputPeerSelf Self => new(); }
 	partial class InputPhoto { public static InputPhotoEmpty Empty => new(); }
 	partial class InputEncryptedFile { public static InputEncryptedFileEmpty Empty => new(); }
 	partial class InputStickerSet { public static InputStickerSetEmpty Empty => new(); }

src/Helpers.cs

@@ -189,11 +189,5 @@ namespace WTelegram
 			}
 			return true;
 		}
-
-		// see also https://github.com/dotnet/runtime/issues/2036 and https://github.com/dotnet/runtime/pull/53623
-		internal static readonly Func<uint, byte[], int, int, uint> UpdateCrc32 = (Func<uint, byte[], int, int, uint>)
-			typeof(System.IO.Compression.ZipArchive).Assembly.GetType("System.IO.Compression.Crc32Helper")
-			.GetMethod("UpdateCrc32", new[] { typeof(uint), typeof(byte[]), typeof(int), typeof(int) })
-			.CreateDelegate(typeof(Func<uint, byte[], int, int, uint>));
 	}
 }