Skip to content

Latest commit

 

History

History
116 lines (81 loc) · 4.34 KB

README.adoc

File metadata and controls

116 lines (81 loc) · 4.34 KB

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.