Skip to content

Robot URI (RURI)

Every OpenCastor robot has a canonical RURI — a structured identifier modeled after URLs for physical machines.

Format

rcan://<registry>/<manufacturer>/<model>/<version>/<serial>

Example

rcan://opencastor.com/raspberrypi/pi5-hailo/1.0/RRN-000000000001
Component Value Description
registry opencastor.com Fleet registry domain
manufacturer raspberrypi Hardware manufacturer
model pi5-hailo Model + hardware tier
version 1.0 Hardware revision
serial RRN-000000000001 Unique Robot Resource Name

RRN

The Robot Resource Name is the stable unique identifier assigned at registration. It's used in:

  • All Firestore documents
  • RCAN message headers
  • Telemetry streams
  • Castor Credits accounting
  • Research contributor lineage

Format: RRN-{12-digit zero-padded integer}

RRN-000000000001   ← first registered robot
RRN-000000000005   ← fifth registered robot

Registration

castor register \
  --name "Bob" \
  --hardware pi5-hailo \
  --model "Raspberry Pi 5 + Hailo-8L"

The RRN is assigned by the registry and stored in the robot's config. It never changes.