NodeId

Type-safe wrapper for Meshtastic node identifiers (uint32).

The wire format is uint32; the full 32-bit range is permitted. The backing field is a Kotlin Int interpreted as an unsigned 32-bit value, so any bit pattern is valid — no additional validation is performed.

Reserved values:

• 0x00000000 → LOCAL (the local node, "this radio")

• 0xFFFFFFFF → BROADCAST (all nodes on the mesh)

Validation note: value-class init blocks only run from Kotlin call sites; bytecode constructed via reflection or generated code can bypass them. Because NodeId permits the full uint32 range there is no init check, so this is moot in practice.

Java interop: properties returning NodeId expose non-mangled boxed accessors (e.g. node.getNodeId() rather than getNodeId-PPSJZE4()) thanks to -Xjvm-expose-boxed (see KmpLibraryConventionPlugin). From Java: nodeId.getRaw() to read the underlying int.