public async Task <TorSocks5Client> EstablishTcpConnectionAsync(string host, int port, bool isolateStream = true, CancellationToken cancel = default)
{
host = Guard.NotNullOrEmptyOrWhitespace(nameof(host), host, true);
Guard.MinimumAndNotNull(nameof(port), port, 0);
var client = new TorSocks5Client(TorSocks5EndPoint);
try
{
await client.ConnectAsync().ConfigureAwait(false);
cancel.ThrowIfCancellationRequested();
await client.HandshakeAsync(isolateStream).ConfigureAwait(false);
cancel.ThrowIfCancellationRequested();
await client.ConnectToDestinationAsync(host, port).ConfigureAwait(false);
cancel.ThrowIfCancellationRequested();
return(client);
}
catch (OperationCanceledException)
{
client?.Dispose();
throw;
}
}
public async Task <TorSocks5Client> EstablishTcpConnectionAsync(IPEndPoint destination, bool isolateStream = true, CancellationToken cancel = default)
{
Guard.NotNull(nameof(destination), destination);
var client = new TorSocks5Client(TorSocks5EndPoint);
try
{
await client.ConnectAsync().ConfigureAwait(false);
cancel.ThrowIfCancellationRequested();
await client.HandshakeAsync(isolateStream).ConfigureAwait(false);
cancel.ThrowIfCancellationRequested();
await client.ConnectToDestinationAsync(destination).ConfigureAwait(false);
cancel.ThrowIfCancellationRequested();
return(client);
}
catch (OperationCanceledException)
{
client?.Dispose();
throw;
}
}
/// <param name="identity">Isolates streams by identity.</param>
public async Task <TorSocks5Client> EstablishTcpConnectionAsync(IPEndPoint destination, string identity, CancellationToken cancel = default)
{
identity = Guard.NotNullOrEmptyOrWhitespace(nameof(identity), identity, trim: true);
Guard.NotNull(nameof(destination), destination);
var client = new TorSocks5Client(TorSocks5EndPoint);
try
{
await client.ConnectAsync().ConfigureAwait(false);
cancel.ThrowIfCancellationRequested();
await client.HandshakeAsync(identity).ConfigureAwait(false);
cancel.ThrowIfCancellationRequested();
await client.ConnectToDestinationAsync(destination).ConfigureAwait(false);
cancel.ThrowIfCancellationRequested();
return(client);
}
catch (OperationCanceledException)
{
client?.Dispose();
throw;
}
}
/// <summary>
/// Tor attempts to find the canonical hostname for that IPv4 record
/// </summary>
public async Task <string> ReverseResolveAsync(IPAddress iPv4, bool isolateStream = true)
{
Guard.NotNull(nameof(iPv4), iPv4);
using (var client = new TorSocks5Client(TorSocks5EndPoint))
{
await client.ConnectAsync().ConfigureAwait(false);
await client.HandshakeAsync(isolateStream).ConfigureAwait(false);
return(await client.ReverseResolveAsync(iPv4).ConfigureAwait(false));
}
}
/// <summary>
/// When Tor receives a "RESOLVE" SOCKS command, it initiates
/// a remote lookup of the hostname provided as the target address in the SOCKS
/// request.
/// </summary>
public async Task <IPAddress> ResolveAsync(string host, bool isolateStream = true)
{
host = Guard.NotNullOrEmptyOrWhitespace(nameof(host), host, true);
using (var client = new TorSocks5Client(TorSocks5EndPoint))
{
await client.ConnectAsync().ConfigureAwait(false);
await client.HandshakeAsync(isolateStream).ConfigureAwait(false);
return(await client.ResolveAsync(host).ConfigureAwait(false));
}
}
public async Task <TorSocks5Client> EstablishTcpConnectionAsync(IPEndPoint destination, bool isolateStream = true)
{
Guard.NotNull(nameof(destination), destination);
var client = new TorSocks5Client(TorSocks5EndPoint);
await client.ConnectAsync();
await client.HandshakeAsync(isolateStream);
await client.ConnectToDestinationAsync(destination);
return(client);
}
public async Task <TorSocks5Client> EstablishTcpConnectionAsync(string host, int port, bool isolateStream = true)
{
host = Guard.NotNullOrEmptyOrWhitespace(nameof(host), host, true);
Guard.MinimumAndNotNull(nameof(port), port, 0);
var client = new TorSocks5Client(TorSocks5EndPoint);
await client.ConnectAsync();
await client.HandshakeAsync(isolateStream);
await client.ConnectToDestinationAsync(host, port);
return(client);
}
/// <param name="identity">Isolates streams by identity.</param>
public async Task <TorSocks5Client> EstablishTcpConnectionAsync(IPEndPoint destination, string identity)
{
identity = Guard.NotNullOrEmptyOrWhitespace(nameof(identity), identity, trim: true);
Guard.NotNull(nameof(destination), destination);
var client = new TorSocks5Client(TorSocks5EndPoint);
await client.ConnectAsync();
await client.HandshakeAsync(identity);
await client.ConnectToDestinationAsync(destination);
return(client);
}
