app = FastAPI(title=”OTA Robotics API”)

class RegisterRobotRequest(BaseModel):
device_id: str
wallet_address: str
capabilities: List[str]
public_key: str

class StatusReport(BaseModel):
device_id: str
status: dict
timestamp: str

class TaskLogRequest(BaseModel):
device_id: str
task_name: str
cid: str
tags: List[str]

class DeviceTrustRequest(BaseModel):
device_id: str
system_check: dict

class BroadcastCIDRequest(BaseModel):
device_id: str
cid: str
type: str
note: Optional[str]

@app.post(“/robotics/register”)
def register_robot(req: RegisterRobotRequest):
return {
“status”: “registered”,
“cid_log”: “QmExampleCID123…”,
“robot_alias”: f”{req.device_id}-alias”
}

@app.post(“/robotics/status”)
def report_status(req: StatusReport):
return {
“status”: “received”,
“cid”: “QmStatusCIDExample…”
}

@app.post(“/robotics/task/log”)
def log_task(req: TaskLogRequest):
return {
“status”: “logged”,
“cid”: “QmCIDLinkToLedger…”
}

@app.get(“/robotics/task/pull/{device_id}”)
def pull_task(device_id: str):
return {
“task”: {
“command”: “navigate”,
“params”: {
“waypoints”: [
{“lat”: 36.77, “lon”: -119.41},
{“lat”: 36.78, “lon”: -119.40}
]
},
“expires”: “2025-05-22T18:00:00Z”
},
“cid”: “QmCommandCID…”
}

@app.post(“/robotics/verify”)
def verify_device(req: DeviceTrustRequest):
return {
“trust_status”: “verified”,
“cid”: “QmTrustLogExample…”
}

@app.post(“/robotics/cid/broadcast”)
def broadcast_cid(req: BroadcastCIDRequest):
return {
“broadcast_status”: “sent”,
“verified_by”: “relay1”,
“ledger_cid”: “QmLedgerUpdateExample…”
}