Skip to content

Robonomics node implementation for Polkadot ecosystem; Kusama parachain slot #2048 since January 2022

License

Notifications You must be signed in to change notification settings

airalab/robonomics

Repository files navigation

Robonomics

Web3 Foundation Grants — Wave Two Recipient

License CI Status Release Downloads Matrix

Implementation of a https://robonomics.network node in Rust, based on the Substrate framework.

This repo contains runtimes for the Earth Parachain, Mars Parachain, and Robonomics Relay chain networks. The README provides information about installing the robonomics binary and developing on the codebase. 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.

1. Try it out

2. The Robonomics Crates

Structure of Robonomics followed:

  • Robonomics Node - substrate-based blockchain node with Robonomics Network extensions.

  • Robonomics CLI - console line primitives that make framework functions runnable.

  • Robonomics Protocol - network library that helps to build P2P communication in Industry 4.0 and Smart City cases.

  • Robonomics Frame - a collection of pallets suitable for Smart City and Industry 4.0 cases.

Full docs available at https://crates.robonomics.network.

3. Building from source

Ensure you have Rust and the support software installed:

curl https://sh.rustup.rs -sSf | sh

You will also need to install the following packages:

  1. Linux:

    sudo apt install cmake git clang libclang-dev protobuf-compiler
  2. Mac:

    brew install cmake pkg-config git llvm
  3. Windows (PowerShell):

    # Install LLVM
    # Download and install the Pre Build Windows binaries
    # of LLVM  from http://releases.llvm.org/download.html

Install robonomics node from git source.

cargo install --force --git https://github.com/airalab/robonomics --tag v3.0.0 robonomics

And then launch full node of robonomics testnet parachain.

robonomics

Or run your local development network.

robonomics --dev

3.1. Building with Nix

  1. Install Nix package manager:

    curl https://nixos.org/nix/install | sh
  2. Run in Nix shell:

    git clone --recursive https://github.com/airalab/robonomics && cd robonomics
    nix-shell --run "cargo run --release"

4. Network maintaining

Currently Robonomics is maintained by developers but anyone can support the project. Every additional full node of blockchain helps it to be more sustainable and fault tolerant. Robonomics node binaries is available in release assets or it could be build from source.

4.1. Gatekeepers updates

Launch command:

robonomics --collator --lighthouse-account [YOUR_ACCOUNT_ADDRESS]

5. Robotics integration

Of course, Robonomics should integrate open-source robotics, our main target is ROS-enabled robots. The node implements a few features to make robotics integration as easy as it possible.