using CryptoExchange.Net.Objects; using CryptoExchange.Net.SharedApis; using Microsoft.Extensions.DependencyInjection; using System; using System.Collections.Generic; using System.Globalization; using System.IO; using System.IO.Compression; using System.Linq; using System.Runtime.InteropServices; using System.Text; using System.Web; namespace CryptoExchange.Net { /// /// Helper methods /// public static class ExtensionMethods { /// /// Add a parameter /// /// /// /// public static void AddParameter(this Dictionary parameters, string key, string value) { parameters.Add(key, value); } /// /// Add a parameter /// /// /// /// public static void AddParameter(this Dictionary parameters, string key, object value) { parameters.Add(key, value); } /// /// Add an optional parameter. Not added if value is null /// /// /// /// public static void AddOptionalParameter(this Dictionary parameters, string key, object? value) { if (value != null) parameters.Add(key, value); } /// /// Create a query string of the specified parameters /// /// The parameters to use /// Whether or not the values should be url encoded /// How to serialize array parameters /// public static string CreateParamString(this IDictionary parameters, bool urlEncodeValues, ArrayParametersSerialization serializationType) { var uriString = new StringBuilder(); bool first = true; foreach(var parameter in parameters) { if (!first) uriString.Append("&"); first = false; if (parameter.Value.GetType().IsArray) { if (serializationType == ArrayParametersSerialization.Array) { bool firstArrayValue = true; foreach (var entry in (Array)parameter.Value) { if (!firstArrayValue) uriString.Append('&'); firstArrayValue = false; uriString.Append(parameter.Key); uriString.Append("[]="); if (urlEncodeValues) uriString.Append(Uri.EscapeDataString(string.Format(CultureInfo.InvariantCulture, "{0}", entry))); else uriString.Append(string.Format(CultureInfo.InvariantCulture, "{0}", entry)); } } else if (serializationType == ArrayParametersSerialization.MultipleValues) { bool firstArrayValue = true; foreach (var entry in (Array)parameter.Value) { if (!firstArrayValue) uriString.Append('&'); firstArrayValue = false; uriString.Append(parameter.Key); uriString.Append("="); if (urlEncodeValues) uriString.Append(Uri.EscapeDataString(string.Format(CultureInfo.InvariantCulture, "{0}", entry))); else uriString.Append(string.Format(CultureInfo.InvariantCulture, "{0}", entry)); } } else { uriString.Append('['); var firstArrayEntry = true; foreach (var entry in (Array)parameter.Value) { if (!firstArrayEntry) uriString.Append(','); firstArrayEntry = false; if (urlEncodeValues) uriString.Append(Uri.EscapeDataString(string.Format(CultureInfo.InvariantCulture, "{0}", entry))); else uriString.Append(string.Format(CultureInfo.InvariantCulture, "{0}", entry)); } uriString.Append(']'); } } else { uriString.Append(parameter.Key); uriString.Append('='); if (urlEncodeValues) uriString.Append(Uri.EscapeDataString(string.Format(CultureInfo.InvariantCulture, "{0}", parameter.Value))); else uriString.Append(string.Format(CultureInfo.InvariantCulture, "{0}", parameter.Value)); } } return uriString.ToString(); } /// /// Convert a dictionary to formdata string /// /// /// public static string ToFormData(this IDictionary parameters) { var formData = HttpUtility.ParseQueryString(string.Empty); foreach (var kvp in parameters) { if (kvp.Value is null) continue; if (kvp.Value.GetType().IsArray) { var array = (Array)kvp.Value; foreach (var value in array) formData.Add(kvp.Key, string.Format(CultureInfo.InvariantCulture, "{0}", value)); } else { formData.Add(kvp.Key, string.Format(CultureInfo.InvariantCulture, "{0}", kvp.Value)); } } return formData.ToString()!; } /// /// Validates an int is one of the allowed values /// /// Value of the int /// Name of the parameter /// Allowed values public static void ValidateIntValues(this int value, string argumentName, params int[] allowedValues) { if (!allowedValues.Contains(value)) { throw new ArgumentException( $"{value} not allowed for parameter {argumentName}, allowed values: {string.Join(", ", allowedValues)}", argumentName); } } /// /// Validates an int is between two values /// /// The value of the int /// Name of the parameter /// Min value /// Max value public static void ValidateIntBetween(this int value, string argumentName, int minValue, int maxValue) { if (value < minValue || value > maxValue) { throw new ArgumentException( $"{value} not allowed for parameter {argumentName}, min: {minValue}, max: {maxValue}", argumentName); } } /// /// Validates a string is not null or empty /// /// The value of the string /// Name of the parameter public static void ValidateNotNull(this string value, string argumentName) { if (string.IsNullOrEmpty(value)) throw new ArgumentException($"No value provided for parameter {argumentName}", argumentName); } /// /// Validates a string is null or not empty /// /// /// public static void ValidateNullOrNotEmpty(this string value, string argumentName) { if (value != null && string.IsNullOrEmpty(value)) throw new ArgumentException($"No value provided for parameter {argumentName}", argumentName); } /// /// Validates an object is not null /// /// The value of the object /// Name of the parameter public static void ValidateNotNull(this object value, string argumentName) { if (value == null) throw new ArgumentException($"No value provided for parameter {argumentName}", argumentName); } /// /// Validates a list is not null or empty /// /// The value of the object /// Name of the parameter public static void ValidateNotNull(this IEnumerable value, string argumentName) { if (value == null || !value.Any()) throw new ArgumentException($"No values provided for parameter {argumentName}", argumentName); } /// /// Format a string to RFC3339/ISO8601 string /// /// /// public static string ToRfc3339String(this DateTime dateTime) { return dateTime.ToString("yyyy-MM-dd'T'HH:mm:ss.fffzzz", DateTimeFormatInfo.InvariantInfo); } /// /// Format an exception and inner exception to a readable string /// /// /// public static string ToLogString(this Exception? exception) { var message = new StringBuilder(); var indent = 0; while (exception != null) { for (var i = 0; i < indent; i++) message.Append(' '); message.Append(exception.GetType().Name); message.Append(" - "); message.AppendLine(exception.Message); for (var i = 0; i < indent; i++) message.Append(' '); message.AppendLine(exception.StackTrace); indent += 2; exception = exception.InnerException; } return message.ToString(); } /// /// Append a base url with provided path /// public static string AppendPath(this string url, params string[] path) { var sb = new StringBuilder(url.TrimEnd('/')); foreach (var subPath in path) { sb.Append('/'); sb.Append(subPath.Trim('/')); } return sb.ToString(); } /// /// Decompress using GzipStream /// public static ReadOnlySpan DecompressGzip(this ReadOnlySpan data) { using var decompressedStream = new MemoryStream(); using var deflateStream = new GZipStream(new MemoryStream(data.ToArray()), CompressionMode.Decompress); deflateStream.CopyTo(decompressedStream); return new ReadOnlySpan(decompressedStream.GetBuffer(), 0, (int)decompressedStream.Length); } /// /// Decompress using GzipStream /// public static ReadOnlySpan Decompress(this ReadOnlySpan input) { using var output = new MemoryStream(); using var compressStream = new MemoryStream(input.ToArray()); using var decompressor = new DeflateStream(compressStream, CompressionMode.Decompress); decompressor.CopyTo(output); return new ReadOnlySpan(output.GetBuffer(), 0, (int)output.Length); } /// /// Whether the trading mode is linear /// public static bool IsLinear(this TradingMode type) => type == TradingMode.PerpetualLinear || type == TradingMode.DeliveryLinear; /// /// Whether the trading mode is inverse /// public static bool IsInverse(this TradingMode type) => type == TradingMode.PerpetualInverse || type == TradingMode.DeliveryInverse; /// /// Whether the trading mode is perpetual /// public static bool IsPerpetual(this TradingMode type) => type == TradingMode.PerpetualInverse || type == TradingMode.PerpetualLinear; /// /// Whether the trading mode is delivery /// public static bool IsDelivery(this TradingMode type) => type == TradingMode.DeliveryInverse || type == TradingMode.DeliveryLinear; /// /// Whether the account type is a futures account /// public static bool IsFuturesAccount(this SharedAccountType type) => type == SharedAccountType.PerpetualLinearFutures || type == SharedAccountType.DeliveryLinearFutures || type == SharedAccountType.PerpetualInverseFutures || type == SharedAccountType.DeliveryInverseFutures; /// /// Whether the account type is a margin account /// public static bool IsMarginAccount(this SharedAccountType type) => type == SharedAccountType.CrossMargin || type == SharedAccountType.IsolatedMargin; /// /// Map a TradingMode value to a SharedAccountType enum value /// public static SharedAccountType ToAccountType(this TradingMode mode) { if (mode == TradingMode.Spot) return SharedAccountType.Spot; if (mode == TradingMode.PerpetualLinear) return SharedAccountType.PerpetualLinearFutures; if (mode == TradingMode.PerpetualInverse) return SharedAccountType.PerpetualInverseFutures; if (mode == TradingMode.DeliveryInverse) return SharedAccountType.DeliveryInverseFutures; if (mode == TradingMode.DeliveryLinear) return SharedAccountType.DeliveryLinearFutures; throw new ArgumentException(nameof(mode), "Unmapped trading mode"); } /// /// Register rest client interfaces /// public static IServiceCollection RegisterSharedRestInterfaces(this IServiceCollection services, Func client) { if (typeof(IAssetsRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IAssetsRestClient)client(x)!); if (typeof(IBalanceRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IBalanceRestClient)client(x)!); if (typeof(IDepositRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IDepositRestClient)client(x)!); if (typeof(IKlineRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IKlineRestClient)client(x)!); if (typeof(IListenKeyRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IListenKeyRestClient)client(x)!); if (typeof(IOrderBookRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IOrderBookRestClient)client(x)!); if (typeof(IRecentTradeRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IRecentTradeRestClient)client(x)!); if (typeof(ITradeHistoryRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (ITradeHistoryRestClient)client(x)!); if (typeof(IWithdrawalRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IWithdrawalRestClient)client(x)!); if (typeof(IWithdrawRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IWithdrawRestClient)client(x)!); if (typeof(IFeeRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IFeeRestClient)client(x)!); if (typeof(IBookTickerRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IBookTickerRestClient)client(x)!); if (typeof(ITransferRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (ITransferRestClient)client(x)!); if (typeof(ISpotOrderRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (ISpotOrderRestClient)client(x)!); if (typeof(ISpotSymbolRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (ISpotSymbolRestClient)client(x)!); if (typeof(ISpotTickerRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (ISpotTickerRestClient)client(x)!); if (typeof(ISpotTriggerOrderRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (ISpotTriggerOrderRestClient)client(x)!); if (typeof(ISpotOrderClientIdRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (ISpotOrderClientIdRestClient)client(x)!); if (typeof(IFundingRateRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IFundingRateRestClient)client(x)!); if (typeof(IFuturesOrderRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IFuturesOrderRestClient)client(x)!); if (typeof(IFuturesSymbolRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IFuturesSymbolRestClient)client(x)!); if (typeof(IFuturesTickerRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IFuturesTickerRestClient)client(x)!); if (typeof(IIndexPriceKlineRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IIndexPriceKlineRestClient)client(x)!); if (typeof(ILeverageRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (ILeverageRestClient)client(x)!); if (typeof(IMarkPriceKlineRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IMarkPriceKlineRestClient)client(x)!); if (typeof(IOpenInterestRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IOpenInterestRestClient)client(x)!); if (typeof(IPositionHistoryRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IPositionHistoryRestClient)client(x)!); if (typeof(IPositionModeRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IPositionModeRestClient)client(x)!); if (typeof(IFuturesTpSlRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IFuturesTpSlRestClient)client(x)!); if (typeof(IFuturesTriggerOrderRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IFuturesTriggerOrderRestClient)client(x)!); if (typeof(IFuturesOrderClientIdRestClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IFuturesOrderClientIdRestClient)client(x)!); return services; } /// /// Register socket client interfaces /// public static IServiceCollection RegisterSharedSocketInterfaces(this IServiceCollection services, Func client) { if (typeof(IBalanceSocketClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IBalanceSocketClient)client(x)!); if (typeof(IBookTickerSocketClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IBookTickerSocketClient)client(x)!); if (typeof(IKlineSocketClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IKlineSocketClient)client(x)!); if (typeof(IOrderBookSocketClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IOrderBookSocketClient)client(x)!); if (typeof(ITickerSocketClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (ITickerSocketClient)client(x)!); if (typeof(ITickersSocketClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (ITickersSocketClient)client(x)!); if (typeof(ITradeSocketClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (ITradeSocketClient)client(x)!); if (typeof(IUserTradeSocketClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IUserTradeSocketClient)client(x)!); if (typeof(ISpotOrderSocketClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (ISpotOrderSocketClient)client(x)!); if (typeof(IFuturesOrderSocketClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IFuturesOrderSocketClient)client(x)!); if (typeof(IPositionSocketClient).IsAssignableFrom(typeof(T))) services.AddTransient(x => (IPositionSocketClient)client(x)!); return services; } /// /// Convert a hex encoded string to byte array /// /// /// public static byte[] HexStringToBytes(this string hexString) { if (hexString.StartsWith("0x")) hexString = hexString.Substring(2); byte[] bytes = new byte[hexString.Length / 2]; for (int i = 0; i < hexString.Length; i += 2) { string hexSubstring = hexString.Substring(i, 2); bytes[i / 2] = Convert.ToByte(hexSubstring, 16); } return bytes; } } }