NRP — Node Reach Protocol

AAP for the physical world.

pip install nrprotocol

NRP implements the AAP spec for physical nodes — robots, IoT sensors, industrial machines, drones, vehicles. 4 methods. Any device.

from nrp import NRPDriver, NRPNode, NRPManifest, NRPAddress, ShieldRule, ShieldOperator

class RobotArm(NRPDriver):
    def manifest(self):
        return NRPManifest(
            address=NRPAddress.parse("nrp://factory-3/robot/arm-7"),
            description="6-DOF robot arm",
            version="1.0.0",
        )
    def observe(self): return {"x_mm": 142, "force_n": 0}
    def act(self, action, params): return {"ok": True}
    def shield_rules(self):
        return [
            ShieldRule("force_n", ShieldOperator.MAX, max_value=50.0),  # structural limit
            ShieldRule("z_mm",    ShieldOperator.MIN, min_value=0.0),   # no floor collision
        ]

node = NRPNode(RobotArm())
node.execute("grip", {"force_n": 80})  # ShieldViolation: 80N > 50N
node.execute("grip", {"force_n": 25})  # OK — recorded in audit chain

Physical World Rule

Level 4 (Autonomous) is forbidden by AAP spec for physical nodes. NRP enforces this at the driver level. Not configurable. Not overridable. Returns AAP-003.

Address format

nrp://factory-3/robot/arm-7
nrp://farm/sensor/soil-north
nrp://fleet/vehicle/truck-42
nrp://hospital/device/infusion-3

AAP Spec · Halyn · nrprotocol.dev

License: MIT