Struct Loopback 

#[non_exhaustive]
pub struct Loopback {
    pub address: SocketAddr,
    pub proxy_cred: String,
    pub local_api_address: SocketAddr,
    pub local_api_cred: String,
}

The result of Server::loopback — the full Go Loopback() (addr, proxyCred, localAPICred, err) surface: both credentials, and an in-process LocalAPI HTTP server actually running.

Go parity, and the one honest delta

Go serves the SOCKS5 proxy and the LocalAPI on a single muxed loopback listener. This fork runs two 127.0.0.1 listeners instead — address for the SOCKS5 proxy (proxy_cred) and local_api_address for the LocalAPI HTTP server (local_api_cred) — because the SOCKS5 half is the engine’s own Device::loopback and the LocalAPI half is layered on top without re-implementing (or first-byte-demuxing) the proven proxy path. The observable contract is identical: a SOCKS5 proxy gated by proxy_cred, and a LocalAPI gated by local_api_cred. This delta is surfaced, not faked (see docs/TSNET_FACADE_DESIGN.md §11).

Lifecycle

Like Go’s s.loopbackListener, both listeners live for the Server’s lifetime and are torn down by Server::close — Server::loopback is idempotent and returns the same addresses and credentials on every call. There is no per-result handle to drop.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

address: SocketAddr

The bound 127.0.0.1:<port> address of the SOCKS5 proxy (Go’s addr, SOCKS5 half).

proxy_cred: String

The SOCKS5 proxy credential (Go’s proxyCred; username is fixed to "tsnet").

local_api_address: SocketAddr

The bound 127.0.0.1:<port> address of the in-process LocalAPI HTTP server.

local_api_cred: String

The LocalAPI credential (Go’s localAPICred): the HTTP Basic-auth password the LocalAPI server requires (any username is accepted, matching Go). Reach it with LocalClient.

Trait Implementations

impl Clone for Loopback

fn clone(&self) -> Loopback

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Loopback

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

Redacts both credentials — proxy_cred and local_api_cred are secrets and must never reach {:?}/tracing output. Field names are preserved so the shape is still legible.