Module network 

Layer 3: Network — Peer discovery, addressing, encrypted tunnels.

This module defines the NetworkProvider trait, the public API for Layer 3. The trait is generic — no Tailscale-specific types leak through.

The tailscale submodule contains the TailscaleProvider implementation that wraps the Go sidecar (tsnet) and bridge.

Modules

tailscale

Tailscale network provider implementation.

Structs

DialOpts

Options for NetworkProvider::dial_tcp_opts.

HealthInfo

Health information from the network provider.

IncomingConnection

An incoming TCP connection with metadata.

ListenOpts

Options for NetworkProvider::listen_tcp_opts.

NetworkPeer

A peer as seen by the network layer (Layer 3).

NetworkTcpListener

A listener for incoming TCP connections via the network provider.

NetworkUdpSocket

A UDP socket that relays datagrams through the network provider.

NodeIdentity

Identity of the local node on the network.

PeerAddr

Network address of a peer.

PingResult

Result of a network-level ping.

ProxyAddParams

Parameters for starting a reverse proxy via the network provider.

ProxyAddResult

Result of successfully starting a reverse proxy.

ProxyListEntry

Entry in the proxy list from the network provider.

ProxyRoute

One path-prefix route of a v2 proxy (RFC 023 §7). Wire-shaped: exactly one of target_url / dir must be set. Longest prefix wins (D11).

ProxyRuntimeError

A runtime error from the provider’s proxy engine after a successful add (RFC 023 G5 fix — e.g. sidecar SERVE_ERROR / CONNECTION_REFUSED).

TailscalePeerIdentity

A remote peer’s Tailscale-authenticated identity, parsed from the WhoIs JSON the sidecar attaches to inbound bridge connections (the remote_identity field of IncomingConnection).

Enums

NetworkError

Errors from Layer 3 network operations.

NetworkPeerEvent

Events emitted when network peers change state.

Traits

NetworkProvider

Provides network-level peer discovery and raw connectivity.