Struct RemoteNetstack 

pub struct RemoteNetstack { /* private fields */ }

Async LazyCat RemoteSocks network stack.

Implementations

impl RemoteNetstack

pub fn new(hserver: HServerClient, location: impl Into<RemoteLocation>) -> Self

Resolve proxy endpoints through HPortalSys for the requested location.

pub fn fixed(endpoint: RemoteSocksEndpoint) -> Self

Use a fixed RemoteSocks proxy endpoint.

pub fn with_endpoint_resolver<F, Fut>(resolver: F) -> Self

where F: Fn() -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<RemoteSocksEndpoint, Error>> + Send + 'static,

Use an asynchronous endpoint resolver compatible with the Go SDK’s dynamic address factory.

pub const fn with_dial_timeout(self, dial_timeout: Duration) -> Self

Override the default 60-second proxy connection deadline.

impl RemoteNetstack

pub async fn connect_tcp( &self, address: SocksAddress, ) -> Result<RemoteTcpStream, Error>

Connect to a TCP or custom-network address through RemoteSocks.

Errors

Returns endpoint resolution, proxy connection, SOCKS negotiation, or command reply errors.

pub async fn bind_tcp( &self, address: SocksAddress, ) -> Result<RemoteTcpListener, Error>

Bind a TCP or custom-network listener through RemoteSocks.

This method waits for the first SOCKS BIND reply. Call RemoteTcpListener::accept to wait for the second reply carrying the connecting peer address.

Errors

Returns endpoint resolution, proxy connection, SOCKS negotiation, or first-stage BIND reply errors.

impl RemoteNetstack

pub async fn udp_associate( &self, target: SocksAddress, ) -> Result<RemoteUdpSocket, Error>

Create a standard RFC 1928 UDP association with a fixed default target.

The TCP control stream remains open for the lifetime of the returned socket. Closing it causes receive operations to return Error::RemoteSocksControlClosed.

Errors

Returns endpoint resolution, SOCKS negotiation, relay address, socket binding, or control-stream errors.

pub async fn connect_udp( &self, target: SocksAddress, ) -> Result<RemoteUdpSocket, Error>

Connect a UDP peer using the LazyCat 0xe2 stream extension.

Domain targets are resolved locally, matching the official Go SDK.

Errors

Returns endpoint resolution, DNS, SOCKS negotiation, address, or framed transport errors.

pub async fn bind_udp( &self, address: SocksAddress, ) -> Result<RemoteUdpSocket, Error>

Bind a UDP socket using the LazyCat 0xe3 stream extension.

Use RemoteUdpSocket::send_to and RemoteUdpSocket::recv_from with the returned socket because it has no fixed peer.

Errors

Returns endpoint resolution, DNS, SOCKS negotiation, address, or framed transport errors.

Trait Implementations

impl Clone for RemoteNetstack

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RemoteNetstack

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.