KryonBeam P2P Mesh Protocol
Decentralized microcontroller-to-microcontroller messaging, direct handle beams, and global public channels.
KryonBeam P2P Mesh Protocol
KryonBeam is a decentralized messaging and discovery protocol designed for microcontrollers running KryonOS. It enables devices to communicate across local subnets and cloud relays using unique hardware handles without requiring friendship approval.
1. Hardware Handles
Every paired KryonOS device receives a unique, collision-free handle minted during pairing (e.g. @kryon-aurora-742).
// Check own device handle
var myHandle = Beam.getHandle();
print("My KryonBeam Handle:", myHandle);
2. Direct Messaging (No Friend Request Required)
Any KryonOS node can send direct IoT messages, telemetry payloads, or commands to any other device handle:
// Send direct packet to another microcontroller
Beam.send({
recipient: "@kryon-forge-119",
type: "TEXT_MESSAGE",
payload: {
message: "Temperature alert: 28.5C",
timestamp: Date.now()
}
});
// Register incoming message event handler
Beam.on("message", function(packet) {
print("Received from " + packet.sender + ": " + packet.payload.message);
Display.drawText("Msg: " + packet.payload.message, 10, 100, 0x00FFC2, 1);
});
3. Global Public Channel (#public)
Broadcast and listen to the global #public community channel in real-time:
// Broadcast message to #public
Beam.broadcastPublic({
channel: "public",
message: "Weather Node Online: 24.1C, 58% RH"
});
// Listen to public channel events
Beam.on("public", function(msg) {
print("[#public] " + msg.senderHandle + ": " + msg.content);
});
4. Local P2P Discovery
Devices broadcast UDP beacon discovery packets on the local subnet. When a peer is discovered, KryonOS adds it to the active mesh table:
// Get list of currently active nearby nodes
var peers = Beam.getDiscoveredPeers();
peers.forEach(function(peer) {
print("Found Node: " + peer.handle + " at " + peer.ip);
});