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.

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.