mirror of
https://github.com/JKorf/CryptoExchange.Net.git
synced 2026-08-12 00:43:03 +00:00
e823114623
* Result types: * (Web)CallResult types are replaced by HttpResult, WebSocketResult and QueryResult with the same logic * Updated result types to record type * Result creation can be done with (Http/WebSocket/Query)Result.Ok(..) and .Fail(..) * Removed implicit result type conversion to bool, `if (result)` no longer works, instead use `if (result.Success)` * Replaced CallResult.SuccessResult with CallResult.Ok() * Fixed result object nullability hinting, for example Data might be null if Success isn't checked for true * Parameters & serialization: * Added support for `enabled` and `disabled` strings to bool converter * Removed ParameterCollection type, has been replaced by Parameters type * Removed ArraySerialization, OrderParameters and ParameterOrderComparer properties from RestApiClient, moved to ParameterSerializationsSettings * Updated RestRequestConfiguration in AuthenticationProvider.ProcessRequest to contain the full RequestDefinition instead of copied fields * Clients: * Updated Api client constructor logging parameter from ILogger to ILoggerFactory? * Added Api client constructor exchange name parameter * Added ToString overrides on base API types * Added Exchange property on BaseApiClient * Added ApiCredentials property on IRestApiClient and ISocketApiClient interfaces * Updated ILogger source from client name to topic specific client name * Removed logging from client creation * Fixed BaseRestClient SetApiCredentials not marked as virtual * Rest: * Added BaseAddress to RequestDefinition object * Updated RestApiClient AuthenticationProvider logic from private to protected and virtual * Removed RestApiClient.SendAsync baseAddress parameter removed * Removed RestApiClient.SendAsync without type parameter * WebSocket: * Updated MessageRouting definition into CreateForEvent for subscriptions and CreateForQuery for queries * Improved Query type safety with CeateForQuery which allows second parameter for specifying the result type * Renamed MessageRouter.CreateWithoutHandler to CreateVoid * Updated SocketApiClient.GetSocketConnection to check connection uri instead of Tag for finding compatible connections * Removed unused UnhandledMessageExpected property SocketApiClient * Fixed issue in SocketApiClient.GetSocketConnection causing requests to always wait the full max 10 seconds when there was a reconnecting socket * Shared APIs: * Updated Option definitions to always require the exchange name as first parameter * Added missing dedicated option types * Added Discover method on ISharedClient interface, returning info on supported capabilities and operations * Added SharedRequest GetParamValue helper method accepting multiple parameter names * Added ResetStaticExchangeParameters method on ExchangeParameters * Added Status property to SharedWithdrawal model * Added TradingModes property to SharedBalance model * Updated ExchangeSymbolCache to support multiple environments and additional key separation * Updated Shared ExchangeParameters parameter names to be case insensitive * Updated code comments * Replaced ExchangeResult with ExchangeCallResult type * Removed AsExchangeResult/ExchangeWebResult * Removed TradingMode from the response model, only maintained on models where it makes sense * Removed IListenKey support, listen keys now rely on internal management with TokenManager * Rate limiting: * Fixed websocket connection attempts counting towards rate limit even when server could not be reached * Removed host from rate limit methods, now part of the already provided RequestDefinition * Added amount parameter to RateLimit Reset method to allow partially resetting the limit * Added TokenManager implementation for automatic listenkey/token management * Added UserClientProvider base class * Added async streaming on UserDataTracker items with StreamUpdatesAsync * Added cancellation token support to UserDataTracker starting * Added Unit type for non-result types * Added ServerError constructor taking ErrorType and message to make it easier to create * Added SupportedEnvironments property to PlatformInfo * Updated SymbolOrderBook DoResyncAsync to return CallResult instead of CallResult<bool> which was redundant * Various small performance improvements
143 lines
4.4 KiB
C#
143 lines
4.4 KiB
C#
using System;
|
|
using CryptoExchange.Net.Interfaces.Clients;
|
|
using CryptoExchange.Net.Objects.Errors;
|
|
using CryptoExchange.Net.Objects.Options;
|
|
using CryptoExchange.Net.SharedApis;
|
|
using Microsoft.Extensions.Logging;
|
|
using Microsoft.Extensions.Logging.Abstractions;
|
|
|
|
namespace CryptoExchange.Net.Clients
|
|
{
|
|
/// <summary>
|
|
/// Base API for all API clients
|
|
/// </summary>
|
|
public abstract class BaseApiClient : IDisposable, IBaseApiClient
|
|
{
|
|
/// <summary>
|
|
/// Client name
|
|
/// </summary>
|
|
protected string? _clientName;
|
|
|
|
/// <summary>
|
|
/// Logger
|
|
/// </summary>
|
|
protected ILogger _logger;
|
|
|
|
/// <summary>
|
|
/// If we are disposing
|
|
/// </summary>
|
|
protected bool _disposed;
|
|
|
|
/// <summary>
|
|
/// Whether a proxy is configured
|
|
/// </summary>
|
|
protected bool _proxyConfigured;
|
|
|
|
/// <summary>
|
|
/// Name of the client
|
|
/// </summary>
|
|
protected internal string ClientName
|
|
{
|
|
get
|
|
{
|
|
if (_clientName != null)
|
|
return _clientName;
|
|
|
|
_clientName = GetType().Name;
|
|
return _clientName;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// The name of the exchange this client is for
|
|
/// </summary>
|
|
public string Exchange { get; }
|
|
|
|
/// <summary>
|
|
/// The environment this client communicates to
|
|
/// </summary>
|
|
public string BaseAddress { get; }
|
|
|
|
/// <summary>
|
|
/// Output the original string data along with the deserialized object
|
|
/// </summary>
|
|
public bool OutputOriginalData { get; }
|
|
|
|
/// <summary>
|
|
/// Api options
|
|
/// </summary>
|
|
public ApiOptions ApiOptions { get; }
|
|
|
|
/// <summary>
|
|
/// Client Options
|
|
/// </summary>
|
|
public ExchangeOptions ClientOptions { get; }
|
|
|
|
/// <summary>
|
|
/// Mapping of a response code to known error types
|
|
/// </summary>
|
|
protected internal virtual ErrorMapping ErrorMapping { get; } = new ErrorMapping([]);
|
|
|
|
/// <summary>
|
|
/// ctor
|
|
/// </summary>
|
|
/// <param name="loggerFactory">Logger factory</param>
|
|
/// <param name="exchange">The exchange name</param>
|
|
/// <param name="outputOriginalData">Should data from this client include the original data in the call result</param>
|
|
/// <param name="baseAddress">Base address for this API client</param>
|
|
/// <param name="clientOptions">Client options</param>
|
|
/// <param name="apiOptions">Api options</param>
|
|
protected BaseApiClient(
|
|
ILoggerFactory? loggerFactory,
|
|
string exchange,
|
|
bool outputOriginalData,
|
|
string baseAddress,
|
|
ExchangeOptions clientOptions,
|
|
ApiOptions apiOptions)
|
|
{
|
|
var loggerName = ClientName.StartsWith(exchange, StringComparison.OrdinalIgnoreCase)
|
|
? exchange + "." + ClientName.Substring(exchange.Length).TrimStart('.')
|
|
: exchange + "." + ClientName;
|
|
_logger = loggerFactory?.CreateLogger(loggerName) ?? NullLogger.Instance;
|
|
|
|
Exchange = exchange;
|
|
ClientOptions = clientOptions;
|
|
ApiOptions = apiOptions;
|
|
OutputOriginalData = outputOriginalData;
|
|
BaseAddress = baseAddress;
|
|
|
|
_proxyConfigured = ClientOptions.Proxy != null;
|
|
}
|
|
|
|
/// <inheritdoc />
|
|
public abstract string FormatSymbol(string baseAsset, string quoteAsset, TradingMode tradingMode, DateTime? deliverDate = null);
|
|
|
|
/// <summary>
|
|
/// Get error info for a response code
|
|
/// </summary>
|
|
public ErrorInfo GetErrorInfo(int code, string? message = null) => GetErrorInfo(code.ToString(), message);
|
|
|
|
/// <summary>
|
|
/// Get error info for a response code
|
|
/// </summary>
|
|
public ErrorInfo GetErrorInfo(string code, string? message = null) => ErrorMapping.GetErrorInfo(code.ToString(), message);
|
|
|
|
/// <summary>
|
|
/// Dispose
|
|
/// </summary>
|
|
public void Dispose()
|
|
{
|
|
Dispose(true);
|
|
GC.SuppressFinalize(this);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Dispose
|
|
/// </summary>
|
|
protected virtual void Dispose(bool disposing)
|
|
{
|
|
_disposed = true;
|
|
}
|
|
}
|
|
}
|