Skip to content

Latest commit

 

History

History
110 lines (54 loc) · 4.42 KB

README.md

File metadata and controls

110 lines (54 loc) · 4.42 KB
Raw

AnyLedger Hub

Overview

AnyLedger Hub is the bridge connecting the IoT device featuring the embedded wallet and a given blockchain. It consist of a series of moving pieces like the LWM2M server to remotely manage the devices (device lifecycle management, over-the-air updates, etc.), the blockchain nodes and decentralised storage solutions. It also includes a set of standard smart contracts implementing features like digital twin, decentralised access control, multisignature contracts, etc.

What is inside the current repo:

  1. It is an umbrella repo for the following submodules:

  • anyledger-hub-web - AnyLedger Hub static HTML/JavaScript web page served by the IPFS

  • decentralized-storage - IPFS node responsible for hosting data in decentralised fashion. Can be used for instance to store IoT data, HTML/JavaScript web pages, object graphs and more.

  • ethereum-private-network - Private Ethereum full node. Currently not used.

  • leshan - LWM2M (Lightweight Machine 2 Machine) Server which is storing its object graph on IPFS and Ethereum

  • smart-contracts - Ethereum and HyperLedger Smart Contracts which are used for Digital Twin Root of Trust, Access Control, etc.

  1. This repo also contains Docker Composer file which spins the whole platform on a single machine. It is meant to be used for development and demo purposes.

Example Features

-Decentralised Access Control

The device owner can be interested in setting an access control policy for the remote access of the device. This can be achieved in a decentralized fashion, that is relying on private keys authentication and without the need of a central server, by storing the access control policy on a smart contract.

-Decentralised Digital Twin

A way to achieve this with AnyLedger Hub is the following: the devices registered on Leshan are stored on IPFS together with their metadata. Moreover, thanks to another smart contract, every device id is associated to the respective IPFS hash. Every additional update of the device status can be included on IPFS by storing the previous hash together with the new metadata, therefore creating an immutable history of the device lifecycle.

Prerequisites

  1. Install latest Java Development Kit
  1. Install Maven

  • On Linux: sudo apt install maven

  • On MacOS: brew install maven

  • On Windows:

  1. Install Docker and Docker Compose

Installation

  1. Clone this repo: git clone https://github.com/AnyLedger/anyledger-hub --recursive. Notice that the repo has submodules

  2. Go to /anyledger-hub/leshan/ and build the project with mvn package

  3. Build Docker images by going to the folder containing docker-compose.yml and type docker-compose build

  4. Run Docker Compose in the root of the repo: docker-compose up

The web app is hosted on IPFS. To visualize it, go to:

http://0.0.0.0:8080/ipfs/QmSoQUcGK4zQ78zrqP5DskDNnJ9x3M7cwS5rz7v4WhPRQZ/

but replacing this dummy hash with hash of the index.html file, which can be found after running docker-compose up.

Tips

To update all the submodules: git submodule update --remote --recursive

Troubleshooting

-In step 2, the leshan build can sometimes fail. Don't panic and try again :)

-In step 3, you should input eval $(docker-machine env default) after

ERROR: Couldn't connect to Docker daemon - you might need to run docker-machine start default.

if the machine is already running.

  • In step 3 of Installation, you may be encounter an error due to having a different installed version for openjdk. For instance:

`apk add --no-cache openjdk8=8.151.12-r0 ...

ERROR: unsatisfiable constraints: ...

ERROR: Service 'lwm2m-client_1' failed to build:...`

To solve it, replace the old version in the project with the new one.

-latest version of trufflesuite/ganache-cli may give errors in truffle like:

Error: Invalid JSON RPC response: ""

Use v6.1.0 instead.