Robonomics Network

Robonomics implementation in Rust based on the Polkadot SDK. For more specific guides, like how to be a node, see the Robonomics Wiki.

Robonomics platform includes a set of open-source packages and infrastructure for Robotics, Smart Cities and Industry 4.0 developers.

Quick Start - Choose Your Destiny...

Repository Structure

This repository is organized as a Cargo workspace with the following structure:

Node Binary

• bin/robonomics/ - Main binary implementation
  • The Robonomics Network Omni Node with CLI interface
  • Built using polkadot-omni-node-lib for maximum compatibility

Runtime

• runtime/robonomics/ - Robonomics parachain runtime

  • WASM runtime implementation for the Robonomics Network
  • Includes configurations for Kusama and Polkadot relay chains
  • Integrates all custom pallets and standard Substrate pallets

• runtime/robonomics/subxt-api - Robonomics runtime Subxt metadata & API

  • Provides a type-safe, compile-time verified API based on subxt library interface.

Custom Pallets

• frame/ - Custom FRAME pallets for IoT and robotics
  • datalog/ - Immutable on-chain data logging with time-series storage
  • digital-twin/ - Digital twin state management and topic-based data organization
  • launch/ - Robot/device launch commands with parameter support
  • liability/ - Smart contract-like agreements for robotics tasks
  • rws/ - Robonomics Web Services (RWS) subscription management
  • cps/ - Cyber-physical Systems pallet for IoT integration
  • parachain-info/ - Original cumulus pallet extended with relay network info
  • collator-rewards/ - Generic per-block collator (block author) reward helper

Chain Specifications

• chains/ - Chain specification files for different networks

Tools

• tools/libcps/ - Robonomics CPS (Cyber-Physical Systems) library and CLI

  • Comprehensive Rust library for managing hierarchical CPS nodes on-chain
  • Beautiful CLI interface with colored output and tree visualization
  • Multi-algorithm AEAD encryption support (XChaCha20-Poly1305, AES-256-GCM, ChaCha20-Poly1305)
  • MQTT bridge for IoT device integration
  • See libcps/README.md for detailed documentation

• tools/robonet/ - Local network spawner and integration test framework

  • CLI tool for spawning multi-node test networks using ZombieNet SDK
  • Built-in integration tests for XCM, CPS, and network functionality
  • Multiple network topologies (simple parachain, with AssetHub for XCM testing)
  • Developer-friendly interface with progress indicators and detailed logging
  • See robonet/README.md for detailed documentation

Development Infrastructure

• nix/ - Nix flake modules and build configurations
• scripts/ - Build, deployment, and testing scripts
  • runtime-benchmarks.sh - Automated runtime benchmarking for all pallets
  • try-runtime.sh - Automated runtime upgrade checks
  • build-deb.sh - Debian package builder
  • build-runtime.sh - Deterministic runtime WASM builder
  • docker/ - Docker configuration and healthcheck scripts
  • weights/ - Weight template for runtime benchmarks

Contributing

We welcome contributions! Please see our Contributing Guidelines.

Support

• Robonomics Wiki: https://wiki.robonomics.network
• GitHub Issues: https://github.com/airalab/robonomics/issues
• Website: https://robonomics.network

License

Robonomics is licensed under the Apache License 2.0. See LICENSE for details.