Struct NodeConfig 

pub struct NodeConfig {
    pub rank: u32,
    pub world: u32,
    pub peers: PeerSource,
    pub topology: Topology,
    pub device: String,
    pub heap_bytes: Option<usize>,
    pub role: NodeRole,
}

Programmatic node configuration.

Every field is settable in code. NodeConfig::from_env exists for parity with the CLI workflow, but nothing here requires an environment — an iOS app or an Android service has no meaningful RANK/PEERS to read.

Fields

rank: u32

world: u32

peers: PeerSource

topology: Topology

device: String

Device directive: auto (node’s fastest) or a name (cpu, metal, …).

heap_bytes: Option<usize>

role: NodeRole

Implementations

impl NodeConfig

pub fn new(rank: u32, world: u32) -> Self

pub fn peers<I, S>(self, addrs: I) -> Result<Self, String>

where I: IntoIterator<Item = S>, S: Into<String>,

Static peer list.

Accepts either form:

• world addresses, indexed by rank — a full mesh, where every rank must be able to reach every other.
• exactly one address — the coordinator, for a star. This is what a phone can actually supply: a handset does not know its own reachable address, and on most Wi-Fi it cannot accept inbound connections at all, so it dials out and nothing dials it.

pub fn discover(self, disc_port: u16, data_base: u16) -> Self

Zero-config UDP peer discovery on a shared LAN.

pub fn discover_via(self, host: impl Into<String>) -> Self

Unicast the discovery query to a known rendezvous host. Use this on networks where UDP broadcast does not reach every peer — which includes most carrier and guest Wi-Fi, and iOS without the multicast entitlement.

pub fn topology(self, t: Topology) -> Self

pub fn star(self) -> Self

Star topology: workers dial the coordinator, which never waits to hear them. This is the shape a phone needs — a handset on Wi-Fi often cannot accept inbound connections, and in a mesh every rank must reach every other.

pub fn mesh(self) -> Self

Full mesh: every rank connects to every other. The default.

pub fn device(self, d: impl Into<String>) -> Self

pub fn heap_bytes(self, n: usize) -> Self

pub fn role(self, r: NodeRole) -> Self

pub fn fixed_function(self, ff: FixedFunction) -> Self

Declare this node a pre-synthesized fixed-function rank.

pub fn from_env() -> Result<Self, String>

Read the same variables the CLI node driver uses (RANK, WORLD, PEERS / DISCOVER, TOPOLOGY, HEAP_MB, DEVICE). Provided for parity; prefer the builder on platforms without a shell environment.

pub fn connect(&self) -> Result<Arc<ProcessGroup>>

Build the transport and join the mesh.

pub fn caps(&self) -> NodeCaps

This node’s advertised capabilities.

Trait Implementations

impl Clone for NodeConfig

fn clone(&self) -> NodeConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NodeConfig

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

Formats the value using the given formatter.