Struct NodeBuilder 

pub struct NodeBuilder { /* private fields */ }

Builder for constructing a Node<TailscaleProvider>.

Configures the Tailscale sidecar, network identity, and transport parameters before wiring all layers together.

Example

let node = Node::builder()
    .name("my-node")
    .sidecar_path("/opt/truffle/sidecar")
    .ws_port(9417)
    .build()
    .await?;

Implementations

impl NodeBuilder

pub fn name(self, name: &str) -> Self

Set the node’s display name (used as the Tailscale hostname).

pub fn sidecar_path(self, path: impl Into<PathBuf>) -> Self

Set the path to the Go sidecar binary.

pub fn state_dir(self, dir: &str) -> Self

Set the Tailscale state directory.

pub fn auth_key(self, key: &str) -> Self

Set the Tailscale auth key for headless authentication.

pub fn ephemeral(self, val: bool) -> Self

Set whether the node is ephemeral (auto-removed from tailnet on shutdown).

pub fn ws_port(self, port: u16) -> Self

Set the WebSocket listen port.

pub async fn build(self) -> Result<Node<TailscaleProvider>, NodeError>

Build and start the node.

This creates the TailscaleProvider, starts it, creates the WebSocket transport and PeerRegistry, starts the session, and spawns the envelope router.

Errors

Returns NodeError::BuildError if required configuration is missing, or propagates errors from the network provider startup.

pub async fn build_with_auth_handler( self, on_auth: impl Fn(String) + Send + 'static, ) -> Result<Node<TailscaleProvider>, NodeError>

Build and start the node, calling on_auth if authentication is needed.

This is identical to build() except it subscribes to provider events before provider.start() blocks, forwarding AuthRequired events to the callback while waiting for authentication to complete.

Errors

Returns NodeError::BuildError if required configuration is missing, or propagates errors from the network provider startup.

Trait Implementations

impl Clone for NodeBuilder

fn clone(&self) -> NodeBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NodeBuilder

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

Formats the value using the given formatter.

impl Default for NodeBuilder

fn default() -> Self

Returns the “default value” for a type.