First node

This page is the shortest path to a running node. For the full tour of plugins, the sans-IO core, and the driver/handle split, read The session facade.

A node owns one local role on a bus. The exact plugins you add depend on the role, but the pattern is always the same:

1. choose a NAME
2. choose a preferred source address
3. plug only the subsystems you need
4. spawn over a transport — this gives you (Controls, Driver)
5. start, then claim an address before normal traffic
6. drive driver.poll()? and handle events

Conceptual Rust shape:

#![allow(unused)]
fn main() {
{{#include ../../../examples/session_minimal.rs:build}}
}

The snippet above is copied from examples/session_minimal.rs. Use runnable examples for the exact current API calls.

make run EXAMPLE=session_minimal

What to check

• ctrl.is_claimed() becomes true once the handshake completes, and ctrl.address() reports the address the node owns.
• The node does not send application traffic before address claim.
• Optional fine control such as ctrl.with_mut::<Diagnostics, _>(...) is only available when you plugged that subsystem (it returns None otherwise).
• Events are drained regularly enough for your application queue policy.

Common mistakes